> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt

# Get multiple markets with rewards

> Returns multiple markets with rewards and supports filtering and sorting.

<!-- aisa-pricing:start -->
Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Request contract

* **Method and path:** GET /apis/v1/polymarket/rewards/markets/multi
* **Availability:** enabled
* **Request URL template:** [https://api.aisa.one/apis/v1/polymarket/rewards/markets/multi](https://api.aisa.one/apis/v1/polymarket/rewards/markets/multi)
* **event\_id:** query; optional
* **event\_title:** query; optional
* **max\_price:** query; optional
* **max\_spread:** query; optional
* **max\_volume\_24hr:** query; optional
* **min\_price:** query; optional
* **min\_spread:** query; optional
* **min\_volume\_24hr:** query; optional
* **next\_cursor:** query; optional
* **order\_by:** query; optional
* **page\_size:** query; optional
* **position:** query; optional
* **q:** query; optional
* **tag\_slug:** query; optional
* **Runtime facts:** 3ef99d33457af3e3c3b16299db54930852c884758cba034bdda67a08da5ab7fb

[Complete OpenAPI definition](https://aisa.one/docs/openapi/polymarket-clob.json)

Effective request and pricing declaration (including authentication and referenced schemas):

```json theme={null}
{
  "operationId": "any_polymarket_clob_apis_v1_polymarket_rewards_ma_8c7184",
  "method": "GET",
  "path": "/apis/v1/polymarket/rewards/markets/multi",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Filter by event ID. Can be repeated for multiple events (e.g., ?event_id=100&event_id=200)",
      "in": "query",
      "name": "event_id",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Search event titles using case-insensitive pattern matching",
      "in": "query",
      "name": "event_title",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Maximum first token price filter",
      "in": "query",
      "name": "max_price",
      "required": false,
      "schema": {
        "format": "double",
        "type": "number"
      }
    },
    {
      "description": "Maximum spread filter",
      "in": "query",
      "name": "max_spread",
      "required": false,
      "schema": {
        "format": "double",
        "type": "number"
      }
    },
    {
      "description": "Maximum 24-hour volume filter",
      "in": "query",
      "name": "max_volume_24hr",
      "required": false,
      "schema": {
        "format": "double",
        "type": "number"
      }
    },
    {
      "description": "Minimum first token price filter",
      "in": "query",
      "name": "min_price",
      "required": false,
      "schema": {
        "format": "double",
        "type": "number"
      }
    },
    {
      "description": "Minimum spread filter",
      "in": "query",
      "name": "min_spread",
      "required": false,
      "schema": {
        "format": "double",
        "type": "number"
      }
    },
    {
      "description": "Minimum 24-hour volume filter",
      "in": "query",
      "name": "min_volume_24hr",
      "required": false,
      "schema": {
        "format": "double",
        "type": "number"
      }
    },
    {
      "description": "Pagination cursor from previous response",
      "in": "query",
      "name": "next_cursor",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Field to sort results by",
      "in": "query",
      "name": "order_by",
      "required": false,
      "schema": {
        "enum": [
          "market_id",
          "created_at",
          "volume_24hr",
          "spread",
          "competitiveness",
          "max_spread",
          "min_size",
          "question",
          "one_day_price_change",
          "rate_per_day",
          "price",
          "end_date",
          "start_date",
          "reward_end_date"
        ],
        "type": "string"
      }
    },
    {
      "description": "Number of items per page (max 500, values above are capped)",
      "in": "query",
      "name": "page_size",
      "required": false,
      "schema": {
        "default": 100,
        "maximum": 500,
        "type": "integer"
      }
    },
    {
      "description": "Sort direction",
      "in": "query",
      "name": "position",
      "required": false,
      "schema": {
        "enum": [
          "ASC",
          "DESC"
        ],
        "type": "string"
      }
    },
    {
      "description": "Text search on market question/description",
      "in": "query",
      "name": "q",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Filter by tag slug. Can be repeated for OR logic (e.g., ?tag_slug=sports&tag_slug=politics)",
      "in": "query",
      "name": "tag_slug",
      "required": false,
      "schema": {
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.012,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}
```

## Cost and request rules

Published reference price: \$0.012 USD per successful request. Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

* **Default request reference estimate (USD):** 0.012
* **Cost contract:** fixed\_success
* **Settlement evidence source:** request\_snapshot


## OpenAPI

````yaml openapi/polymarket-clob.json GET /apis/v1/polymarket/rewards/markets/multi
openapi: 3.1.0
info:
  description: ''
  title: Polymarket Clob
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-catalogs:
    polymarket-clob:
      description: ''
      title: Polymarket Clob
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
      x-aisa-document:
        facts_hash: 3ef99d33457af3e3c3b16299db54930852c884758cba034bdda67a08da5ab7fb
        generator_version: '3'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-configured-paths:
    - /apis/v1/polymarket/batch-prices-history
    - /apis/v1/polymarket/book
    - /apis/v1/polymarket/books
    - /apis/v1/polymarket/builder/trades
    - /apis/v1/polymarket/cancel-all
    - /apis/v1/polymarket/cancel-market-orders
    - /apis/v1/polymarket/clob-markets/{condition_id}
    - /apis/v1/polymarket/data/orders
    - /apis/v1/polymarket/fee-rate
    - /apis/v1/polymarket/fee-rate/{token_id}
    - /apis/v1/polymarket/heartbeats
    - /apis/v1/polymarket/last-trade-price
    - /apis/v1/polymarket/last-trades-prices
    - /apis/v1/polymarket/markets-by-token/{token_id}
    - /apis/v1/polymarket/midpoint
    - /apis/v1/polymarket/midpoints
    - /apis/v1/polymarket/order
    - /apis/v1/polymarket/order-scoring
    - /apis/v1/polymarket/order/{orderID}
    - /apis/v1/polymarket/orders
    - /apis/v1/polymarket/price
    - /apis/v1/polymarket/prices
    - /apis/v1/polymarket/prices-history
    - /apis/v1/polymarket/rebates/current
    - /apis/v1/polymarket/rewards/markets/current
    - /apis/v1/polymarket/rewards/markets/multi
    - /apis/v1/polymarket/rewards/markets/{condition_id}
    - /apis/v1/polymarket/rewards/user
    - /apis/v1/polymarket/rewards/user/markets
    - /apis/v1/polymarket/rewards/user/percentages
    - /apis/v1/polymarket/rewards/user/total
    - /apis/v1/polymarket/sampling-markets
    - /apis/v1/polymarket/sampling-simplified-markets
    - /apis/v1/polymarket/simplified-markets
    - /apis/v1/polymarket/spread
    - /apis/v1/polymarket/spreads
    - /apis/v1/polymarket/tick-size
    - /apis/v1/polymarket/tick-size/{token_id}
    - /apis/v1/polymarket/time
    - /apis/v1/polymarket/trades
  x-aisa-document:
    composer_version: '20'
    document_hash: sha256:4f5e4ee43fc291a2eac81a6de1e0cf1aa0b2c203f52e26bb112d5fa95e18ab72
    facts_hash: 3ef99d33457af3e3c3b16299db54930852c884758cba034bdda67a08da5ab7fb
    generator_version: '3'
    protocol_version: '1'
    response_pending: []
    schema_version: '1'
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: polymarket-clob
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/polymarket/rewards/markets/multi:
    get:
      tags:
        - default
      summary: Get multiple markets with rewards
      description: >-
        Returns multiple markets with rewards and supports filtering and
        sorting.


        <!-- aisa-pricing:start -->

        Published reference price: $0.012 USD per successful request.
        Account-specific pricing and final settlement may differ.

        <!-- aisa-pricing:end -->
      operationId: any_polymarket_clob_apis_v1_polymarket_rewards_ma_8c7184
      parameters:
        - description: >-
            Filter by event ID. Can be repeated for multiple events (e.g.,
            ?event_id=100&event_id=200)
          in: query
          name: event_id
          required: false
          schema:
            type: string
        - description: Search event titles using case-insensitive pattern matching
          in: query
          name: event_title
          required: false
          schema:
            type: string
        - description: Maximum first token price filter
          in: query
          name: max_price
          required: false
          schema:
            format: double
            type: number
        - description: Maximum spread filter
          in: query
          name: max_spread
          required: false
          schema:
            format: double
            type: number
        - description: Maximum 24-hour volume filter
          in: query
          name: max_volume_24hr
          required: false
          schema:
            format: double
            type: number
        - description: Minimum first token price filter
          in: query
          name: min_price
          required: false
          schema:
            format: double
            type: number
        - description: Minimum spread filter
          in: query
          name: min_spread
          required: false
          schema:
            format: double
            type: number
        - description: Minimum 24-hour volume filter
          in: query
          name: min_volume_24hr
          required: false
          schema:
            format: double
            type: number
        - description: Pagination cursor from previous response
          in: query
          name: next_cursor
          required: false
          schema:
            type: string
        - description: Field to sort results by
          in: query
          name: order_by
          required: false
          schema:
            enum:
              - market_id
              - created_at
              - volume_24hr
              - spread
              - competitiveness
              - max_spread
              - min_size
              - question
              - one_day_price_change
              - rate_per_day
              - price
              - end_date
              - start_date
              - reward_end_date
            type: string
        - description: Number of items per page (max 500, values above are capped)
          in: query
          name: page_size
          required: false
          schema:
            default: 100
            maximum: 500
            type: integer
        - description: Sort direction
          in: query
          name: position
          required: false
          schema:
            enum:
              - ASC
              - DESC
            type: string
        - description: Text search on market question/description
          in: query
          name: q
          required: false
          schema:
            type: string
        - description: >-
            Filter by tag slug. Can be repeated for OR logic (e.g.,
            ?tag_slug=sports&tag_slug=politics)
          in: query
          name: tag_slug
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              example:
                count: 1
                data:
                  - condition_id: >-
                      0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af
                    created_at: '2024-05-01T12:00:00Z'
                    end_date: '2024-08-10 00:00:00'
                    event_id: '12345'
                    event_slug: 2024-us-election
                    group_item_title: ''
                    image: https://example.com/image.png
                    market_competitiveness: 0.42
                    market_id: '248849'
                    market_slug: will-trump-win-the-2024-iowa-caucus
                    one_day_price_change: 0.03
                    question: Will Trump win the 2024 Iowa Caucus?
                    rewards_config:
                      - asset_address: '0x9c4E1703476E875070EE25b56A58B008CFb8FA78'
                        end_date: '2500-12-31'
                        id: 7
                        rate_per_day: 2
                        start_date: '2024-03-01'
                        total_rewards: 92
                    rewards_max_spread: 99
                    rewards_min_size: 10
                    spread: 0.12
                    tokens:
                      - outcome: 'YES'
                        price: 0.8
                        token_id: >-
                          1343197538147866997676250008839231694243646439454152539053893078719042421992
                      - outcome: 'NO'
                        price: 0.2
                        token_id: >-
                          16678291189211314787145083999015737376658799626183230671758641503291735614088
                    volume_24hr: 12345.67
                limit: 50
                next_cursor: NQ==
              schema:
                $ref: >-
                  #/components/schemas/ResponseE58613C05201_PaginatedMultiMarketInfo
          description: Successfully retrieved markets with rewards
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  schemas:
    ResponseE58613C05201_PaginatedMultiMarketInfo:
      description: Paginated list of markets with rewards and trading metrics
      properties:
        count:
          description: Number of items in the current response
          type: integer
        data:
          items:
            $ref: '#/components/schemas/ResponseE58613C05201_MultiMarketInfo'
          type: array
        limit:
          description: Maximum number of items per page
          type: integer
        next_cursor:
          description: Cursor for the next page. "LTE=" indicates the last page.
          type: string
      required:
        - limit
        - count
        - next_cursor
        - data
      type: object
    ResponseE58613C05201_MultiMarketInfo:
      description: Market with rewards configuration and trading metrics
      properties:
        condition_id:
          description: Condition ID of the market
          type: string
        created_at:
          description: Market creation timestamp
          format: date-time
          type: string
        end_date:
          description: Market end date
          type: string
        event_id:
          description: Event ID
          type: string
        event_slug:
          description: URL slug for the event
          type: string
        group_item_title:
          description: Title within an event group
          type: string
        image:
          description: URL to market image
          type: string
        market_competitiveness:
          description: Competitiveness score of the market
          format: double
          type: number
        market_id:
          description: Market ID
          type: string
        market_slug:
          description: URL slug for the market
          type: string
        one_day_price_change:
          description: Price change over the last 24 hours
          format: double
          type: number
        question:
          description: Market question
          type: string
        rewards_config:
          items:
            $ref: '#/components/schemas/ResponseE58613C05201_RewardsConfig'
          type: array
        rewards_max_spread:
          description: Maximum spread for rewards eligibility
          type: number
        rewards_min_size:
          description: Minimum order size for rewards eligibility
          type: number
        spread:
          description: Current spread
          format: double
          type: number
        tokens:
          items:
            $ref: '#/components/schemas/ResponseE58613C05201_RewardsToken'
          type: array
        volume_24hr:
          description: 24-hour trading volume
          format: double
          type: number
      required:
        - condition_id
        - market_id
        - question
        - tokens
      type: object
    ResponseE58613C05201_RewardsConfig:
      description: Rewards configuration for a market
      properties:
        asset_address:
          description: Address of the reward asset
          type: string
        end_date:
          description: End date of the rewards period
          format: date
          type: string
        id:
          description: Rewards config ID
          type: integer
        rate_per_day:
          description: Daily reward rate
          format: double
          type: number
        remaining_reward_amount:
          description: Remaining reward amount
          format: double
          type: number
        start_date:
          description: Start date of the rewards period
          format: date
          type: string
        total_days:
          description: Total number of days in the rewards period
          type: integer
        total_rewards:
          description: Total rewards amount
          format: double
          type: number
      required:
        - asset_address
        - start_date
        - rate_per_day
      type: object
    ResponseE58613C05201_RewardsToken:
      description: Token information for rewards markets
      properties:
        outcome:
          description: Outcome name (e.g., "YES", "NO")
          type: string
        price:
          description: Current price of the token
          format: double
          type: number
        token_id:
          description: Token ID
          type: string
      required:
        - token_id
        - outcome
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.