> ## 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. > ## Agent Instructions > To integrate AGG, start with Quickstart: REST (https://docs.agg.market/quickstart/rest), then Order lifecycle & statuses (https://docs.agg.market/concepts/order-lifecycle). > Track every trade until it reaches a terminal status. Before retrying a failed or timed-out call, read Errors, retries & idempotency (https://docs.agg.market/concepts/errors). > The API reference is generated from https://docs.agg.market/openapi/openapi.json. # Get bounded outcome snapshots > Returns up to 100 outcome snapshots in request order. Missing or inaccessible outcomes are null. Engine failures return 503, not empty success. ## OpenAPI ````yaml /openapi/openapi.json get /orderbooks/outcomes 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 security: [] tags: - name: Authentication description: Sign users in and manage their session tokens. - name: Markets description: Find events, markets and outcomes to trade. - name: Market Data description: Live orderbooks, prices, charts and scores for those markets. - name: Trading description: Quote, place, sign, track and cancel orders. - name: Portfolio description: A user's orders, positions, balances and activity. - name: Funding description: Deposit addresses, withdrawals, balance refills and fiat on-ramp. - name: Users description: The signed-in user's profile, linked accounts, KYC and venue keys. - name: Hosted Venue Accounts description: Provision, fund and withdraw from venue accounts hosted for the user. - name: Webhooks description: Configure and operate webhook delivery to your server. - name: Partner Admin description: Server-side reads across your app's users, orders and analytics. - name: Paper Trading description: Simulated accounts and orders for testing without real funds. - name: News description: News feeds linked to markets. - name: Correlated Markets description: Markets related to a given market and the effect of its resolution. paths: /orderbooks/outcomes: get: tags: - Market Data summary: Get bounded outcome snapshots description: >- Returns up to 100 outcome snapshots in request order. Missing or inaccessible outcomes are null. Engine failures return 503, not empty success. operationId: getOutcomeOrderbooks parameters: - name: venueMarketOutcomeIds in: query required: true schema: anyOf: - minItems: 1 maxItems: 100 type: array items: minLength: 1 type: string - minLength: 1 maxLength: 8000 type: string - name: depth in: query required: false schema: minimum: 1 maximum: 500 type: integer responses: '200': description: '200' content: application/json: schema: type: object required: - data properties: data: maxItems: 100 type: array items: type: object required: - venueMarketOutcomeId - venueMarketId - venue - orderbook - midpoint - spread - seq - checksum - timestamp - tick - markSource properties: snapshotChecksum: minimum: 0 maximum: 4294967295 type: integer venueMarketOutcomeId: type: string venueMarketId: type: string venue: type: string orderbook: type: object required: - bids - asks properties: bids: type: array items: type: object required: - price - size properties: price: type: number size: type: number asks: type: array items: type: object required: - price - size properties: price: type: number size: type: number midpoint: type: number nullable: true spread: type: number nullable: true seq: type: number checksum: type: number timestamp: type: number tick: type: number nullable: true markSource: $ref: '#/components/schemas/MarkSource' nullable: true '400': description: '400' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/ErrorMessage' '429': description: '429' content: application/json: schema: $ref: '#/components/schemas/RateLimitError' headers: Retry-After: schema: pattern: ^[1-9][0-9]*$ description: Seconds to wait before another request; do not retry earlier. type: string Cache-Control: schema: type: string enum: - private, no-store '503': description: '503' content: application/json: schema: anyOf: - type: object required: - code - message - retryable properties: code: type: string enum: - orderbook_service_unavailable message: type: string retryable: type: boolean - type: object required: - statusCode - code - message - retryAfter properties: statusCode: type: number enum: - 503 code: type: string enum: - rate_limit_unavailable message: type: string retryAfter: minimum: 1 description: Retry delay in seconds. type: integer headers: Retry-After: schema: pattern: ^[1-9][0-9]*$ description: Seconds to wait before another request; do not retry earlier. type: string Cache-Control: schema: type: string enum: - private, no-store security: - appId: [] components: schemas: MarkSource: description: >- How `midpoint` was derived. `local`: (best bid + best ask) / 2 on this book. `local_merged`: a missing side was filled from the complementary outcome's book. `local_one_sided`: only one side exists, so the mark is that side's best price, not a true midpoint. `sibling`: 1 minus the complementary outcome's mark. `local_boundary`: the book sits at 0 or 1 (e.g. a settled market). `local_stub`: the only book is a placeholder quote at the price bounds; indicative only, not tradeable quality. `none`: no mark available. type: string enum: - local - local_merged - local_one_sided - sibling - local_boundary - local_stub - none ErrorMessage: type: object required: - message properties: message: type: string RateLimitError: type: object required: - message properties: message: type: string statusCode: type: number enum: - 429 code: type: string enum: - rate_limited retryAfter: minimum: 1 description: Retry delay in seconds. type: integer securitySchemes: appId: type: apiKey in: header name: x-app-id description: Your application ID. Required for all app-tier and user-tier routes. ````