
The final charge depends on what comes back. It shows after Run.
up to$0.03924per call
Response-basedThe price is worked out from the usage reported in the response, never more than $0.03924 per call.
You aren't charged for failed calls. A wallet payment for a failed call is refunded.
About this endpoint
Preflight Blockchain SQL Query: Validate and estimate a read-only ClickHouse query before executing it.
This endpoint runs EXPLAIN ESTIMATE and does not execute the submitted query. It returns:
- Logical schema plus bounded physical source metadata
- Partition, sorting, and primary-key expressions
- Estimated parts, rows, marks, and bytes
- The final server-bounded SQL and scan budgets
- Machine-readable guardrail warnings with recommended actions
Use GET /v1/onchain/schema?table=<name> for metadata-only discovery. Preflight accepts the same JSON shape and SQL safety rules as POST /v1/onchain/sql, but missing pruning filters are returned as structured rejection warnings rather than running the query.
The planner rejects address columns wrapped in lower() and transfer-table predicates that combine from and to with OR. Normalize address literals before submission, compare stored lowercase columns directly, and split incoming/outgoing transfer predicates into projection-fri
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
- Blockchain SQL queryPOST/gateway/v1/onchain/sql$0.02616 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