{"uid":"cap__KL4eeGEowiJ8149ThL3E","slug":"nimbus-onchain-data-api-token-net-transfer-volume-2fbfc893","name":"Nimbus Onchain Data API – Token Net Transfer Volume","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/token/net-volume?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":["token"],"properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"minutes":{"type":"string","pattern":"^[0-9]{1,2}$","description":"5-60, default 30. For high-traffic tokens such as USDC, use windows of 10 minutes or less: longer windows may hit the 20-call/10-second per-request cap and return an uncharged 503."}}}},"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":{"token":"0x4200000000000000000000000000000000000006","symbol":"WETH","checks_run":[{"id":"pipeline_fresh","ran":true,"passed":true,"description":"Ingested data lag under 300s"}],"disclaimer":"Informational data only, ...","window_minutes":30,"generated_at_utc":"2026-09-29T19:40:00.000Z","metrics_estimate":{"gross_volume":4000,"raw_transfer_volume":2700000,"circular_volume_estimate":1200,"intra_tx_round_trip_volume":2136000,"liquidity_add_remove_volume":560000,"non_circular_volume_estimate":2800},"non_circular_share_estimate":0.7,"non_circular_volume_estimate":2800}},"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_Zdq9RRatpWC3uCyCe_kuy","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 net on-chain transfer volume metrics for an ERC-20 token over a configurable time window, with circular/bot-flow filtering estimates","exampleAgentPrompt":"What's the net on-chain transfer volume for WETH (contract 0x4200000000000000000000000000000000000006) over the last 10 minutes, broken down by circular vs non-circular flows?","exampleUseCases":[{"title":"DeFi bot-flow detection dashboard","prompt":"Pull the net transfer volume for the USDC token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 using a 10-minute window — I want to see what share of its volume is circular or bot-driven versus real transfers."},{"title":"Token liquidity health monitoring","prompt":"Check the on-chain transfer volume for 0x4200000000000000000000000000000000000006 over the last 30 minutes and tell me the non-circular volume estimate and gross volume so I can assess whether there's real liquidity activity."},{"title":"Stablecoin volume anomaly alerting","prompt":"Get me the latest 5-minute net transfer volume snapshot for the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I'm looking for any unusual spike in circular or wash-trade volume."}],"resultDescription":"A JSON object containing the token symbol, time window, gross volume, raw transfer volume, circular volume estimate, intra-transaction round-trip volume, liquidity add/remove volume, non-circular volume estimate, non-circular share estimate, a list of pipeline health checks, generation timestamp, and a plain-text disclaimer and volume definition.","failureModes":["503 Uncharged: High-traffic token (e.g. USDC) with a long window hits the 20-call/10-second internal cap — use windows of 10 minutes or less","Invalid token address format (not a valid 0x hex address of 40 chars) returns a validation error","Minutes parameter outside 5-60 range returns a validation error","Stale data: pipeline lag may exceed 300 seconds, flagged by the pipeline_fresh check in checks_run","Service unavailability: hosted on Render free tier, may cold-start or go offline without notice"],"whenToPreferThis":"Use this endpoint when you need on-chain transfer volume for a specific ERC-20 token with circular-flow and bot-churn filtering, especially when you want to distinguish real economic activity from wash trading, round-trips, or LP/flash-loan noise. It is particularly valuable for DeFi analytics, token health monitoring, and anomaly detection where raw DEX trading volume would overcount. Prefer shorter windows (≤10 min) for high-volume tokens like USDC to avoid 503 errors.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:35:42.190Z","isFirstParty":false,"canonicalSlug":"nimbus-onchain-data-api-token-net-transfer-volume-2fbfc893"}