# Nimbus Onchain Data API – Token Net Transfer Volume

> Nimbus Onchain Data API – Token Net Transfer Volume is a paid API for AI agents from crypto-data-api-zo95.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Returns net on-chain transfer volume metrics for an ERC-20 token over a configurable time window, with circular/bot-flow filtering estimates

## Facts

- Endpoint: GET https://crypto-data-api-zo95.onrender.com/v1/token/net-volume?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nimbus-onchain-data-api-token-net-transfer-volume-2fbfc893
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__KL4eeGEowiJ8149ThL3E

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nimbus-onchain-data-api-token-net-transfer-volume-2fbfc893
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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 circ
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nimbus-onchain-data-api-token-net-transfer-volume-2fbfc893/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto-data-api-zo95.onrender.com](https://www.zero.xyz/host/crypto-data-api-zo95.onrender.com/llms.txt)