> ## Documentation Index > Fetch the complete documentation index at: https://docs.parlayx.com/llms.txt > Use this file to discover all available pages before exploring further. # List Orders > Returns a paginated list of Polymarket orders. Listed orders always report `error` as null; fetch a single order to read why it failed. ## OpenAPI ````yaml /openapi/v1.json get /v1/polymarket/orders openapi: 3.0.0 info: title: ParlayX API version: 1.0.0 description: Aggregated prediction-market trading API servers: - url: https://api.parlayx.com security: [] tags: - name: Authentication description: Confirm your signing and read the server clock. - name: Discovery description: Browse sports, competitions, events, and markets. - name: Polymarket description: Submit and manage orders on Polymarket outcomes. - name: Kalshi description: Submit and manage orders on Kalshi markets. paths: /v1/polymarket/orders: get: tags: - Polymarket summary: List Orders description: >- Returns a paginated list of Polymarket orders. Listed orders always report `error` as null; fetch a single order to read why it failed. operationId: listPolymarketOrders parameters: - name: PX-Key-Id in: header required: true schema: type: string description: The key id issued for your signing keypair. - name: PX-Timestamp in: header required: true schema: type: string description: >- Unix seconds at signing, valid within 30 seconds of the server clock. - name: PX-Signature in: header required: true schema: type: string description: Ed25519 signature of the request - name: PX-Content-Sha256 in: header required: true schema: type: string description: >- Hex SHA-256 of the request body, or the SHA-256 of the empty string when there is no body. - schema: type: string minLength: 1 description: Filter to orders on a single Polymarket outcome token. required: false name: tokenId in: query - schema: type: string enum: - PENDING - SUBMITTED - OPEN - FILLED - CANCELLED - REJECTED description: Filter to orders in a single lifecycle status. required: false name: status in: query - schema: type: integer minimum: 1 maximum: 100 default: 20 description: >- Max results to return (1-100). Applies to the first page only; ignored when a pageToken is supplied (the token's encoded page size wins). example: 20 required: false name: pageSize in: query - schema: type: string minLength: 1 description: >- Opaque cursor from a previous response's `nextPageToken`. Encodes the page size so it does not need to be re-sent. Omit to fetch the first page. required: false name: pageToken in: query responses: '200': description: Orders found content: application/json: schema: $ref: '#/components/schemas/ListPolymarketOrdersResponse' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal error content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: ListPolymarketOrdersResponse: type: object properties: orders: type: array items: $ref: '#/components/schemas/PolymarketOrderView' description: Page of orders. nextPageToken: type: string nullable: true description: >- Opaque cursor for the next page, or null when there are no more results. required: - orders - nextPageToken ApiError: type: object properties: error: type: object properties: code: $ref: '#/components/schemas/ApiErrorCode' message: type: string description: Plain-text explanation of the error. orderId: type: string format: uuid description: >- The affected order, present only on ORDER_RECONCILIATION_REQUIRED; read it back to determine whether it reached the venue. required: - code - message required: - error PolymarketOrderView: type: object properties: orderId: type: string format: uuid description: Issued order id. example: 3f8b2c9a-2d18-4f7e-9c2a-1b6e1f0c8a4d tokenId: type: string minLength: 1 description: >- Polymarket outcome-token id that identifies both the market and the outcome. example: >- 71321045679252212594626385532706912750332728571942532289631379312455583992563 side: $ref: '#/components/schemas/PolymarketSide' type: $ref: '#/components/schemas/TradingOrderType' size: type: string nullable: true description: Limit order size in outcome shares, or null for a market order. price: type: string nullable: true description: Limit price in dollars from 0 to 1, or null for a market order. amount: type: string nullable: true description: >- Market order size, in dollars for a buy and outcome shares for a sell, or null for a limit order. postOnly: type: boolean nullable: true description: >- Whether a limit order rests as maker-only, or null for a market order. status: $ref: '#/components/schemas/TradingOrderStatus' venueOrderId: type: string nullable: true description: Polymarket order id, or null until the venue acknowledges the order. createdAt: type: string description: Time the order was created, in ISO-8601. updatedAt: type: string description: Time the order was last updated, in ISO-8601. filledShares: type: string nullable: true description: Outcome shares filled so far, or null before any fill. averagePrice: type: string nullable: true description: >- Average price executed, in dollars from 0 to 1, excluding fees, or null before any fill. feesUsd: type: string nullable: true description: >- Total fees charged in dollars, or null before any fill. Charged on top of the executed notional, so it is additive to cost on a buy and deducted from proceeds on a sell. closedAt: type: string nullable: true description: Time the order reached a terminal state, or null while still open. error: type: object nullable: true properties: code: $ref: '#/components/schemas/TradingOrderErrorCode' message: type: string nullable: true description: >- The venue's own wording for the failure, or null when there is none to relay. example: >- polymarket rejected the order: invalid amount for a marketable BUY order ($0.55), min size: $1 required: - code - message description: Why the order failed, or null if it did not. required: - orderId - tokenId - side - type - size - price - amount - postOnly - status - venueOrderId - createdAt - updatedAt - filledShares - averagePrice - feesUsd - closedAt - error ApiErrorCode: type: string enum: - INVALID_REQUEST - NOT_FOUND - INSUFFICIENT_BALANCE - IDEMPOTENCY_CONFLICT - ORDER_NOT_CANCELLABLE - ORDER_RECONCILIATION_REQUIRED - INTERNAL_ERROR description: Stable identifier for the error category. PolymarketSide: type: string enum: - BUY - SELL description: Order direction. example: BUY TradingOrderType: type: string enum: - LIMIT - MARKET description: Order type. example: LIMIT TradingOrderStatus: type: string enum: - PENDING - SUBMITTED - OPEN - FILLED - CANCELLED - REJECTED description: |- Order lifecycle status. | Status | Meaning | | --- | --- | | `PENDING` | Accepted, not yet sent to the venue. | | `SUBMITTED` | Sent, awaiting venue acknowledgement. | | `OPEN` | Resting on the venue. | | `FILLED` | Fully filled. | | `CANCELLED` / `REJECTED` | Terminal. | example: OPEN TradingOrderErrorCode: type: string enum: - VENUE_REJECTED - INVALID_ORDER - NOT_FEASIBLE - CREDENTIALS_INVALID - UNKNOWN description: Stable identifier for the error category. ````