> ## 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.

# Execute quote

> Accepts a previously quoted smart-route quote and returns pending order IDs for the submitted fill execution.



## OpenAPI

````yaml /openapi/openapi.json post /execution/fill
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:
  /execution/fill:
    post:
      tags:
        - Execution
      summary: Execute quote
      description: >-
        Accepts a previously quoted smart-route quote and returns pending order
        IDs for the submitted fill execution.
      operationId: fillManaged
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - quoteId
              properties:
                quoteId:
                  type: string
                mode:
                  type: string
                  enum:
                    - live
                    - paper
                fallbackToLatest:
                  type: object
                  required:
                    - outcomeId
                    - side
                  properties:
                    outcomeId:
                      type: string
                    side:
                      type: string
                      enum:
                        - buy
                        - sell
                    maxSpend:
                      type: number
                    sellShares:
                      type: number
                    allowedVenues:
                      type: array
                      items:
                        type: string
                        enum:
                          - kalshi
                          - polymarket
                          - limitless
                          - opinion
                          - predict
                          - probable
                          - myriad
                          - hyperliquid
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                required:
                  - quoteId
                  - orderIds
                  - status
                properties:
                  quoteId:
                    type: string
                  orderIds:
                    type: array
                    items:
                      type: string
                  status:
                    type: string
                    enum:
                      - pending
                  redeemId:
                    type: string
                  message:
                    type: string
        '400':
          description: '400'
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
                  code:
                    type: string
                    enum:
                      - quote_not_found
                      - quote_expired
                      - quote_already_executed
                      - quote_cancelled
                      - quote_user_mismatch
                      - quote_app_blocked
                      - quote_unfillable
                      - quote_stale_status
                      - quote_stale_price
                      - quote_insufficient_balance
                      - quote_market_inactive
        '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
        '404':
          description: '404'
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
      security:
        - appId: []
          bearerAuth: []
components:
  securitySchemes:
    appId:
      type: apiKey
      in: header
      name: x-app-id
      description: Your application ID. Required for all app-tier and user-tier routes.
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT access token returned by POST /auth/verify. Required for user-tier
        routes.

````