{"uid":"cap_Mb1Hv5c4O33_rctzxpdjV","slug":"nimbus-onchain-data-api-base-top-tokens-99dafa39","name":"Nimbus Onchain Data API – Base Top Tokens","description":"x402 pay-per-call. Payments are per request in USDC and are final. No refunds on-chain. Service is provided as-is and may change or stop without notice. Informational data only, not financial, investment, legal, or tax advice. Metrics such as net transfer volume estimates and wallet clusters are algorithmic estimates from public blockchain data and may be wrong or delayed. Provided as-is with no warranty. Methodology: https://crypto-data-api-zo95.onrender.com/methodology.","url":"https://crypto-data-api-zo95.onrender.com/v1/base/top-tokens?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"UTC day; default latest available"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"checks_run":{"type":"array"},"disclaimer":{"type":"string"},"gross_volume":{"type":"number","description":"Net token movement per transaction, counted once: net on-chain transfer volume, which includes lending, bridge and exchange flows and is not DEX trading volume."},"transfer_volume":{"type":"object","description":"Summary block (market-check, stablecoin-volume, snapshots): gross_volume, non_circular_volume_estimate, non_circular_share_estimate and USD values. net on-chain transfer volume, which includes lending, bridge and exchange flows and is not DEX trading volume."},"generated_at_utc":{"type":"string"},"volume_definition":{"type":"string","description":"Plain-text definition of the volume figures in this response."},"raw_transfer_volume":{"type":"number","description":"Diagnostic only: sum of every Transfer leg (router hops, flash loans and LP moves included). Not a volume measure."},"circular_share_estimate":{"type":"number","description":"circular_volume_estimate / gross_volume (0-1). Heuristic estimate."},"circular_volume_estimate":{"type":"number","description":"Part of gross_volume matched as circular across transactions (round-trips, high-frequency bot churn, 3-hop cycles). Heuristic estimate."},"intra_tx_round_trip_volume":{"type":"number","description":"Amount that cancels out within single transactions (pass-through hops, repaid flash loans). Excluded from gross_volume."},"liquidity_add_remove_volume":{"type":"number","description":"Transfers into/out of a pool in a tx where that pool added/removed liquidity. Excluded from gross_volume."},"non_circular_share_estimate":{"type":"number","description":"non_circular_volume_estimate / gross_volume (0-1): the non-circular share of net on-chain transfer volume."},"non_circular_volume_estimate":{"type":"number","description":"gross_volume minus circular_volume_estimate: the non-circular part of net on-chain transfer volume. This is net on-chain transfer volume, which includes lending, bridge and exchange flows and is not DEX trading volume."},"non_circular_volume_usd_estimate":{"type":"number","description":"non_circular_volume_estimate valued in USD (stablecoins at $1.00; WETH via on-chain price)."}}}}}}},"responseSchema":{"type":"json","example":{"top":[{"rank":1,"token":"0x...","symbol":"USDC","est_daily_transfers":5000000}],"day_utc":"2026-09-28","checks_run":[{"id":"pipeline_fresh","ran":true,"passed":true,"description":"Ingested data lag under 300s"}],"disclaimer":"Informational data only, ...","gas_at_snapshot":{},"generated_at_utc":"2026-09-29T19:40:00.000Z","snapshot_taken_at_utc":"2026-09-29T00:10:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AljxuRYqa2Xn07jjfdmq7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of the top tokens by estimated daily transfer volume on the Base blockchain for a given UTC day","exampleAgentPrompt":"What are the top tokens by on-chain transfer volume on Base right now — show me the rankings including estimated daily transfer counts and any volume quality notes like circular flow estimates?","exampleUseCases":[{"title":"Daily Base token volume briefing","prompt":"Pull today's top token rankings on Base by on-chain transfer volume and tell me which tokens are leading, including their estimated daily transfer counts."},{"title":"Historical Base token activity lookup","prompt":"What were the top tokens by transfer activity on the Base blockchain on 2025-06-15? I want to see the rankings and any circular volume estimates for that day."},{"title":"DeFi research on Base token flows","prompt":"I'm researching Base chain activity — can you get me the current top tokens ranked by on-chain transfer volume, including the gross volume figures and the non-circular volume estimates so I can filter out bot churn?"}],"resultDescription":"A JSON object containing a ranked list of top tokens on Base (rank, contract address, symbol, estimated daily transfer count), the UTC day the snapshot covers, gross and non-circular volume estimates, circular share heuristics, a gas-at-snapshot object, pipeline freshness check results, a disclaimer, and timestamps for when the data was generated and when the snapshot was taken.","failureModes":["Payment not received or x402 micropayment fails — request is rejected before data is returned","Date parameter does not match YYYY-MM-DD pattern — schema validation error","Requested date has no ingested data yet (too recent or too old) — pipeline_fresh check may fail","Service hosted on Render free tier may be cold-started or temporarily unavailable — timeout or 503","Data may be delayed or stale if pipeline lag exceeds 300 seconds threshold — freshness check flag in response","Volume estimates are algorithmic heuristics and may be incorrect for tokens with complex flow patterns"],"whenToPreferThis":"Use this endpoint when you need a quick ranked snapshot of the most active tokens on the Base L2 blockchain by on-chain transfer volume, especially when you want heuristic circular-flow filtering (bot churn, flash loan round-trips) alongside raw gross volume. Prefer this over generic DEX trading volume APIs when you care about all on-chain transfer activity (lending, bridging, exchange flows) rather than just swap events. Best suited for daily analytics, DeFi research, or monitoring which tokens dominate Base network activity. Not suitable when you need real-time tick-by-tick data, guaranteed accuracy, or financial advice.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:37:58.303Z","isFirstParty":false,"canonicalSlug":"nimbus-onchain-data-api-base-top-tokens-99dafa39"}