BS
BaseScreener

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

FieldComplexity unitsDescription
token(address) base1Single token lookup
newTokens base5New token discovery
trending base5Volume-ranked tokens
movers base5Top gainers/losers
search base2Text search
pairs base2Pair lookup
Token.price3Price snapshot lookup
Token.liquidity3Liquidity data
Token.volume224h volume metrics
Token.holders8Holder distribution
Token.risk10Full risk analysis
Token.address, symbol, name, decimals0Free 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 caseTypical 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.