> ## 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 # Post a new order > Submit a new order to the CLOB API. ## 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 POST /apis/v1/polymarket/order 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/order: post: tags: - default summary: Post a new order description: Submit a new order to the CLOB API. operationId: post_any_polymarket_clob_apis_v1_polymarket_order requestBody: required: true content: application/json: schema: type: object required: - order - owner properties: order: type: object description: > Order payload submitted to the CLOB API. In CLOB V2, `expiration` remains in the POST /order wire body for GTD/order-expiry handling, but it is not part of the EIP-712 signed order struct. required: - maker - signer - tokenId - makerAmount - takerAmount - side - expiration - timestamp - builder - signature - salt - signatureType properties: maker: type: string description: >- Ethereum address of the maker (In the default case, this is your proxy address) example: '0x1234567890123456789012345678901234567890' signer: type: string description: Ethereum address of the signer example: '0x1234567890123456789012345678901234567890' tokenId: type: string description: Token ID (asset ID) for the order example: 0xabc123def456... makerAmount: type: string description: >- Amount the maker is providing in fixed-math with 6 decimals example: '100000000' takerAmount: type: string description: >- Amount the taker is providing in fixed-math with 6 decimals example: '200000000' side: type: string description: Order side enum: - BUY - SELL example: BUY expiration: type: string description: >- Unix timestamp when the order expires. Present in the API wire body; not part of the CLOB V2 EIP-712 signed order struct. example: '1735689600' timestamp: type: string description: >- Unix timestamp in milliseconds when the order was created (used for order uniqueness) example: '1735689600000' metadata: type: string description: Reserved for future use example: '' builder: type: string description: >- Builder code (bytes32) for integrator attribution. `0x` + 64 hex chars or empty. example: >- 0x0000000000000000000000000000000000000000000000000000000000000000 signature: type: string description: Cryptographic signature of the order example: 0x1234abcd... salt: type: integer description: Random salt for order uniqueness example: 1234567890 signatureType: type: integer description: >- Type of signature (0 = EOA, 1 = POLY_PROXY, 2 = POLY_GNOSIS_SAFE) enum: - 0 - 1 - 2 owner: type: string description: UUID of the API key owner example: f4f247b7-4ac7-ff29-a152-04fda0a8755a orderType: type: string description: Time in force enum: - GTC - FOK - GTD - FAK default: GTC deferExec: type: boolean description: Whether to defer execution default: false postOnly: type: boolean description: >- Whether the order must rest on the book and not match immediately. Only supported for GTC and GTD orders. default: false examples: example: summary: Send order example value: order: maker: '0x1234567890123456789012345678901234567890' signer: '0x1234567890123456789012345678901234567890' tokenId: 0xabc123def456... makerAmount: '100000000' takerAmount: '200000000' side: BUY expiration: '1735689600' timestamp: '1735689600000' metadata: '' builder: >- 0x0000000000000000000000000000000000000000000000000000000000000000 signature: 0x1234abcd... salt: 1234567890 signatureType: 0 owner: f4f247b7-4ac7-ff29-a152-04fda0a8755a orderType: GTC deferExec: false postOnly: false responses: '200': description: Order successfully processed content: application/json: schema: $ref: '#/components/schemas/ResponseE58613C05201_SendOrderResponse' examples: live_order: summary: Order placed on book value: success: true orderID: '0xabcdef1234567890abcdef1234567890abcdef12' status: live makingAmount: '100000000' takingAmount: '200000000' errorMsg: '' matched_order: summary: Order immediately matched value: success: true orderID: '0xabcdef1234567890abcdef1234567890abcdef12' status: matched makingAmount: '100000000' takingAmount: '200000000' transactionsHashes: - '0x1234567890abcdef1234567890abcdef12345678' tradeIDs: - trade-123 errorMsg: '' delayed_order: summary: Order delayed value: success: true orderID: '0xabcdef1234567890abcdef1234567890abcdef12' status: delayed makingAmount: '100000000' takingAmount: '200000000' errorMsg: '' default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseE58613C05201_SendOrderResponse: type: object required: - success - orderID - status properties: success: type: boolean description: Whether the order was successfully processed example: true orderID: type: string description: Unique identifier for the order (order hash) example: '0xabcdef1234567890abcdef1234567890abcdef12' status: type: string description: Status of the order after processing enum: - live - matched - delayed makingAmount: type: string description: Amount the maker is providing in fixed-math with 6 decimals example: '100000000' takingAmount: type: string description: Amount the taker is providing in fixed-math with 6 decimals example: '200000000' transactionsHashes: type: array description: Array of transaction hashes (present when status is 'matched') items: type: string example: - '0x1234567890abcdef1234567890abcdef12345678' tradeIDs: type: array description: Array of trade IDs (present when status is 'matched') items: type: string errorMsg: type: string description: Error message (empty on success) example: '' securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.