
$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 Structured Query: Send a JSON object describing the query. Example: {"source":"agent.ethereum_dex_trades","fields":["block_time"],"filters":[{"field":"block_date","op":"gte","value":"2025-03-01"}],"limit":1}.
Use this endpoint when you want structured filtering without writing raw SQL. Discover tables and columns first with GET /v1/onchain/schema.
Key rules:
- Source format: agent.<table_name>
- Max 10,000 rows (default 20), 30s timeout
- Always filter on block_date for large tables
- Never filter by symbol — it is unindexed (full scan). To resolve a ticker to a contract address, use GET /v1/search/token?q={symbol}&chain={chain} and filter by contract_address instead
- For transfer tables, amount is decimal-adjusted display units; amount_raw is the original base-unit value
Data refresh: ~24 hours.
Example
```json
{
"source": "agent.ethereum_dex_trades",
"fields": ["block_time", "project", "token_pair", "amount_usd", "taker"],
"filters": [
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