
$0.02616per call
Every call costs the same.
You aren't charged for failed calls. A wallet payment for a failed call is refunded.
About this endpoint
Blockchain SQL Query: Run a raw ClickHouse SELECT query against blockchain data.
All tables live in the agent database. Discover tables and columns first with GET /v1/onchain/schema.
Send a JSON object, not raw SQL text. Example: {"sql":"SELECT ...","max_rows":1000}.
Execution modes
- The default response is synchronous and has a 30s timeout.
- For queries that may exceed that window, send Prefer: respond-async. The same request is accepted as a durable job with 202 Accepted and Preference-Applied: respond-async.
- Send a stable Idempotency-Key with respond-async so equivalent client retries reuse the retained job.
- A synchronous timeout is non-retryable and returns recommended_action: use_async_job plus the async job URL. Do not resubmit the synchronous request automatically.
- Synchronous and asynchronous ClickHouse executions share one cluster-wide per-owner concurrency budget. Accepted async jobs remain queued while that owner's execution slots are occupie
Body parameters
Response types
More from Surf API
- KOL rankingGET/gateway/v1/smart-money/kol/ranking$0.01308 per callFixed
- Liquidation chartGET/gateway/v1/market/liquidation/chart$0.01308 per callFixed
- KOL call historyGET/gateway/v1/smart-money/kol/history$0.01308 per callFixed
- Order book depthGET/gateway/v1/exchange/depth$0.00654 per callFixed
- Latest company financialsGET/gateway/v1/equity/latest-financialsUp to $0.03924 per callResponse-based
- Web page fetchGET/gateway/v1/web/fetch$0.00654 per callFixed
- Matched market pairsGET/gateway/v1/prediction-market/matching/pairs$0.02616 per callFixed
- Polymarket wallet positionsGET/gateway/v1/prediction-market/polymarket/positions$0.02616 per callFixed
- Hyperliquid trader leaderboardGET/gateway/v1/hyperliquid/leaderboard$0.02616 per callFixed
- Perpetual contract snapshotGET/gateway/v1/exchange/perp$0.00654 per callFixed
- KOL activityGET/gateway/v1/smart-money/kol/activity$0.01308 per callFixed
- Token DEX tradesGET/gateway/v1/token/dex-trades$0.02616 per callFixed