> ## Documentation Index > Fetch the complete documentation index at: https://docs.agg.market/llms.txt > Use this file to discover all available pages before exploring further. # List orders across your app > Every order placed by any user of your app, as a changes feed: ordered by last update, oldest first. Page until `hasMore` is false, then store `nextCursor` and pass it as `cursor` on your next run to receive only orders created or changed since. `nextCursor` is returned on every response, including an empty one. An order is returned again each time it changes (for example `pending` → `filled`), so upsert by `id`. Orders changed in the last 2 minutes appear on a later run. Filter with `status`, a comma-separated list such as `filled,partial_fill`. Authenticate with an `x-app-api-key` of either scope: a `read` key can read every user's orders in your app, so treat it as a credential over your users' full trading history. ## OpenAPI ````yaml /openapi/openapi.json get /apps/{appId}/orders openapi: 3.0.2 info: title: AGG API version: 1.0.0 description: >- Prediction market aggregator REST API — authentication, users, venue events, venue markets, orderbooks, charts, and execution workflows. servers: - url: https://api.agg.market description: Production - url: https://api.staging.agg.market description: Staging security: [] paths: /apps/{appId}/orders: get: tags: - App Management summary: List orders across your app description: >- Every order placed by any user of your app, as a changes feed: ordered by last update, oldest first. Page until `hasMore` is false, then store `nextCursor` and pass it as `cursor` on your next run to receive only orders created or changed since. `nextCursor` is returned on every response, including an empty one. An order is returned again each time it changes (for example `pending` → `filled`), so upsert by `id`. Orders changed in the last 2 minutes appear on a later run. Filter with `status`, a comma-separated list such as `filled,partial_fill`. Authenticate with an `x-app-api-key` of either scope: a `read` key can read every user's orders in your app, so treat it as a credential over your users' full trading history. operationId: getAppOrders parameters: - name: appId in: path required: true schema: type: string - name: cursor in: query required: false schema: maxLength: 200 type: string - name: status in: query required: false schema: minLength: 1 maxLength: 200 type: string - name: limit in: query required: false schema: minimum: 1 maximum: 100 type: integer responses: '200': description: '200' content: application/json: schema: type: object required: - data - nextCursor - hasMore properties: data: type: array items: type: object required: - id - quoteId - externalId - clientOrderId - venue - status - side - amountRaw - limitPriceRaw - timeInForce - expiresAt - slippageBps - quotedPriceRaw - quotedCostRaw - quotedSharesRaw - quotedToWinRaw - filledAmountRaw - executionPrice - actualSharesRaw - actualToWinRaw - partialFillReason - txHash - errorMessage - dagRunId - createdAt - updatedAt - venueMarket - venueMarketOutcome - userId properties: id: type: string quoteId: type: string nullable: true externalId: type: string nullable: true clientOrderId: type: string nullable: true venue: type: string enum: - kalshi - polymarket - limitless - opinion - predict - pred - tiprun - probable - myriad - hyperliquid - novig - prophetx - betdex status: type: string side: type: string amountRaw: type: string orderType: type: string enum: - market - limit limitPriceRaw: type: string nullable: true limitSizeRaw: type: string nullable: true timeInForce: type: string enum: - GTC - GTD - FOK - FAK - IOC - ALO nullable: true postOnly: type: boolean expiresAt: format: date-time type: string nullable: true reservedCostRaw: type: string nullable: true filledSizeRaw: type: string nullable: true filledCostRaw: type: string nullable: true remainingSizeRaw: type: string nullable: true averageFillPriceRaw: type: string nullable: true venueOrderId: type: string nullable: true cancelRequestedAt: type: string nullable: true cancelledAt: type: string nullable: true slippageBps: type: number nullable: true quotedPriceRaw: type: string nullable: true quotedCostRaw: type: string nullable: true quotedSharesRaw: type: string nullable: true quotedToWinRaw: type: string nullable: true filledAmountRaw: type: string nullable: true executionPrice: type: string nullable: true actualSharesRaw: type: string nullable: true actualToWinRaw: type: string nullable: true partialFillReason: type: string nullable: true fees: type: object required: - venueFeeBasis - quoted - actual properties: venueFeeBasis: type: string nullable: true quoted: type: object required: - venueFeeRaw - appFeeRaw - appFeeBips - referralFeeRaw properties: venueFeeRaw: type: string nullable: true appFeeRaw: type: string nullable: true appFeeBips: type: integer nullable: true referralFeeRaw: type: string nullable: true actual: type: object required: - dagRunId - venueFeeRaw - appFee - bridge - referral properties: dagRunId: type: string nullable: true venueFeeRaw: type: string nullable: true appFee: type: object required: - bips - dueRaw - collectedRaw - status properties: bips: type: integer dueRaw: type: string collectedRaw: type: string status: type: string nullable: true bridge: type: object required: - relayFeeUsd - originGasCostUsd - operationCount - pricedOperationCount properties: relayFeeUsd: type: string nullable: true originGasCostUsd: type: string nullable: true operationCount: type: integer pricedOperationCount: type: integer nullable: true referral: type: object required: - referrer - payer - feeBips - dueRaw - paidRaw - status properties: referrer: type: string payer: type: string enum: - user - app feeBips: type: number dueRaw: type: string paidRaw: type: string status: type: string nullable: true txHash: type: string nullable: true errorMessage: type: string nullable: true dagRunId: type: string nullable: true createdAt: type: string updatedAt: type: string venueMarket: type: object required: - id - venueEventId - question - image properties: id: type: string venueEventId: type: string question: type: string image: type: string nullable: true nullable: true venueMarketOutcome: type: object required: - label - title properties: label: type: string title: type: string nullable: true nullable: true userId: type: string nextCursor: type: string nullable: true hasMore: type: boolean '400': description: '400' content: application/json: schema: type: object required: - message properties: message: type: string '401': description: '401' content: application/json: schema: type: object required: - message properties: message: type: string '403': description: '403' content: application/json: schema: type: object required: - message properties: message: type: string security: - appApiKey: [] components: securitySchemes: appApiKey: type: apiKey in: header name: x-app-api-key description: App-scoped API key for programmatic app management. ````