{ "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "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.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "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.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } } } } }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ], "paths": { "/apis/v1/surf/dex/token/price": { "post": { "description": "Surf DEX Token OHLCV Price\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_dex_token_price", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "chain": { "enum": [ "ethereum", "base", "bsc", "arbitrum", "optimism", "polygon", "avalanche", "solana" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "interval": { "default": "1h", "enum": [ "1m", "5m", "15m", "30m", "1h", "4h", "12h", "1d", "7d" ], "type": "string" }, "time_range": { "default": "24h", "enum": [ "1h", "6h", "12h", "24h", "7d", "30d", "90d", "180d", "365d", "max" ], "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "chain", "address" ], "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" } }, "summary": "Surf DEX Token OHLCV Price", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "5936ba558015", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cca998af6fc4" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_dex_token_price", "method": "POST", "path": "/apis/v1/surf/dex/token/price" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_dex_token_price" } }, "/apis/v1/surf/exchange/candles": { "post": { "description": "Surf Exchange Historical Candles\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_exchange_candles", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "enum": [ "bithumb", "upbit", "hashkey", "bitflyer", "coinone", "korbit" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "include_synthetic": { "default": true, "type": "boolean" }, "interval": { "default": "5m", "enum": [ "5m", "4h", "1w" ], "type": "string" }, "limit": { "default": 100, "maximum": 300, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "pair": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "exchange", "pair" ], "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" } }, "summary": "Surf Exchange Historical Candles", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "035fe7775ebf", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2c571be292a0" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_exchange_candles", "method": "POST", "path": "/apis/v1/surf/exchange/candles" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_exchange_candles" } }, "/apis/v1/surf/exchange/coverage": { "post": { "description": "Surf Exchange Market Coverage\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "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" } }, "summary": "Surf Exchange Market Coverage", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "c8b35e96305e", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "acec537e3191" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_exchange_coverage", "method": "POST", "path": "/apis/v1/surf/exchange/coverage" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_exchange_coverage" } }, "/apis/v1/surf/exchange/depth": { "post": { "description": "Surf Exchange Order Book Depth\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_exchange_depth", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "default": "binance", "enum": [ "binance", "okx", "bybit", "bitget", "coinbase", "kraken", "gate", "mexc", "upbit", "bitstamp", "deribit", "bitmex", "bithumb", "hyperliquid" ], "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "pair": { "minLength": 1, "type": "string" }, "type": { "default": "spot", "enum": [ "spot", "swap", "perpetual", "perp" ], "type": "string" } }, "required": [ "pair" ], "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" } }, "summary": "Surf Exchange Order Book Depth", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "15af81b6a64d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e1399ab36eef" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_exchange_depth", "method": "POST", "path": "/apis/v1/surf/exchange/depth" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_exchange_depth" } }, "/apis/v1/surf/exchange/funding-history": { "post": { "description": "Surf Exchange Funding Rate History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_exchange_funding_history", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "default": "binance", "enum": [ "binance", "okx", "bybit", "bitget", "gate", "htx", "mexc", "bitfinex", "bitmex", "hyperliquid" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "limit": { "default": 100, "maximum": 500, "minimum": 1, "type": "integer" }, "pair": { "minLength": 1, "type": "string" } }, "required": [ "pair" ], "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" } }, "summary": "Surf Exchange Funding Rate History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "a75edaa741ab", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ae434a8afed2" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_exchange_funding_history", "method": "POST", "path": "/apis/v1/surf/exchange/funding-history" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_exchange_funding_history" } }, "/apis/v1/surf/exchange/klines": { "post": { "description": "Surf Exchange OHLCV Candlesticks\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_exchange_klines", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "default": "binance", "enum": [ "binance", "okx", "bybit", "bitget", "coinbase", "kraken", "gate", "htx", "kucoin", "mexc", "upbit", "bitfinex", "bitstamp", "deribit", "bitmex", "bithumb", "hyperliquid" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "interval": { "default": "1h", "enum": [ "1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "6h", "8h", "12h", "1d", "3d", "1w", "1M" ], "type": "string" }, "limit": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" }, "pair": { "minLength": 1, "type": "string" }, "type": { "default": "spot", "enum": [ "spot", "swap", "perpetual", "perp" ], "type": "string" } }, "required": [ "pair" ], "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" } }, "summary": "Surf Exchange OHLCV Candlesticks", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "29a94316e30e", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a3595d2a7aac" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_exchange_klines", "method": "POST", "path": "/apis/v1/surf/exchange/klines" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_exchange_klines" } }, "/apis/v1/surf/exchange/long-short-ratio": { "post": { "description": "Surf Exchange Long/Short Ratio History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_exchange_long_short_ratio", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "default": "binance", "enum": [ "binance", "okx", "bybit", "bitget" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "interval": { "default": "1h", "enum": [ "1h", "4h", "1d" ], "type": "string" }, "limit": { "default": 50, "maximum": 500, "minimum": 1, "type": "integer" }, "pair": { "minLength": 1, "type": "string" } }, "required": [ "pair" ], "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" } }, "summary": "Surf Exchange Long/Short Ratio History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "24bb38f88c89", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5fecdb8d81b3" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_exchange_long_short_ratio", "method": "POST", "path": "/apis/v1/surf/exchange/long-short-ratio" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_exchange_long_short_ratio" } }, "/apis/v1/surf/exchange/markets": { "post": { "description": "Surf Exchange Trading Pairs\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_exchange_markets", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "base": { "minLength": 1, "type": "string" }, "exchange": { "default": "binance", "enum": [ "binance", "okx", "bybit", "bitget", "coinbase", "kraken", "gate", "htx", "kucoin", "mexc", "upbit", "bitfinex", "bitstamp", "deribit", "bitmex", "bithumb", "hyperliquid" ], "type": "string" }, "limit": { "default": 100, "maximum": 5000, "minimum": 1, "type": "integer" }, "quote": { "minLength": 1, "type": "string" }, "search": { "minLength": 1, "type": "string" }, "type": { "enum": [ "spot", "swap", "future", "option", "perpetual", "perp" ], "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" } }, "summary": "Surf Exchange Trading Pairs", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "9d2561991baf", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f3381fc82693" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_exchange_markets", "method": "POST", "path": "/apis/v1/surf/exchange/markets" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_exchange_markets" } }, "/apis/v1/surf/exchange/perp": { "post": { "description": "Surf Exchange Perpetual Contract Snapshot\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_exchange_perp", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "default": "binance", "enum": [ "binance", "okx", "bybit", "bitget", "htx", "bitfinex", "bitmex", "hyperliquid" ], "type": "string" }, "fields": { "default": "funding,oi", "minLength": 1, "type": "string" }, "pair": { "minLength": 1, "type": "string" } }, "required": [ "pair" ], "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" } }, "summary": "Surf Exchange Perpetual Contract Snapshot", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "75183a81ab2c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9ed6b77b98c4" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_exchange_perp", "method": "POST", "path": "/apis/v1/surf/exchange/perp" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_exchange_perp" } }, "/apis/v1/surf/exchange/price": { "post": { "description": "Surf Exchange Ticker Price\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_exchange_price", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "default": "binance", "enum": [ "binance", "okx", "bybit", "bitget", "coinbase", "kraken", "gate", "htx", "kucoin", "mexc", "upbit", "bitfinex", "bitstamp", "deribit", "bitmex", "bithumb", "hyperliquid" ], "type": "string" }, "pair": { "minLength": 1, "type": "string" }, "type": { "default": "spot", "enum": [ "spot", "swap", "perpetual", "perp" ], "type": "string" } }, "required": [ "pair" ], "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" } }, "summary": "Surf Exchange Ticker Price", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "f6d0b309848f", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5954b938b88a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_exchange_price", "method": "POST", "path": "/apis/v1/surf/exchange/price" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_exchange_price" } }, "/apis/v1/surf/fund/detail": { "post": { "description": "Surf Fund Profile Detail\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_fund_detail", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Fund Profile Detail", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "d54af428cd24", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5c38b4131895" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_fund_detail", "method": "POST", "path": "/apis/v1/surf/fund/detail" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_fund_detail" } }, "/apis/v1/surf/fund/portfolio": { "post": { "description": "Surf Fund Portfolio\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_fund_portfolio", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "invested_after": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "invested_before": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "is_lead": { "enum": [ "true", "false", "" ], "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "enum": [ "asc", "desc" ], "type": "string" }, "q": { "minLength": 1, "type": "string" }, "sort_by": { "enum": [ "invested_at", "recent_raise", "total_raise" ], "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "invested_after": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "invested_before": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "is_lead": { "enum": [ "true", "false", "" ], "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "enum": [ "asc", "desc" ], "type": "string" }, "q": { "minLength": 1, "type": "string" }, "sort_by": { "enum": [ "invested_at", "recent_raise", "total_raise" ], "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Fund Portfolio", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "cf1797482e33", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2a7f4da7b60b" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_fund_portfolio", "method": "POST", "path": "/apis/v1/surf/fund/portfolio" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_fund_portfolio" } }, "/apis/v1/surf/fund/ranking": { "post": { "description": "Surf Fund Ranking\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_fund_ranking", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "metric": { "enum": [ "tier", "portfolio_count" ], "type": "string" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "metric" ], "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" } }, "summary": "Surf Fund Ranking", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "b134b6d3755f", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "12870dc96e7e" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_fund_ranking", "method": "POST", "path": "/apis/v1/surf/fund/ranking" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_fund_ranking" } }, "/apis/v1/surf/heatscore/detail": { "post": { "description": "Surf Signal Detail\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_heatscore_detail", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "time_range": { "enum": [ "24h", "7d" ], "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "project_slug": { "minLength": 1, "type": "string" }, "time_range": { "enum": [ "24h", "7d" ], "type": "string" } }, "required": [ "project_slug" ], "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" } }, "summary": "Surf Signal Detail", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "01fd6677884c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "12d2da58578a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_heatscore_detail", "method": "POST", "path": "/apis/v1/surf/heatscore/detail" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_heatscore_detail" } }, "/apis/v1/surf/heatscore/projects": { "post": { "description": "Surf Signal Projects\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_heatscore_projects", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "time_range": { "default": "24h", "enum": [ "24h", "7d" ], "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" } }, "summary": "Surf Signal Projects", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "729f682f06c6", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5ffbebfc4fc9" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_heatscore_projects", "method": "POST", "path": "/apis/v1/surf/heatscore/projects" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_heatscore_projects" } }, "/apis/v1/surf/heatscore/token-of-the-day": { "post": { "description": "Surf Signal Token Of The Day\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_heatscore_token_of_the_day", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "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" } }, "summary": "Surf Signal Token Of The Day", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "8cfe5ad99b17", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "82b3511fbae7" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_heatscore_token_of_the_day", "method": "POST", "path": "/apis/v1/surf/heatscore/token-of-the-day" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_heatscore_token_of_the_day" } }, "/apis/v1/surf/heatscore/token-of-week": { "post": { "description": "Surf Signal Token Of The Week\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_heatscore_token_of_week", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "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" } }, "summary": "Surf Signal Token Of The Week", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "dee899f3af25", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aa0df706dd1d" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_heatscore_token_of_week", "method": "POST", "path": "/apis/v1/surf/heatscore/token-of-week" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_heatscore_token_of_week" } }, "/apis/v1/surf/hyperliquid/account": { "post": { "description": "Surf Account Portfolio\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_account", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Account Portfolio", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "81fb5ba1b349", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9e58216926fe" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_account", "method": "POST", "path": "/apis/v1/surf/hyperliquid/account" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_account" } }, "/apis/v1/surf/hyperliquid/candles": { "post": { "description": "Surf Market Candles\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_candles", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "from": { "minLength": 1, "type": "string" }, "interval": { "default": "4h", "enum": [ "1m", "3m", "5m", "15m", "30m", "1h", "2h", "4h", "8h", "12h", "1d", "3d", "1w", "1M" ], "type": "string" }, "symbol": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "symbol", "from", "to" ], "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" } }, "summary": "Surf Market Candles", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "a0c7bacd01ac", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "44e79a8f7a23" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_candles", "method": "POST", "path": "/apis/v1/surf/hyperliquid/candles" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_candles" } }, "/apis/v1/surf/hyperliquid/fills": { "post": { "description": "Surf Fills\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_fills", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "cursor": { "minLength": 1, "type": "string" }, "from": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "order": { "default": "desc", "enum": [ "desc", "asc" ], "type": "string" }, "symbol": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" }, "to_fill_id": { "minLength": 1, "type": "string" }, "to_ms": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "address" ], "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" } }, "summary": "Surf Fills", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "dc7da2fee516", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5306b7ad4cee" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_fills", "method": "POST", "path": "/apis/v1/surf/hyperliquid/fills" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_fills" } }, "/apis/v1/surf/hyperliquid/leaderboard": { "post": { "description": "Surf Trader Leaderboard\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_leaderboard", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "dex": { "enum": [ "main_dex", "xyz", "flx", "vntl", "hyna", "km", "abcd", "cash", "para", "mkts" ], "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "min_account_age_days": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "min_days_active": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "min_human_score": { "default": 0, "maximum": 100, "minimum": 0, "type": "integer" }, "min_trades": { "default": 5, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "sort_by": { "default": "total_pnl", "enum": [ "total_pnl", "win_rate", "volume_traded" ], "type": "string" }, "time_range": { "default": "all", "enum": [ "1d", "7d", "30d", "90d", "all" ], "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" } }, "summary": "Surf Trader Leaderboard", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "b9f9d573fc2c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bf4bb0225a3b" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_leaderboard", "method": "POST", "path": "/apis/v1/surf/hyperliquid/leaderboard" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_leaderboard" } }, "/apis/v1/surf/hyperliquid/orders": { "post": { "description": "Surf Open & Recent Orders\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_orders", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "historical_limit": { "default": 200, "maximum": 2000, "minimum": 1, "type": "integer" }, "open_limit": { "default": 500, "maximum": 2000, "minimum": 1, "type": "integer" } }, "required": [ "address" ], "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" } }, "summary": "Surf Open & Recent Orders", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "38b768716f52", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bdd38515bf13" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_orders", "method": "POST", "path": "/apis/v1/surf/hyperliquid/orders" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_orders" } }, "/apis/v1/surf/hyperliquid/performance": { "post": { "description": "Surf Trading Performance\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_performance", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Trading Performance", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "b28f0b12ec59", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "92755c6e03fc" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_performance", "method": "POST", "path": "/apis/v1/surf/hyperliquid/performance" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_performance" } }, "/apis/v1/surf/hyperliquid/positions": { "post": { "description": "Surf Open Positions\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_positions", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "dex": { "enum": [ "main_dex", "xyz", "flx", "vntl", "hyna", "km", "abcd", "cash", "para", "mkts" ], "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Open Positions", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "31c93feee329", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "538aa3776401" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_positions", "method": "POST", "path": "/apis/v1/surf/hyperliquid/positions" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_positions" } }, "/apis/v1/surf/hyperliquid/trades": { "post": { "description": "Surf Closed Trades\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_trades", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "cursor": { "minLength": 1, "type": "string" }, "from": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Closed Trades", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "5665899e3a26", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a44e7dc3fbee" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_trades", "method": "POST", "path": "/apis/v1/surf/hyperliquid/trades" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_trades" } }, "/apis/v1/surf/hyperliquid/trades/aggregate": { "post": { "description": "Surf Closed Trades Aggregate\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_trades_aggregate", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "dex": { "enum": [ "main_dex", "xyz", "flx", "vntl", "hyna", "km", "abcd", "cash", "para", "mkts" ], "type": "string" }, "fill_gaps": { "default": false, "type": "boolean" }, "from": { "minLength": 1, "type": "string" }, "group_by": { "default": "day", "enum": [ "day", "symbol", "direction", "size_bucket", "hold_bucket" ], "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Closed Trades Aggregate", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "73cc937eda21", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fa6a4519b47a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_trades_aggregate", "method": "POST", "path": "/apis/v1/surf/hyperliquid/trades/aggregate" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_trades_aggregate" } }, "/apis/v1/surf/hyperliquid/trades/context": { "post": { "description": "Surf Closed Trade Funding and Leverage\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_hyperliquid_trades_context", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "close_time": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "direction": { "enum": [ "long", "short" ], "type": "string" }, "open_time": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "symbol": { "minLength": 1, "type": "string" } }, "required": [ "address", "symbol", "direction", "open_time", "close_time" ], "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" } }, "summary": "Surf Closed Trade Funding and Leverage", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "c3fc9bb25757", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b78c462188fe" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_hyperliquid_trades_context", "method": "POST", "path": "/apis/v1/surf/hyperliquid/trades/context" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_hyperliquid_trades_context" } }, "/apis/v1/surf/market/etf": { "post": { "description": "Surf ETF Flow History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_etf", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "from": { "minLength": 1, "type": "string" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "default": "timestamp", "enum": [ "flow_usd", "timestamp" ], "type": "string" }, "symbol": { "enum": [ "BTC", "ETH", "XRP", "SOL", "HYPE" ], "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "symbol" ], "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" } }, "summary": "Surf ETF Flow History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "51d29b732148", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "d0e38d77efef" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_etf", "method": "POST", "path": "/apis/v1/surf/market/etf" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_etf" } }, "/apis/v1/surf/market/exchange-flow/exchanges": { "post": { "description": "Surf Exchange Flow Exchanges\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_exchange_flow_exchanges", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 100, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "symbol": { "enum": [ "BTC", "ETH" ], "type": "string" } }, "required": [ "symbol" ], "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" } }, "summary": "Surf Exchange Flow Exchanges", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "4291c72eb311", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "270f8d8a27b5" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_exchange_flow_exchanges", "method": "POST", "path": "/apis/v1/surf/market/exchange-flow/exchanges" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_exchange_flow_exchanges" } }, "/apis/v1/surf/market/fear-greed": { "post": { "description": "Surf Fear & Greed Index History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_fear_greed", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "from": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "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" } }, "summary": "Surf Fear & Greed Index History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "36ffa2dfc36b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f3bbbef28855" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_fear_greed", "method": "POST", "path": "/apis/v1/surf/market/fear-greed" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_fear_greed" } }, "/apis/v1/surf/market/futures": { "post": { "description": "Surf Futures Market Overview\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_futures", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "default": "volume_24h", "enum": [ "open_interest", "funding_rate", "volume_24h", "long_short_ratio" ], "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" } }, "summary": "Surf Futures Market Overview", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "fac48ece133d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c2280ffe964c" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_futures", "method": "POST", "path": "/apis/v1/surf/market/futures" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_futures" } }, "/apis/v1/surf/market/liquidation/chart": { "post": { "description": "Surf Liquidation Chart\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_liquidation_chart", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "default": "Binance", "enum": [ "Binance", "OKX", "Bybit", "Bitget", "Hyperliquid", "Gate", "HTX", "Bitmex", "Bitfinex", "CoinEx", "Aster", "Lighter" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "interval": { "default": "1h", "enum": [ "1m", "3m", "5m", "15m", "30m", "1h", "4h", "6h", "8h", "12h", "1d", "1w" ], "type": "string" }, "limit": { "default": 500, "maximum": 4500, "minimum": 1, "type": "integer" }, "symbol": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "symbol" ], "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" } }, "summary": "Surf Liquidation Chart", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "41fb943f3b93", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "218b411281ef" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_liquidation_chart", "method": "POST", "path": "/apis/v1/surf/market/liquidation/chart" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_liquidation_chart" } }, "/apis/v1/surf/market/liquidation/exchange-list": { "post": { "description": "Surf Liquidation by Exchange\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_liquidation_exchange_list", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "default": "liquidation_usd", "enum": [ "liquidation_usd", "long_liquidation_usd", "short_liquidation_usd" ], "type": "string" }, "symbol": { "default": "BTC", "minLength": 1, "type": "string" }, "time_range": { "default": "24h", "enum": [ "1h", "4h", "12h", "24h" ], "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" } }, "summary": "Surf Liquidation by Exchange", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "e646e679ffc9", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "39f116c48f4a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_liquidation_exchange_list", "method": "POST", "path": "/apis/v1/surf/market/liquidation/exchange-list" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_liquidation_exchange_list" } }, "/apis/v1/surf/market/liquidation/order": { "post": { "description": "Surf Large Liquidation Orders\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_liquidation_order", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "default": "Binance", "enum": [ "Binance", "OKX", "Bybit", "Bitget", "Hyperliquid", "Gate", "HTX", "Bitmex", "Bitfinex", "CoinEx", "Aster", "Lighter" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "min_amount": { "default": "10000", "minLength": 1, "type": "string" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "side": { "enum": [ "long", "short" ], "type": "string" }, "sort_by": { "default": "timestamp", "enum": [ "usd_value", "timestamp", "price" ], "type": "string" }, "symbol": { "default": "BTC", "minLength": 1, "type": "string" }, "to": { "minLength": 1, "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" } }, "summary": "Surf Large Liquidation Orders", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "c90ea999fc42", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2d78956bb496" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_liquidation_order", "method": "POST", "path": "/apis/v1/surf/market/liquidation/order" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_liquidation_order" } }, "/apis/v1/surf/market/listing": { "post": { "description": "Surf Exchange Listing Events\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_listing", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "minLength": 1, "type": "string" }, "from": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "product": { "default": "all", "enum": [ "spot", "margin", "perp", "pre_market_perp", "all" ], "type": "string" }, "symbol": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" }, "type": { "default": "listing", "enum": [ "listing", "delisting", "cancelled", "advanced", "postponed" ], "type": "string" } }, "required": [ "from" ], "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" } }, "summary": "Surf Exchange Listing Events", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "185da318ed1c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bdd1b426fdff" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_listing", "method": "POST", "path": "/apis/v1/surf/market/listing" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_listing" } }, "/apis/v1/surf/market/options": { "post": { "description": "Surf Options Market Data\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_options", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "default": "volume_24h", "enum": [ "open_interest", "volume_24h" ], "type": "string" }, "symbol": { "enum": [ "BTC", "ETH", "SOL", "XRP", "BNB", "DOGE", "ADA", "AVAX" ], "type": "string" } }, "required": [ "symbol" ], "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" } }, "summary": "Surf Options Market Data", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "86e5d175b485", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1dfcb2101bd5" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_options", "method": "POST", "path": "/apis/v1/surf/market/options" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_options" } }, "/apis/v1/surf/market/price": { "post": { "description": "Surf Token Price History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_price", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "currency": { "default": "usd", "minLength": 1, "type": "string" }, "from": { "minLength": 1, "type": "string" }, "symbol": { "minLength": 1, "type": "string" }, "time_range": { "default": "30d", "enum": [ "1d", "7d", "14d", "30d", "90d", "180d", "365d", "max" ], "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "symbol" ], "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" } }, "summary": "Surf Token Price History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "0dff9c4d122b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bc3351f86491" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_price", "method": "POST", "path": "/apis/v1/surf/market/price" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_price" } }, "/apis/v1/surf/market/price-indicator": { "post": { "description": "Surf Technical Indicator\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_price_indicator", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "exchange": { "default": "binance", "enum": [ "binance", "bybit", "coinbase", "kraken" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "indicator": { "enum": [ "rsi", "macd", "ema", "sma", "bbands", "stoch", "adx", "atr", "cci", "obv", "vwap", "dmi", "ichimoku", "supertrend" ], "type": "string" }, "interval": { "default": "1d", "enum": [ "1m", "5m", "15m", "30m", "1h", "2h", "4h", "12h", "1d", "1w" ], "type": "string" }, "options": { "minLength": 1, "type": "string" }, "symbol": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "indicator", "symbol" ], "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" } }, "summary": "Surf Technical Indicator", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "73fe6c6920ac", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7b78745134ce" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_price_indicator", "method": "POST", "path": "/apis/v1/surf/market/price-indicator" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_price_indicator" } }, "/apis/v1/surf/market/public-sale": { "post": { "description": "Surf Public Sale / Crowdsale\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_public_sale", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Public Sale / Crowdsale", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "3d9165cdabb9", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "eecc5756d0f6" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_public_sale", "method": "POST", "path": "/apis/v1/surf/market/public-sale" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_public_sale" } }, "/apis/v1/surf/market/ranking": { "post": { "description": "Surf Token Rankings\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_ranking", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "category": { "enum": [ "MEME", "AI", "AI_AGENTS", "L1", "L2", "DEFI", "GAMING", "STABLECOIN", "RWA", "DEPIN", "SOL_ECO", "BASE_ECO", "LST" ], "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "default": "market_cap", "enum": [ "market_cap", "change_24h", "volume_24h" ], "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" } }, "summary": "Surf Token Rankings", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "e34b2cc4ae4f", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b9f1e7381b87" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_ranking", "method": "POST", "path": "/apis/v1/surf/market/ranking" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_ranking" } }, "/apis/v1/surf/market/tge": { "post": { "description": "Surf Token Generation Event\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_market_tge", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Token Generation Event", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "b4632a089311", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "015e97a814dd" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_market_tge", "method": "POST", "path": "/apis/v1/surf/market/tge" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_market_tge" } }, "/apis/v1/surf/news/detail": { "post": { "description": "Surf News Article Detail\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_news_detail", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" } }, "required": [ "id" ], "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" } }, "summary": "Surf News Article Detail", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "c4bf8200d16f", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9283fcc6d5ef" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_news_detail", "method": "POST", "path": "/apis/v1/surf/news/detail" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_news_detail" } }, "/apis/v1/surf/news/feed": { "post": { "description": "Surf Crypto News Feed\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_news_feed", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "from": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 50, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "project": { "minLength": 1, "type": "string" }, "sort_by": { "default": "recency", "enum": [ "recency", "trending" ], "type": "string" }, "source": { "enum": [ "coindesk", "cointelegraph", "theblock", "decrypt", "dlnews", "blockbeats", "bitcoincom", "coinpedia", "ambcrypto", "cryptodaily", "cryptopotato", "phemex", "panews", "odaily", "tradingview", "chaincatcher", "techflow" ], "type": "string" }, "to": { "minLength": 1, "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" } }, "summary": "Surf Crypto News Feed", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "9f4ba906b5f0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1b3995144c5b" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_news_feed", "method": "POST", "path": "/apis/v1/surf/news/feed" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_news_feed" } }, "/apis/v1/surf/onchain/bridge/ranking": { "post": { "description": "Surf Bridge Protocol Ranking\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_onchain_bridge_ranking", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "time_range": { "default": "30d", "enum": [ "7d", "30d", "90d", "180d", "1y", "all" ], "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" } }, "summary": "Surf Bridge Protocol Ranking", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "65caf36b3af2", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e1485a4d48a8" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_onchain_bridge_ranking", "method": "POST", "path": "/apis/v1/surf/onchain/bridge/ranking" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_onchain_bridge_ranking" } }, "/apis/v1/surf/onchain/dex/activity": { "post": { "description": "Surf DEX Protocol Activity\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_onchain_dex_activity", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "chain": { "enum": [ "ethereum", "base", "bsc", "arbitrum", "tron" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "group_by": { "enum": [ "total", "day" ], "type": "string" }, "project": { "minLength": 1, "type": "string" }, "time_range": { "enum": [ "1d", "7d", "30d", "90d" ], "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "chain", "project" ], "type": "object" }, { "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "chain": { "enum": [ "ethereum", "base", "bsc", "arbitrum", "tron" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "group_by": { "enum": [ "total", "day" ], "type": "string" }, "time_range": { "enum": [ "1d", "7d", "30d", "90d" ], "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "chain", "address" ], "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" } }, "summary": "Surf DEX Protocol Activity", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "61740b097b5b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2489cabb0df1" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_onchain_dex_activity", "method": "POST", "path": "/apis/v1/surf/onchain/dex/activity" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_onchain_dex_activity" } }, "/apis/v1/surf/onchain/gas-price": { "post": { "description": "Surf Current Gas Price\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_onchain_gas_price", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "chain": { "enum": [ "ethereum", "polygon", "bsc", "arbitrum", "optimism", "base", "avalanche", "fantom", "linea", "cyber" ], "type": "string" } }, "required": [ "chain" ], "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" } }, "summary": "Surf Current Gas Price", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "a1d503e6dcf5", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3c464ef6c6cc" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_onchain_gas_price", "method": "POST", "path": "/apis/v1/surf/onchain/gas-price" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_onchain_gas_price" } }, "/apis/v1/surf/onchain/query": { "post": { "description": "Surf Blockchain Structured Query\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_onchain_query", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "fields": { "items": { "minLength": 1, "type": "string" }, "type": "array" }, "filters": { "items": { "additionalProperties": false, "properties": { "field": { "minLength": 1, "type": "string" }, "op": { "enum": [ "eq", "neq", "gt", "gte", "lt", "lte", "like", "in", "not_in" ], "type": "string" }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] }, "type": "array" } ] } }, "required": [ "field", "op", "value" ], "type": "object" }, "type": "array" }, "limit": { "maximum": 10000, "minimum": 1, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "sort": { "items": { "additionalProperties": false, "properties": { "field": { "minLength": 1, "type": "string" }, "order": { "enum": [ "asc", "desc" ], "type": "string" } }, "required": [ "field" ], "type": "object" }, "type": "array" }, "source": { "pattern": "^agent\\.[a-z0-9_]+$", "type": "string" } }, "required": [ "source" ], "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" } }, "summary": "Surf Blockchain Structured Query", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "effa5443fd4a", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4391f9d22c18" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_onchain_query", "method": "POST", "path": "/apis/v1/surf/onchain/query" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_onchain_query" } }, "/apis/v1/surf/onchain/schema": { "post": { "description": "Surf On-Chain Table Schema\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_onchain_schema", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "table": { "minLength": 1, "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" } }, "summary": "Surf On-Chain Table Schema", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "1c9d6fa04816", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "44f48dffbe1c" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_onchain_schema", "method": "POST", "path": "/apis/v1/surf/onchain/schema" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_onchain_schema" } }, "/apis/v1/surf/onchain/sql": { "post": { "description": "Surf Blockchain SQL Query\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_onchain_sql", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "max_rows": { "default": 1000, "maximum": 10000, "minimum": 1, "type": "integer" }, "sql": { "minLength": 1, "type": "string" } }, "required": [ "sql" ], "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" } }, "summary": "Surf Blockchain SQL Query", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "b7337628fa79", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "67f9c5617861" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_onchain_sql", "method": "POST", "path": "/apis/v1/surf/onchain/sql" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_onchain_sql" } }, "/apis/v1/surf/onchain/sql/preflight": { "post": { "description": "Surf Preflight Blockchain SQL Query\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_onchain_sql_preflight", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "max_rows": { "default": 1000, "maximum": 10000, "minimum": 1, "type": "integer" }, "sql": { "minLength": 1, "type": "string" } }, "required": [ "sql" ], "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" } }, "summary": "Surf Preflight Blockchain SQL Query", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "70a7f2a9292e", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "834492d41c69" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_onchain_sql_preflight", "method": "POST", "path": "/apis/v1/surf/onchain/sql/preflight" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_onchain_sql_preflight" } }, "/apis/v1/surf/onchain/tx": { "post": { "description": "Surf Transaction Details by Hash\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_onchain_tx", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "chain": { "enum": [ "ethereum", "polygon", "bsc", "arbitrum", "optimism", "base", "avalanche", "fantom", "linea", "cyber" ], "type": "string" }, "hash": { "minLength": 1, "type": "string" }, "include": { "minLength": 1, "type": "string" } }, "required": [ "hash", "chain" ], "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" } }, "summary": "Surf Transaction Details by Hash", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "15f2b0116df9", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "907d05e0356a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_onchain_tx", "method": "POST", "path": "/apis/v1/surf/onchain/tx" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_onchain_tx" } }, "/apis/v1/surf/onchain/yield/ranking": { "post": { "description": "Surf Yield Pool Ranking\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_onchain_yield_ranking", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "project": { "minLength": 1, "type": "string" }, "sort_by": { "default": "apy", "enum": [ "apy", "tvl_usd" ], "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" } }, "summary": "Surf Yield Pool Ranking", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "e3f2bd1a4ccb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2e6f5b05125a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_onchain_yield_ranking", "method": "POST", "path": "/apis/v1/surf/onchain/yield/ranking" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_onchain_yield_ranking" } }, "/apis/v1/surf/prediction-market/analytics": { "post": { "description": "Surf Prediction Market Analytics\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_analytics", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "category": { "enum": [ "crypto", "culture", "economics", "financials", "politics", "stem", "sports" ], "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "platform": { "enum": [ "polymarket", "kalshi" ], "type": "string" }, "sort_by": { "default": "volume_7d", "enum": [ "volume_7d", "whale_flow_net_7d", "price_change_7d", "oi_change_7d" ], "type": "string" }, "time_range": { "default": "30d", "enum": [ "7d", "30d", "90d", "180d", "1y" ], "type": "string" }, "top_n": { "default": 10, "maximum": 50, "minimum": 1, "type": "integer" } }, "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" } }, "summary": "Surf Prediction Market Analytics", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "49fb0acdd970", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f79e82b5ea1f" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_analytics", "method": "POST", "path": "/apis/v1/surf/prediction-market/analytics" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_analytics" } }, "/apis/v1/surf/prediction-market/correlations": { "post": { "description": "Surf Market Correlations\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_correlations", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "category": { "enum": [ "crypto", "culture", "economics", "financials", "politics", "stem", "sports" ], "type": "string" }, "condition_id": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "min_correlation": { "default": 0.5, "type": "number" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "category" ], "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" } }, "summary": "Surf Market Correlations", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "b1c04d56c009", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "408f2b3b665c" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_correlations", "method": "POST", "path": "/apis/v1/surf/prediction-market/correlations" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_correlations" } }, "/apis/v1/surf/prediction-market/kalshi/events": { "post": { "description": "Surf Kalshi Events\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_kalshi_events", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "event_ticker": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "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" } }, "summary": "Surf Kalshi Events", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "4062170d9069", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "953ee92e3e1a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_kalshi_events", "method": "POST", "path": "/apis/v1/surf/prediction-market/kalshi/events" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_kalshi_events" } }, "/apis/v1/surf/prediction-market/kalshi/markets": { "post": { "description": "Surf Kalshi Markets\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_kalshi_markets", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "market_ticker": { "minLength": 1, "type": "string" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "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" } }, "summary": "Surf Kalshi Markets", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "7d21eb376dc6", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f51d7247d84c" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_kalshi_markets", "method": "POST", "path": "/apis/v1/surf/prediction-market/kalshi/markets" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_kalshi_markets" } }, "/apis/v1/surf/prediction-market/kalshi/open-interest": { "post": { "description": "Surf Kalshi Open Interest History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_kalshi_o_382715", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "ticker": { "minLength": 1, "type": "string" }, "time_range": { "default": "30d", "enum": [ "7d", "30d", "90d", "180d", "1y" ], "type": "string" } }, "required": [ "ticker" ], "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" } }, "summary": "Surf Kalshi Open Interest History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "984f37e5e502", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "afbb0cc3dfd9" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_kalshi_o_382715", "method": "POST", "path": "/apis/v1/surf/prediction-market/kalshi/open-interest" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_kalshi_o_382715" } }, "/apis/v1/surf/prediction-market/kalshi/orderbooks": { "post": { "description": "Surf Kalshi Orderbook History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_kalshi_o_2fff63", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "end_time": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "limit": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" }, "pagination_key": { "minLength": 1, "type": "string" }, "start_time": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "ticker": { "minLength": 1, "type": "string" } }, "required": [ "ticker" ], "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" } }, "summary": "Surf Kalshi Orderbook History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "0774cdd0f846", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "388e6f9c380a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_kalshi_o_2fff63", "method": "POST", "path": "/apis/v1/surf/prediction-market/kalshi/orderbooks" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_kalshi_o_2fff63" } }, "/apis/v1/surf/prediction-market/kalshi/prices": { "post": { "description": "Surf Kalshi Price History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_kalshi_prices", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "interval": { "default": "1d", "enum": [ "1h", "1d", "latest" ], "type": "string" }, "ticker": { "minLength": 1, "type": "string" }, "time_range": { "default": "30d", "enum": [ "7d", "30d", "90d", "180d", "1y" ], "type": "string" } }, "required": [ "ticker" ], "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" } }, "summary": "Surf Kalshi Price History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "e95227a42f56", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a87dbe1867d3" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_kalshi_prices", "method": "POST", "path": "/apis/v1/surf/prediction-market/kalshi/prices" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_kalshi_prices" } }, "/apis/v1/surf/prediction-market/kalshi/trades": { "post": { "description": "Surf Kalshi Trades\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_kalshi_trades", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "from": { "minLength": 1, "type": "string" }, "limit": { "default": 50, "maximum": 500, "minimum": 1, "type": "integer" }, "min_amount": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "default": "timestamp", "enum": [ "timestamp", "notional_volume_usd" ], "type": "string" }, "taker_side": { "enum": [ "yes", "no" ], "type": "string" }, "ticker": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "ticker" ], "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" } }, "summary": "Surf Kalshi Trades", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "2baf67f79539", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "44e21f4bb92d" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_kalshi_trades", "method": "POST", "path": "/apis/v1/surf/prediction-market/kalshi/trades" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_kalshi_trades" } }, "/apis/v1/surf/prediction-market/kalshi/volumes": { "post": { "description": "Surf Kalshi Volume History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_kalshi_volumes", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "ticker": { "minLength": 1, "type": "string" }, "time_range": { "default": "30d", "enum": [ "7d", "30d", "90d", "180d", "1y" ], "type": "string" } }, "required": [ "ticker" ], "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" } }, "summary": "Surf Kalshi Volume History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "f13f6875701d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5638d359aaa1" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_kalshi_volumes", "method": "POST", "path": "/apis/v1/surf/prediction-market/kalshi/volumes" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_kalshi_volumes" } }, "/apis/v1/surf/prediction-market/matching/daily": { "post": { "description": "Surf Cross-Platform Daily Comparison (Polymarket <> Kalshi)\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_matching_daily", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "kalshi_market_ticker": { "minLength": 1, "type": "string" }, "limit": { "default": 200, "maximum": 10000, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "polymarket_condition_id": { "minLength": 1, "type": "string" }, "time_range": { "default": "30d", "enum": [ "1d", "7d", "30d", "90d", "180d", "1y", "all" ], "type": "string" } }, "required": [ "polymarket_condition_id", "kalshi_market_ticker" ], "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" } }, "summary": "Surf Cross-Platform Daily Comparison (Polymarket <> Kalshi)", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "f6c12c9fd34b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "923482e70a7d" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_matching_daily", "method": "POST", "path": "/apis/v1/surf/prediction-market/matching/daily" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_matching_daily" } }, "/apis/v1/surf/prediction-market/matching/pairs": { "post": { "description": "Surf Cross-Platform Prediction Market Matcher (Polymarket <> Kalshi)\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_matching_pairs", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "active_only": { "default": false, "type": "boolean" }, "category": { "enum": [ "crypto", "culture", "economics", "financials", "politics", "stem", "sports" ], "type": "string" }, "kalshi_market_ticker": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "match_type": { "enum": [ "exact", "related" ], "type": "string" }, "min_confidence": { "default": 0, "maximum": 100, "minimum": 0, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "polymarket_condition_id": { "minLength": 1, "type": "string" }, "sort_by": { "default": "confidence", "enum": [ "confidence", "polymarket_volume", "kalshi_volume", "spread_pct" ], "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" } }, "summary": "Surf Cross-Platform Prediction Market Matcher (Polymarket <> Kalshi)", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "1ca7e1ef9f63", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "819a1b0e270a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_matching_pairs", "method": "POST", "path": "/apis/v1/surf/prediction-market/matching/pairs" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_matching_pairs" } }, "/apis/v1/surf/prediction-market/polymarket/events": { "post": { "description": "Surf Polymarket Events\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_792696", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "event_slug": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "event_slug" ], "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" } }, "summary": "Surf Polymarket Events", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "e4176d81afc6", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f1f13e6c76bb" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_792696", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/events" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_792696" } }, "/apis/v1/surf/prediction-market/polymarket/leaderboard": { "post": { "description": "Surf Polymarket Leaderboard\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_5ec433", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "default": "pnl", "enum": [ "pnl", "volume", "trade_count" ], "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" } }, "summary": "Surf Polymarket Leaderboard", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "01e6655f78e2", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "799a39256aa9" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_5ec433", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/leaderboard" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_5ec433" } }, "/apis/v1/surf/prediction-market/polymarket/markets": { "post": { "description": "Surf Polymarket Markets\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_049f7f", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "market_slug": { "minLength": 1, "type": "string" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "market_slug" ], "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" } }, "summary": "Surf Polymarket Markets", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "1f5fe8095904", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "059ef4a30e56" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_049f7f", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/markets" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_049f7f" } }, "/apis/v1/surf/prediction-market/polymarket/open-interest": { "post": { "description": "Surf Polymarket Open Interest History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_cd9e1f", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "condition_id": { "minLength": 1, "type": "string" }, "time_range": { "default": "30d", "enum": [ "7d", "30d", "90d", "180d", "1y" ], "type": "string" } }, "required": [ "condition_id" ], "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" } }, "summary": "Surf Polymarket Open Interest History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "dadc97dfb20c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "04b2922a9ec0" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_cd9e1f", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/open-interest" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_cd9e1f" } }, "/apis/v1/surf/prediction-market/polymarket/orderbooks": { "post": { "description": "Surf Polymarket Orderbook History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_acfabb", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "end_time": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "limit": { "default": 100, "maximum": 200, "minimum": 1, "type": "integer" }, "pagination_key": { "minLength": 1, "type": "string" }, "start_time": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "token_id": { "minLength": 1, "type": "string" } }, "required": [ "token_id" ], "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" } }, "summary": "Surf Polymarket Orderbook History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "b66ed91a0fe8", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "76cc9e8d9461" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_acfabb", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/orderbooks" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_acfabb" } }, "/apis/v1/surf/prediction-market/polymarket/positions": { "post": { "description": "Surf Polymarket Wallet Positions\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_24f960", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "limit": { "default": 50, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "address" ], "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" } }, "summary": "Surf Polymarket Wallet Positions", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "73ded5757901", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0e4ed232955a" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_24f960", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/positions" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_24f960" } }, "/apis/v1/surf/prediction-market/polymarket/price-ohlcv": { "post": { "description": "Surf Polymarket OHLCV Candlesticks\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_03680a", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "condition_id": { "description": "Polymarket condition ID. Example: 0x6fefc0438c7598b23531457c8c60541990d0786bd4bd9dfc3eabc8d95c291092.", "minLength": 1, "type": "string" }, "end_time": { "description": "End time (Unix seconds). 0 means current time. Cache aligns to 5-minute buckets, so two requests within the same bucket return the same cached result.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "interval": { "default": 60, "description": "Candle interval in minutes: 1=1min, 60=1hour, 1440=1day. Defaults to 60.", "maximum": 1440, "minimum": 1, "type": "integer" }, "start_time": { "description": "Start time (Unix seconds). 0 means no lower bound. Cache aligns to 5-minute buckets, so two requests within the same bucket return the same cached result.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "condition_id" ], "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" } }, "summary": "Surf Polymarket OHLCV Candlesticks", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "9403dbcd1e36", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "26b73c7929f2" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_03680a", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/price-ohlcv" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_03680a" } }, "/apis/v1/surf/prediction-market/polymarket/prices": { "post": { "description": "Surf Polymarket Price History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_6bb5fd", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "condition_id": { "minLength": 1, "type": "string" }, "interval": { "default": "1d", "enum": [ "1h", "1d", "latest" ], "type": "string" }, "time_range": { "default": "30d", "enum": [ "7d", "30d", "90d", "180d", "1y" ], "type": "string" } }, "required": [ "condition_id" ], "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" } }, "summary": "Surf Polymarket Price History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "4c3389f6d4a3", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3af188a2d045" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_6bb5fd", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/prices" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_6bb5fd" } }, "/apis/v1/surf/prediction-market/polymarket/smart-money": { "post": { "description": "Surf Polymarket Smart Money\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_4f4f8c", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "category": { "enum": [ "crypto", "culture", "economics", "financials", "politics", "stem", "sports" ], "type": "string" }, "condition_id": { "minLength": 1, "type": "string" }, "direction": { "enum": [ "bullish", "bearish", "neutral" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "default": "smart_wallets_involved", "enum": [ "smart_wallets_involved", "smart_buy_volume_usd", "smart_sell_volume_usd", "amount_usd", "block_time" ], "type": "string" }, "to": { "minLength": 1, "type": "string" }, "view": { "default": "positioning", "enum": [ "positioning", "trades" ], "type": "string" }, "whale_tier": { "enum": [ "whale", "large", "mega" ], "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" } }, "summary": "Surf Polymarket Smart Money", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "4fae3abda28c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "42273e5f0c1b" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_4f4f8c", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/smart-money" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_4f4f8c" } }, "/apis/v1/surf/prediction-market/polymarket/trades": { "post": { "description": "Surf Polymarket Trades\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_c77b68", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "condition_id": { "minLength": 1, "type": "string" }, "from": { "minLength": 1, "type": "string" }, "limit": { "maximum": 500, "minimum": 1, "type": "integer" }, "min_amount": { "minimum": 0, "type": "number" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "outcome_label": { "enum": [ "Yes", "No" ], "type": "string" }, "sort_by": { "enum": [ "timestamp", "notional_volume_usd" ], "type": "string" }, "to": { "minLength": 1, "type": "string" }, "type": { "enum": [ "trade", "redemption", "all" ], "type": "string" } }, "required": [ "condition_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "condition_id": { "minLength": 1, "type": "string" }, "from": { "minLength": 1, "type": "string" }, "limit": { "maximum": 500, "minimum": 1, "type": "integer" }, "min_amount": { "minimum": 0, "type": "number" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "outcome_label": { "enum": [ "Yes", "No" ], "type": "string" }, "sort_by": { "enum": [ "timestamp", "notional_volume_usd" ], "type": "string" }, "to": { "minLength": 1, "type": "string" }, "type": { "enum": [ "trade", "redemption", "all" ], "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Polymarket Trades", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "e06c62fd31ee", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "193ea428bd69" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_c77b68", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/trades" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_c77b68" } }, "/apis/v1/surf/prediction-market/polymarket/volume-split": { "post": { "description": "Surf Polymarket Volume Split (YES/NO)\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_a18a88", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "condition_id": { "description": "Polymarket condition ID. Example: 0x6fefc0438c7598b23531457c8c60541990d0786bd4bd9dfc3eabc8d95c291092.", "minLength": 1, "type": "string" }, "end_time": { "description": "End time (Unix seconds). 0 means current time. Cache aligns to 5-minute buckets, so two requests within the same bucket return the same cached result.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "granularity": { "default": "hour", "description": "Time granularity for volume aggregation. Defaults to \"hour\".", "enum": [ "hour", "day", "week" ], "type": "string" }, "start_time": { "description": "Start time (Unix seconds). 0 means no lower bound. Cache aligns to 5-minute buckets, so two requests within the same bucket return the same cached result.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "condition_id" ], "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" } }, "summary": "Surf Polymarket Volume Split (YES/NO)", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "7a0ff3920fb6", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "96675df88007" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_a18a88", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/volume-split" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_a18a88" } }, "/apis/v1/surf/prediction-market/polymarket/volumes": { "post": { "description": "Surf Polymarket Volume History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_prediction_market_polymark_94436d", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "condition_id": { "minLength": 1, "type": "string" }, "end_time": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "granularity": { "enum": [ "day", "week", "month", "year", "all" ], "type": "string" }, "interval": { "enum": [ "1h", "1d" ], "type": "string" }, "start_time": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "time_range": { "enum": [ "7d", "30d", "90d", "180d", "1y" ], "type": "string" }, "token_id": { "minLength": 1, "type": "string" } }, "required": [ "condition_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "condition_id": { "minLength": 1, "type": "string" }, "end_time": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "granularity": { "enum": [ "day", "week", "month", "year", "all" ], "type": "string" }, "interval": { "enum": [ "1h", "1d" ], "type": "string" }, "start_time": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "time_range": { "enum": [ "7d", "30d", "90d", "180d", "1y" ], "type": "string" }, "token_id": { "minLength": 1, "type": "string" } }, "required": [ "token_id" ], "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" } }, "summary": "Surf Polymarket Volume History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "a0e967230de6", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bdbc16b1875e" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_prediction_market_polymark_94436d", "method": "POST", "path": "/apis/v1/surf/prediction-market/polymarket/volumes" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_prediction_market_polymark_94436d" } }, "/apis/v1/surf/project/ai-news": { "post": { "description": "Surf Project AI News\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_project_ai_news", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "lang": { "enum": [ "en", "zh", "ja", "kr" ], "type": "string" }, "limit": { "maximum": 50, "minimum": 1, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "lang": { "enum": [ "en", "zh", "ja", "kr" ], "type": "string" }, "limit": { "maximum": 50, "minimum": 1, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "minLength": 1, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Project AI News", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "0b56b531dbdc", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "47e4be9dba89" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_project_ai_news", "method": "POST", "path": "/apis/v1/surf/project/ai-news" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_project_ai_news" } }, "/apis/v1/surf/project/defi/metrics": { "post": { "description": "Surf Project DeFi Metrics\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_project_defi_metrics", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "chain": { "enum": [ "ethereum", "polygon", "bsc", "arbitrum", "optimism", "base", "avalanche", "fantom", "solana" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "metric": { "enum": [ "volume", "fee", "fees", "revenue", "tvl", "users" ], "type": "string" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "chain": { "enum": [ "ethereum", "polygon", "bsc", "arbitrum", "optimism", "base", "avalanche", "fantom", "solana" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "metric": { "enum": [ "volume", "fee", "fees", "revenue", "tvl", "users" ], "type": "string" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Project DeFi Metrics", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "13676ecb7dfb", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "185a7b8d2f67" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_project_defi_metrics", "method": "POST", "path": "/apis/v1/surf/project/defi/metrics" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_project_defi_metrics" } }, "/apis/v1/surf/project/defi/ranking": { "post": { "description": "Surf DeFi Protocol Ranking\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_project_defi_ranking", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "metric": { "enum": [ "tvl", "revenue", "fees", "volume", "users" ], "type": "string" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "metric" ], "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" } }, "summary": "Surf DeFi Protocol Ranking", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "3f903ea1faa2", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3ed50b63c642" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_project_defi_ranking", "method": "POST", "path": "/apis/v1/surf/project/defi/ranking" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_project_defi_ranking" } }, "/apis/v1/surf/project/detail": { "post": { "description": "Surf Aggregated Project Detail\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_project_detail", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "fields": { "minLength": 1, "type": "string" }, "handle": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" }, "x_id": { "minLength": 1, "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "fields": { "minLength": 1, "type": "string" }, "handle": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" }, "x_id": { "minLength": 1, "type": "string" } }, "required": [ "x_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "fields": { "minLength": 1, "type": "string" }, "handle": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" }, "x_id": { "minLength": 1, "type": "string" } }, "required": [ "handle" ], "type": "object" }, { "additionalProperties": false, "properties": { "fields": { "minLength": 1, "type": "string" }, "handle": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "q": { "minLength": 1, "type": "string" }, "x_id": { "minLength": 1, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Aggregated Project Detail", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "86e7acd1b97d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "9920964a1abe" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_project_detail", "method": "POST", "path": "/apis/v1/surf/project/detail" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_project_detail" } }, "/apis/v1/surf/search/airdrop": { "post": { "description": "Surf Airdrop Search\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_airdrop", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "has_open": { "default": false, "type": "boolean" }, "include_tasks": { "default": false, "type": "boolean" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "phase": { "default": "active,claimable", "minLength": 1, "pattern": "^\\s*(?:active|claimable|completed)\\s*(?:,\\s*(?:active|claimable|completed)\\s*)*$", "type": "string" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" }, "reward_type": { "enum": [ "airdrop", "points", "whitelist", "nft", "role", "ambassador" ], "type": "string" }, "sort_by": { "default": "last_status_update", "enum": [ "total_raise", "xscore", "last_status_update" ], "type": "string" }, "task_type": { "enum": [ "social", "bounty-platforms", "testnet", "mainnet", "role", "form", "liquidity", "mint-nft", "game", "trading", "staking", "depin", "node", "ambassador", "hold", "check-wallet", "mint-domain", "predictions", "deploy" ], "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" } }, "summary": "Surf Airdrop Search", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "5a3302cedbb8", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "fde26d0cf373" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_airdrop", "method": "POST", "path": "/apis/v1/surf/search/airdrop" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_airdrop" } }, "/apis/v1/surf/search/airdrop/activities": { "post": { "description": "Surf Airdrop Activities\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_airdrop_activities", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "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" } }, "summary": "Surf Airdrop Activities", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "8a068cf83f29", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "53f0406d0800" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_airdrop_activities", "method": "POST", "path": "/apis/v1/surf/search/airdrop/activities" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_airdrop_activities" } }, "/apis/v1/surf/search/events": { "post": { "description": "Surf Project Event Search\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_events", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" }, "type": { "enum": [ "launch", "upgrade", "partnership", "news", "airdrop", "listing", "twitter" ], "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "id": { "minLength": 1, "type": "string" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" }, "type": { "enum": [ "launch", "upgrade", "partnership", "news", "airdrop", "listing", "twitter" ], "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Project Event Search", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "a093ed76df16", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "4188340ddced" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_events", "method": "POST", "path": "/apis/v1/surf/search/events" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_events" } }, "/apis/v1/surf/search/fund": { "post": { "description": "Surf Fund Search\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_fund", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Fund Search", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "377f2bccd844", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ac23cb417908" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_fund", "method": "POST", "path": "/apis/v1/surf/search/fund" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_fund" } }, "/apis/v1/surf/search/fundraising": { "post": { "description": "Surf Fundraising Event Search\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_fundraising", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "from": { "minLength": 1, "type": "string" }, "lang": { "default": "en", "enum": [ "en", "zh", "ja", "kr", "ko" ], "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "min_importance": { "maximum": 5, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" }, "sort_by": { "default": "recency", "enum": [ "recency", "relevance", "importance" ], "type": "string" }, "source": { "enum": [ "social", "news" ], "type": "string" }, "to": { "minLength": 1, "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" } }, "summary": "Surf Fundraising Event Search", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "e8db226ba801", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "911525864dcc" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_fundraising", "method": "POST", "path": "/apis/v1/surf/search/fundraising" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_fundraising" } }, "/apis/v1/surf/search/news": { "post": { "description": "Surf News Article Search\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_news", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 10, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf News Article Search", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "d5ee9c471865", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6b7a9df94ddc" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_news", "method": "POST", "path": "/apis/v1/surf/search/news" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_news" } }, "/apis/v1/surf/search/prediction-market": { "post": { "description": "Surf Search Prediction Markets\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_prediction_market", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "category": { "enum": [ "crypto", "culture", "economics", "financials", "politics", "stem", "sports" ], "type": "string" }, "condition_id": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "market_ticker": { "minLength": 1, "type": "string" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "platform": { "enum": [ "polymarket", "kalshi" ], "type": "string" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" }, "smart_money": { "enum": [ "bullish", "bearish" ], "type": "string" }, "sort_by": { "default": "volume_7d", "enum": [ "volume_1d", "volume_7d", "volume_30d", "open_interest", "trade_count_7d", "days_to_resolution" ], "type": "string" }, "status": { "default": "active", "enum": [ "active", "closed", "finalized" ], "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" } }, "summary": "Surf Search Prediction Markets", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "166d74e53e5d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cd4e17f3ffbc" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_prediction_market", "method": "POST", "path": "/apis/v1/surf/search/prediction-market" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_prediction_market" } }, "/apis/v1/surf/search/project": { "post": { "description": "Surf Project Search\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_project", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Project Search", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "b90129b88902", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a5c7cbad17f1" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_project", "method": "POST", "path": "/apis/v1/surf/search/project" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_project" } }, "/apis/v1/surf/search/token": { "post": { "description": "Surf Token Symbol Resolution\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_token", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "chain": { "enum": [ "ethereum", "base", "bsc", "arbitrum", "solana", "polygon", "optimism", "avalanche", "fantom", "tron", "linea", "mantle", "blast", "gnosis", "zksync", "scroll" ], "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Token Symbol Resolution", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "641e58409f3f", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c4d78f23c170" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_token", "method": "POST", "path": "/apis/v1/surf/search/token" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_token" } }, "/apis/v1/surf/search/wallet": { "post": { "description": "Surf Wallet Search\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_wallet", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Wallet Search", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "b9c64f39312c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "41513fe08bb3" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_wallet", "method": "POST", "path": "/apis/v1/surf/search/wallet" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_wallet" } }, "/apis/v1/surf/search/web": { "post": { "description": "Surf Web Search\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_search_web", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "include_content": { "default": false, "type": "boolean" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "maxLength": 100, "minLength": 2, "type": "string" }, "site": { "minLength": 1, "type": "string" } }, "required": [ "q" ], "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" } }, "summary": "Surf Web Search", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "00b465c0c0a2", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "eebb1d706b99" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_search_web", "method": "POST", "path": "/apis/v1/surf/search/web" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_search_web" } }, "/apis/v1/surf/token/dex-trades": { "post": { "description": "Surf Token DEX Trade History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_token_dex_trades", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "chain": { "default": "ethereum", "enum": [ "ethereum", "base", "bsc", "arbitrum", "tron" ], "type": "string" }, "include": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "address" ], "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" } }, "summary": "Surf Token DEX Trade History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "99d7e1bfa727", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1b9aee2ddb79" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_token_dex_trades", "method": "POST", "path": "/apis/v1/surf/token/dex-trades" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_token_dex_trades" } }, "/apis/v1/surf/token/holders": { "post": { "description": "Surf Token Holders\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_token_holders", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "chain": { "enum": [ "ethereum", "polygon", "bsc", "solana", "avalanche", "arbitrum", "optimism", "base" ], "type": "string" }, "include": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "address", "chain" ], "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" } }, "summary": "Surf Token Holders", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "fc4a498e9e8c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cc523b6494aa" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_token_holders", "method": "POST", "path": "/apis/v1/surf/token/holders" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_token_holders" } }, "/apis/v1/surf/token/tokenomics": { "post": { "description": "Surf Token Unlock Schedule\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_token_tokenomics", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": false, "properties": { "from": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "symbol": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "id" ], "type": "object" }, { "additionalProperties": false, "properties": { "from": { "minLength": 1, "type": "string" }, "id": { "minLength": 1, "type": "string" }, "symbol": { "minLength": 1, "type": "string" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "symbol" ], "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" } }, "summary": "Surf Token Unlock Schedule", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "d58078726de0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c416822d8564" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_token_tokenomics", "method": "POST", "path": "/apis/v1/surf/token/tokenomics" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_token_tokenomics" } }, "/apis/v1/surf/token/transfer-counterparties": { "post": { "description": "Surf Top Transfer Counterparties\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_token_transfer_counterparties", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "chain": { "enum": [ "ethereum", "base", "bsc", "arbitrum", "tron" ], "type": "string" }, "direction": { "enum": [ "to", "from" ], "type": "string" }, "exclude_labels": { "minLength": 1, "type": "string" }, "include": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "metric": { "default": "count", "enum": [ "count", "amount", "amount_usd" ], "type": "string" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "time_range": { "default": "7d", "enum": [ "1d", "7d", "30d", "90d" ], "type": "string" } }, "required": [ "address", "chain", "direction" ], "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" } }, "summary": "Surf Top Transfer Counterparties", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "7c5d650a6e45", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "47e9e1b1d60d" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_token_transfer_counterparties", "method": "POST", "path": "/apis/v1/surf/token/transfer-counterparties" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_token_transfer_counterparties" } }, "/apis/v1/surf/token/transfer-stats": { "post": { "description": "Surf Token Transfer Activity Summary\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_token_transfer_stats", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "chain": { "enum": [ "ethereum", "base", "bsc", "arbitrum", "tron" ], "type": "string" }, "include": { "minLength": 1, "type": "string" }, "time_range": { "default": "7d", "enum": [ "1d", "7d", "30d", "90d" ], "type": "string" } }, "required": [ "address", "chain" ], "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" } }, "summary": "Surf Token Transfer Activity Summary", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "e99c3e24e731", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0d0d0525a4bd" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_token_transfer_stats", "method": "POST", "path": "/apis/v1/surf/token/transfer-stats" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_token_transfer_stats" } }, "/apis/v1/surf/token/transfers": { "post": { "description": "Surf Token Transfer History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_token_transfers", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "chain": { "enum": [ "ethereum", "base", "solana", "tron", "bsc", "arbitrum" ], "type": "string" }, "from": { "minLength": 1, "type": "string" }, "include": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "to": { "minLength": 1, "type": "string" } }, "required": [ "address", "chain" ], "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" } }, "summary": "Surf Token Transfer History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "0f7e7c719860", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6a2b9a1cbc6d" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_token_transfers", "method": "POST", "path": "/apis/v1/surf/token/transfers" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_token_transfers" } }, "/apis/v1/surf/wallet/detail": { "post": { "description": "Surf Aggregated Wallet Detail\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_wallet_detail", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "chain": { "enum": [ "ethereum", "polygon", "bsc", "avalanche", "arbitrum", "optimism", "fantom", "base", "solana" ], "type": "string" }, "fields": { "default": "balance,tokens,labels,nft", "minLength": 1, "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Aggregated Wallet Detail", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "ff9450455050", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3f6dc685ffb3" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_wallet_detail", "method": "POST", "path": "/apis/v1/surf/wallet/detail" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_wallet_detail" } }, "/apis/v1/surf/wallet/history": { "post": { "description": "Surf Wallet Transaction History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_wallet_history", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "before": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "chain": { "default": "ethereum", "enum": [ "ethereum", "polygon", "bsc", "avalanche", "arbitrum", "optimism", "fantom", "base" ], "type": "string" }, "include": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "order": { "default": "desc", "enum": [ "asc", "desc" ], "type": "string" }, "sort_by": { "default": "timestamp", "enum": [ "timestamp", "value" ], "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Wallet Transaction History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "541095dc0a3a", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f292361bf0bf" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_wallet_history", "method": "POST", "path": "/apis/v1/surf/wallet/history" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_wallet_history" } }, "/apis/v1/surf/wallet/labels/batch": { "post": { "description": "Surf Wallet Labels (Batch)\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_wallet_labels_batch", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "addresses": { "minLength": 1, "type": "string" } }, "required": [ "addresses" ], "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" } }, "summary": "Surf Wallet Labels (Batch)", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "d3d4b3ad36b7", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e9069d00582d" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_wallet_labels_batch", "method": "POST", "path": "/apis/v1/surf/wallet/labels/batch" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_wallet_labels_batch" } }, "/apis/v1/surf/wallet/net-worth": { "post": { "description": "Surf Wallet Net Worth History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_wallet_net_worth", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Wallet Net Worth History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "f24ea63ba554", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aa47536be8dd" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_wallet_net_worth", "method": "POST", "path": "/apis/v1/surf/wallet/net-worth" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_wallet_net_worth" } }, "/apis/v1/surf/wallet/protocols": { "post": { "description": "Surf Wallet DeFi Protocol Positions\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_wallet_protocols", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "address" ], "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" } }, "summary": "Surf Wallet DeFi Protocol Positions", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "d95e85e702e1", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ad353a90bb18" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_wallet_protocols", "method": "POST", "path": "/apis/v1/surf/wallet/protocols" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_wallet_protocols" } }, "/apis/v1/surf/wallet/transfers": { "post": { "description": "Surf Wallet Transfer History\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_wallet_transfers", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "minLength": 1, "type": "string" }, "chain": { "default": "ethereum", "enum": [ "ethereum", "base", "solana", "tron", "bsc", "arbitrum" ], "type": "string" }, "flow": { "enum": [ "in", "out" ], "type": "string" }, "include": { "minLength": 1, "type": "string" }, "limit": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "token": { "minLength": 1, "type": "string" } }, "required": [ "address" ], "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" } }, "summary": "Surf Wallet Transfer History", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "ad6d31625029", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bc309bd303d0" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_wallet_transfers", "method": "POST", "path": "/apis/v1/surf/wallet/transfers" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_wallet_transfers" } }, "/apis/v1/surf/web/fetch": { "post": { "description": "Surf Web Page Fetch\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_surf_apis_v1_surf_web_fetch", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "remove_selector": { "minLength": 1, "type": "string" }, "target_selector": { "minLength": 1, "type": "string" }, "timeout": { "default": 30000, "maximum": 60000, "minimum": 1000, "type": "integer" }, "url": { "format": "uri", "type": "string" }, "wait_for_selector": { "minLength": 1, "type": "string" } }, "required": [ "url" ], "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" } }, "summary": "Surf Web Page Fetch", "tags": [ "Surf" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "supported": true }, "mpp": false, "x402": false }, "x-aisa-category": "surf", "x-aisa-contract-source": "handler", "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" }, "x-aisa-response-passthrough": false, "x-aisa-revision": { "customer_pricing_ref": "6622278caa6d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f6ffeecdb14c" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "surf", "x-aisa-runtime-operation": { "operation_id": "post_surf_apis_v1_surf_web_fetch", "method": "POST", "path": "/apis/v1/surf/web/fetch" }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/surf/post_surf_apis_v1_surf_web_fetch" } } } }