> ## 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 > ## Agent Instructions (AIsa) > > - 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`. > - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt # Get order books (request body) > Retrieves order book summaries for multiple token IDs using a request body. ## Cost and request rules 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/books 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-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: facts_hash: 3ef99d33457af3e3c3b16299db54930852c884758cba034bdda67a08da5ab7fb generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '18' response_pending: [] document_hash: sha256:aed00c89a96bbab3b38960d7d0e84e6de5e6fa06dcd1840b2f903c9365eed009 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: polymarket-clob x-aisa-catalogs: polymarket-clob: title: Polymarket Clob description: '' 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-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/polymarket/books: get: tags: - default summary: Get order books (request body) description: >- Retrieves order book summaries for multiple token IDs using a request body. operationId: get_any_polymarket_clob_apis_v1_polymarket_books parameters: - name: token_ids in: query description: Comma-separated list of token IDs required: true schema: type: string example: 0xabc123...,0xdef456... responses: '200': description: Successfully retrieved order books content: application/json: schema: type: array items: $ref: '#/components/schemas/ResponseE58613C05201_OrderBookSummary' example: - market: '0x1234567890123456789012345678901234567890' asset_id: 0xabc123def456... timestamp: '1234567890' hash: a1b2c3d4e5f6... bids: - price: '0.45' size: '100' asks: - price: '0.46' size: '150' min_order_size: '1' tick_size: '0.01' neg_risk: false last_trade_price: '0.45' default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats x-codeSamples: - lang: text label: Reference example source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request GET \ --url 'https://api.aisa.one/apis/v1/polymarket/books?token_ids=0xabc123...%2C0xdef456...' \ --header 'Authorization: Bearer ' components: schemas: ResponseE58613C05201_OrderBookSummary: type: object required: - market - asset_id - timestamp - hash - bids - asks - min_order_size - tick_size - neg_risk - last_trade_price properties: market: type: string description: Market condition ID example: '0x1234567890123456789012345678901234567890' asset_id: type: string description: Token ID (asset ID) example: 0xabc123def456... timestamp: type: string description: Timestamp of the order book snapshot example: '1234567890' hash: type: string description: Hash of the order book summary example: a1b2c3d4e5f6... bids: type: array description: List of bid orders (sorted by price descending) items: $ref: '#/components/schemas/ResponseE58613C05201_OrderSummary' asks: type: array description: List of ask orders (sorted by price ascending) items: $ref: '#/components/schemas/ResponseE58613C05201_OrderSummary' min_order_size: type: string description: Minimum order size example: '1' tick_size: type: string description: Minimum price increment (tick size) example: '0.01' neg_risk: type: boolean description: Whether negative risk is enabled for this market example: false last_trade_price: type: string description: Last trade price example: '0.45' ResponseE58613C05201_OrderSummary: type: object required: - price - size properties: price: type: string description: Order price example: '0.45' size: type: string description: Order size example: '100' securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.