Pricing
How query costs are calculated
Pricing
Every query is priced by complexity — the sum of costs for each field you request. You only pay for what you ask for.
Cost per field
| Field | Complexity units | Description |
|---|---|---|
token(address) base | 1 | Single token lookup |
newTokens base | 5 | New token discovery |
trending base | 5 | Volume-ranked tokens |
movers base | 5 | Top gainers/losers |
search base | 2 | Text search |
pairs base | 2 | Pair lookup |
Token.price | 3 | Price snapshot lookup |
Token.liquidity | 3 | Liquidity data |
Token.volume | 2 | 24h volume metrics |
Token.holders | 8 | Holder distribution |
Token.risk | 10 | Full risk analysis |
Token.address, symbol, name, decimals | 0 | Free DB fields |
Cost per unit: 0.00002 USDC
Minimum charge: 0.002 USDC per query
Example calculation
graphql{ newTokens(limit: 10) { # 5 units base tokens { symbol # 0 units (free) price { usd } # 3 units risk { score } # 10 units } } } # Total: 18 units × $0.00002 = $0.00036 USDC
Getting the cost before paying
Send any query without a payment header. The 402 response body contains:
json{ "details": { "amount": "0.000360", "queryCostUnits": 18, "costPerUnit": 0.00002 } }
Your agent can read this and decide whether to proceed before signing any payment.
Cost examples for common queries
| Use case | Typical cost |
|---|---|
| Look up a single token's price | ~$0.002 (min charge) |
| Screen 10 new tokens with risk + price | ~$0.00036 |
| Get 50 trending tokens with full data | ~$0.00150 |
| Bulk search + risk screening pipeline | ~$0.00500 |
Developer API keys
During development, you can use credit-based API keys instead of x402. Each query deducts complexity units from your credit balance. See the Quickstart for usage.