# Nimbus Onchain Data API – Base Top Tokens

> Nimbus Onchain Data API – Base Top Tokens 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 a ranked list of the top tokens by estimated daily transfer volume on the Base blockchain for a given UTC day

## Facts

- Endpoint: GET https://crypto-data-api-zo95.onrender.com/v1/base/top-tokens?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-base-top-tokens-99dafa39
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Mb1Hv5c4O33_rctzxpdjV

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-base-top-tokens-99dafa39
```

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

## When to prefer this

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.

## Known failure modes

- 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

## 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 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.

## 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": [],
     "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 (pas
… (truncated)
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nimbus-onchain-data-api-base-top-tokens-99dafa39/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)