> ## Documentation Index > Fetch the complete documentation index at: https://docs.adipredictstreet.com/llms.txt > Use this file to discover all available pages before exploring further. # List open orders > All orders for the authenticated wallet currently in a non-terminal status (`PENDING` / `OPEN` / `PARTIAL`). Wrapped envelope: `{walletAddress, orders: [...], nextCursor}`. ALWAYS paginated: omit `limit` for a default 500-row first page (NOT the whole open-set — a no-`limit` call will not return thousands of orders), or pass `limit` (1..500) for a smaller page. When more orders remain you get a non-null `nextCursor`; pass it back as `cursor` for the next (older) window. `nextCursor` is null only on the last page, so nothing is silently truncated. Filters (`marketId`/`side`/`outcome`/`type`) mirror `/api/orders/history`. ## OpenAPI ````yaml /api-reference/openapi.json get /api/orders/open openapi: 3.1.0 info: title: PredictStreet core-api description: >- Client-facing HTTP gateway for the PredictStreet prediction-market platform. **Partner kinds.** Every authenticated endpoint resolves a request's *effective wallet* from the partner row. `single_wallet` partners bind to one `associatedWallet` set at creation. `multi_wallet` partners declare the actor on every request via an `X-User-Wallet: 0x<40-hex>` header. See the [Partner kinds](/auth/api-keys#partner-kinds) doc for the full contract. version: '2026-04-25' contact: name: PredictStreet partners email: partners@predictstreet.com servers: - url: https://core-api.adipredictstreet.com description: Production — replace with the API host issued at partner onboarding. security: [] tags: - name: Events description: >- Polymarket-style event grouping with football metadata (group, stage, teams, tags). - name: Tags description: Curated tag taxonomy used to filter events. - name: Markets description: 'Public market data: list, detail, orderbook, trades, OHLC.' - name: Orders description: >- Signed-order place / cancel / read. Requires `X-Api-Key` with `orders:read` / `orders:write` scope; every write additionally requires an EIP-712 signature over the order. - name: Portfolio description: >- Balances, positions, trades, fees, vault info for the key's `associatedWallet`. Requires `X-Api-Key` with `portfolio:read` scope. - name: Matches description: >- admin.matches aggregate — groups several events into one fixture/card (1X2 + first-scorer + over-under under one matchup). - name: Vault description: >- Backend co-signatures for ERC-1155 split / merge, and recovery for off-chain locks when the corresponding chain tx never confirmed. Requires `X-Api-Key` with `vault:write` scope plus an EIP-712 signature over the operation. - name: Leaderboard description: Public ranked leaderboard across PnL / volume buckets. - name: Search description: Global search across users, events, and matches. paths: /api/orders/open: get: tags: - Orders summary: List open orders description: >- All orders for the authenticated wallet currently in a non-terminal status (`PENDING` / `OPEN` / `PARTIAL`). Wrapped envelope: `{walletAddress, orders: [...], nextCursor}`. ALWAYS paginated: omit `limit` for a default 500-row first page (NOT the whole open-set — a no-`limit` call will not return thousands of orders), or pass `limit` (1..500) for a smaller page. When more orders remain you get a non-null `nextCursor`; pass it back as `cursor` for the next (older) window. `nextCursor` is null only on the last page, so nothing is silently truncated. Filters (`marketId`/`side`/`outcome`/`type`) mirror `/api/orders/history`. operationId: OrdersController_open parameters: - $ref: '#/components/parameters/UserWalletHeader' - name: marketId required: false in: query description: Restrict to one market symbol. schema: type: string - name: side required: false in: query description: One side only (case-insensitive). schema: type: string enum: - buy - sell - BUY - SELL - name: outcome required: false in: query description: One outcome index (>= 0). schema: type: integer - name: type required: false in: query description: One order type (case-insensitive). schema: type: string enum: - limit - market - LIMIT - MARKET - name: limit required: false in: query description: >- Page size (1..500). Omitted => a default 500-row first page (NOT the full open-set). When more remain you get a `nextCursor`; pass it back as `cursor` for the next page. schema: type: integer - name: cursor required: false in: query description: >- Opaque keyset cursor — a prior response's `nextCursor`, passed back verbatim, for the next (older) page. Legacy ISO-8601 cursors still accepted. schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/OpenOrdersRespDto' type: object properties: walletAddress: type: string orders: type: array items: $ref: '#/components/schemas/Order' nextCursor: type: string nullable: true description: >- Opaque keyset cursor for the next (older) page; null only on the last page. security: - ApiKeyAuth: - orders:read components: parameters: UserWalletHeader: name: X-User-Wallet in: header required: false description: >- **Required for `multi_wallet` partners on every authenticated request; ignored for `single_wallet`.** Declares the acting end-user wallet for this request — drives KYC checks, balances/positions/orders attribution, rate-limit buckets, and audit. Lower-cased server-side. Missing on a multi_wallet key → 401 `api_key_user_wallet_required`; malformed → 401 `api_key_user_wallet_invalid`. The on-chain `CTFExchange`/`Vault` contracts still verify EIP-712 signer ↔ vault binding, so loosening API-layer attribution is safe by construction. schema: $ref: '#/components/schemas/EthereumAddress' example: '0x1234567890abcdef1234567890abcdef12345678' schemas: OpenOrdersRespDto: type: object properties: walletAddress: type: string description: >- Authenticated wallet (lowercase 0x-hex). Echoed back so a partner paginating multiple wallets can route results without a side-channel (audit M7). orders: description: OPEN/PARTIAL orders for the wallet. type: array items: $ref: '#/components/schemas/OrderItemDto' nextCursor: type: string nullable: true description: >- Opaque keyset cursor for the next (older) page — pass back as `?cursor=`. Composite `(created_at, order_id)` keyset; legacy ISO-8601 still accepted. Null only on the last page. required: - walletAddress - orders EthereumAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ example: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb3' OrderItemDto: type: object properties: {} securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Api-Key description: >- Partner / integrator key — format `ps_live__`. Issued by PredictStreet ops on request; never self-service. Never ship to a browser. `multi_wallet` partners must additionally send `X-User-Wallet: 0x<40-hex>` on every authenticated request to declare the acting wallet. See the [API keys guide](/auth/api-keys) for scope taxonomy, partner kinds, rate limits, and rotation procedure. ````