> ## 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 # Surf Exchange Market Coverage > Surf Exchange Market Coverage A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/surf/exchange/coverage * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/surf/exchange/coverage` * **Runtime facts:** 986d7b557d4db8647aee169884ac6410895d723df086210d7e098b01fc34c6c5 [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/surf.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "post_surf_apis_v1_surf_exchange_coverage", "method": "POST", "path": "/apis/v1/surf/exchange/coverage", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "data_status": { "enum": [ "covered", "official_empty_all", "official_empty_ticker", "official_empty_5m", "official_empty_weekly", "stale_gt_7d", "stale_30m_to_7d", "recent_but_lt_min_ta_candles", "missing_4h", "missing_latest_ta" ], "type": "string" }, "exchange": { "enum": [ "bithumb", "upbit", "hashkey", "bitflyer", "coinone", "korbit" ], "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "asc", "enum": [ "asc", "desc" ], "type": "string" }, "q": { "minLength": 1, "type": "string" }, "quote": { "minLength": 1, "type": "string" }, "sort_by": { "default": "pair", "enum": [ "pair", "price", "change_24h", "volume_24h", "technical_score", "latest_candle_at", "status" ], "type": "string" }, "status": { "enum": [ "active", "inactive" ], "type": "string" }, "type": { "default": "spot", "enum": [ "spot" ], "type": "string" } }, "type": "object" } } }, "required": true }, "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "estimate_source": "unavailable", "estimate_unavailable_reason": "reference_request_unavailable", "evidence_source": "response_body" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules A request reference price is not currently available; use a request quote where supported. 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. * **Cost contract:** response\_units * **Published reference multiplier:** 1.0 * **Settlement evidence source:** response\_body ## OpenAPI ````yaml reference-contracts/surf.json POST /apis/v1/surf/exchange/coverage openapi: 3.1.0 info: description: '' title: Surf 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/surf/dex/token/price - /apis/v1/surf/exchange/candles - /apis/v1/surf/exchange/coverage - /apis/v1/surf/exchange/depth - /apis/v1/surf/exchange/funding-history - /apis/v1/surf/exchange/klines - /apis/v1/surf/exchange/long-short-ratio - /apis/v1/surf/exchange/markets - /apis/v1/surf/exchange/perp - /apis/v1/surf/exchange/price - /apis/v1/surf/fund/detail - /apis/v1/surf/fund/portfolio - /apis/v1/surf/fund/ranking - /apis/v1/surf/heatscore/detail - /apis/v1/surf/heatscore/projects - /apis/v1/surf/heatscore/token-of-the-day - /apis/v1/surf/heatscore/token-of-week - /apis/v1/surf/hyperliquid/account - /apis/v1/surf/hyperliquid/candles - /apis/v1/surf/hyperliquid/fills - /apis/v1/surf/hyperliquid/leaderboard - /apis/v1/surf/hyperliquid/orders - /apis/v1/surf/hyperliquid/performance - /apis/v1/surf/hyperliquid/positions - /apis/v1/surf/hyperliquid/trades - /apis/v1/surf/hyperliquid/trades/aggregate - /apis/v1/surf/hyperliquid/trades/context - /apis/v1/surf/market/etf - /apis/v1/surf/market/exchange-flow/exchanges - /apis/v1/surf/market/fear-greed - /apis/v1/surf/market/futures - /apis/v1/surf/market/liquidation/chart - /apis/v1/surf/market/liquidation/exchange-list - /apis/v1/surf/market/liquidation/order - /apis/v1/surf/market/listing - /apis/v1/surf/market/options - /apis/v1/surf/market/price - /apis/v1/surf/market/price-indicator - /apis/v1/surf/market/public-sale - /apis/v1/surf/market/ranking - /apis/v1/surf/market/tge - /apis/v1/surf/news/detail - /apis/v1/surf/news/feed - /apis/v1/surf/onchain/bridge/ranking - /apis/v1/surf/onchain/dex/activity - /apis/v1/surf/onchain/gas-price - /apis/v1/surf/onchain/query - /apis/v1/surf/onchain/schema - /apis/v1/surf/onchain/sql - /apis/v1/surf/onchain/sql/preflight - /apis/v1/surf/onchain/tx - /apis/v1/surf/onchain/yield/ranking - /apis/v1/surf/prediction-market/analytics - /apis/v1/surf/prediction-market/correlations - /apis/v1/surf/prediction-market/kalshi/events - /apis/v1/surf/prediction-market/kalshi/markets - /apis/v1/surf/prediction-market/kalshi/open-interest - /apis/v1/surf/prediction-market/kalshi/orderbooks - /apis/v1/surf/prediction-market/kalshi/prices - /apis/v1/surf/prediction-market/kalshi/trades - /apis/v1/surf/prediction-market/kalshi/volumes - /apis/v1/surf/prediction-market/matching/daily - /apis/v1/surf/prediction-market/matching/pairs - /apis/v1/surf/prediction-market/polymarket/events - /apis/v1/surf/prediction-market/polymarket/leaderboard - /apis/v1/surf/prediction-market/polymarket/markets - /apis/v1/surf/prediction-market/polymarket/open-interest - /apis/v1/surf/prediction-market/polymarket/orderbooks - /apis/v1/surf/prediction-market/polymarket/positions - /apis/v1/surf/prediction-market/polymarket/price-ohlcv - /apis/v1/surf/prediction-market/polymarket/prices - /apis/v1/surf/prediction-market/polymarket/smart-money - /apis/v1/surf/prediction-market/polymarket/trades - /apis/v1/surf/prediction-market/polymarket/volume-split - /apis/v1/surf/prediction-market/polymarket/volumes - /apis/v1/surf/project/ai-news - /apis/v1/surf/project/defi/metrics - /apis/v1/surf/project/defi/ranking - /apis/v1/surf/project/detail - /apis/v1/surf/search/airdrop - /apis/v1/surf/search/airdrop/activities - /apis/v1/surf/search/events - /apis/v1/surf/search/fund - /apis/v1/surf/search/fundraising - /apis/v1/surf/search/news - /apis/v1/surf/search/prediction-market - /apis/v1/surf/search/project - /apis/v1/surf/search/token - /apis/v1/surf/search/wallet - /apis/v1/surf/search/web - /apis/v1/surf/token/dex-trades - /apis/v1/surf/token/holders - /apis/v1/surf/token/tokenomics - /apis/v1/surf/token/transfer-counterparties - /apis/v1/surf/token/transfer-stats - /apis/v1/surf/token/transfers - /apis/v1/surf/wallet/detail - /apis/v1/surf/wallet/history - /apis/v1/surf/wallet/labels/batch - /apis/v1/surf/wallet/net-worth - /apis/v1/surf/wallet/protocols - /apis/v1/surf/wallet/transfers - /apis/v1/surf/web/fetch x-aisa-document: facts_hash: 986d7b557d4db8647aee169884ac6410895d723df086210d7e098b01fc34c6c5 generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '27' response_pending: [] document_hash: sha256:33a920b1a08b077b9b343eac45e5fcdc8d7ddb947bf82cffc6e3ec3952cfb696 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: surf x-aisa-catalogs: surf: title: Surf description: '' x-aisa-document: facts_hash: 986d7b557d4db8647aee169884ac6410895d723df086210d7e098b01fc34c6c5 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/surf/exchange/coverage: post: tags: - Surf summary: Surf Exchange Market Coverage description: >- Surf Exchange Market Coverage A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. operationId: post_surf_apis_v1_surf_exchange_coverage requestBody: content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema additionalProperties: false properties: data_status: enum: - covered - official_empty_all - official_empty_ticker - official_empty_5m - official_empty_weekly - stale_gt_7d - stale_30m_to_7d - recent_but_lt_min_ta_candles - missing_4h - missing_latest_ta type: string exchange: enum: - bithumb - upbit - hashkey - bitflyer - coinone - korbit type: string limit: default: 20 maximum: 100 minimum: 1 type: integer offset: default: 0 maximum: 9007199254740991 minimum: 0 type: integer order: default: asc enum: - asc - desc type: string q: minLength: 1 type: string quote: minLength: 1 type: string sort_by: default: pair enum: - pair - price - change_24h - volume_24h - technical_score - latest_candle_at - status type: string status: enum: - active - inactive type: string type: default: spot enum: - spot type: string type: object required: true responses: '200': content: application/json: schema: additionalProperties: false properties: data: additionalProperties: true minProperties: 1 not: maxProperties: 1 required: - meta type: object required: - data type: object description: Normalized successful response default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.