# Tanod chainpeek Exchange Reserves

> Tanod chainpeek Exchange Reserves is a paid API for AI agents from tanod.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Returns historical exchange reserve balances for a cryptocurrency token across centralised exchanges, with daily snapshots, inflow/outflow direction, and per-exchange breakdowns.

## Facts

- Endpoint: POST https://tanod.dev/v1/chain/exchange-reserves?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-chainpeek-exchange-reserves-74fe9408
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yGabzKhVYf5J_l-v4tmXS

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 tanod-chainpeek-exchange-reserves-74fe9408 -d '<json body>'
```

Example prompt: Can you pull the BTC exchange reserve data from Tanod chainpeek for the last 30 days, broken down by Binance and OKX, and tell me whether inflows or outflows have been dominant this week?

## When to prefer this

Use this endpoint when an agent needs on-chain exchange reserve intelligence for a specific cryptocurrency — particularly to assess selling pressure (rising reserves = potential sell-off), accumulation signals (falling reserves = withdrawal to cold wallets), or to gate a DeFi deposit decision. Prefer this over general price APIs when the question is about supply dynamics on centralised exchanges rather than price. Best for per-exchange reserve breakdowns and historical trend analysis backed by DefiLlama's labeled wallet data.

## Known failure modes

- Unknown or unsupported token symbol returns an empty or null result with a reason field
- Wrapped token symbols (e.g. WBTC) are not matched to base assets (BTC) — must use exact symbol
- Exchange slug not found is silently ignored or returns empty exchanges array
- Requesting more than 90 days returns a validation error
- More than 20 exchange slugs in a single request is rejected
- Stale data flag may be true for some exchanges if DefiLlama cache is delayed
- Partial day data for the most recent date may cause misleading change calculations

## How this service works

Use when an agent must judge selling pressure or check reserves before depositing: a coin's exchange inflow or outflow. chainpeek (Tanod) exchange reserves: how much of a coin sits on centralised exchanges and its 1, 7 and 30-day inflow or outflow, from cached DefiLlama data.

## Output

Returns a JSON object with: total reserve amount and USD value for the requested asset, percentage and absolute change over 1d/7d/30d windows, inflow or outflow direction over 7 days, a daily history array (date, amount, USD value, number of exchanges), a per-exchange breakdown (slug, amount, share %, USD value, change metrics, staleness flag), cache metadata, and a data source note crediting DefiLlama. The newest day may be a partial snapshot.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "default": 30,
   "maximum": 90,
   "minimum": 1,
   "description": "Length of the daily history of the total, in days (default 30, at most 90)."
  },
  "asset": {
   "type": "string",
   "pattern": "^[A-Za-z0-9._$\\-]{1,20}$",
   "description": "Token symbol held on exchanges, e.g. BTC, ETH, USDT, USDC (case-insensitive; matched exactly, so WBTC is not BTC)."
  },
  "exchanges": {
   "anyOf": [
    {
     "type": "array",
     "items": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1
     },
     "maxItems": 20,
     "minItems": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Exchange slugs or names to include, e.g. binance-cex, okx, bybit, kucoin (default: every tracked exchange, at most 20 names)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 3,
  "note": "The wallets are the exchanges' published or labelled wallets (proof-of-reserves lists and addresses DefiLlama has labelled), so a rise means coins moved into those wallets and a fall means they moved out. It does not show an exchange's full custody, off-chain or internal balances, or what the coins are used for. Token symbols are matched exactly: a wrapped token (WBTC, WETH) is a different asset from BTC or ETH. USD values use DefiLlama's price for that day. Daily snapshots; the newest day can be partial. Informational only, not investment advice.",
  "as_of": "2026-10-11",
  "asset": "BTC",
  "reason": null,
  "source": "Data: DefiLlama (used with permission), served from Tanod's cache, refreshed every few hours",
  "totals": {
   "amount": 303817.52579,
   "change": {
    "1d": {
     "pct": 0.135,
     "amount": 410.26414
    },
    "7d": {
     "pct": 2.795,
     "amount": 8261.61383
    },
    "30d": {
     "pct": 3.962,
     "amount": 11577.16924
    }
   },
   "usd_value": 25380149452.92,
   "direction_7d": "inflow"
  },
  "history": [
   {
    "date": "2026-10-09",
    "amount": 301262.89765,
    "exchanges": 2,
    "usd_value": 24616388603.82
   },
   {
    "date": "2026-10-10",
    "amount": 303407.26165,
    "exchanges": 2,
    "usd_value": 25036746237.95
   },
   {
    "date": "2026-10-11",
    "amount": 303817.52579,
    "exchanges": 2,
    "usd_value": 25380149452.92
   }
  ],
  "exchanges": [
   {
    "slug": "bitfinex",
    "as_of": "2026-10-11",
    "stale": false,
    "amount": 157892.88715,
    "change": {
     "1d": {
      "pct": 0.024,
      "amount": 37.80942
     },
     "7d": {
      "pct": 3.138,
      "amount": 4803.74547
     },
     "30d": {
      "pct": 6.147,
      "amount": 9143.91377
     }
    },
    "exchange": "Bitfinex",
    "share_pct": 51.97,
    "usd_value": 13195310963.64,
    "direction_7d": "inflow"
   },
   {
    "slug": "okx",
    "as_of": "2026-10-11",
    "stale": false,
    "amount": 145924.63864,
    "change": {
     "1d": {
      "pct": 0.256,
      "amount": 372.45472
     },
     "7d": {
      "pct": 2.427,
      "amount": 3457.86836
     },
     "30d": {
      "pct": 1.696,
      "amount": 2433.25547
     }
    },
    "exchange": "OKX",
    "share_pct": 48.03,
    "usd_value": 12184838489.28,
    "direction_7d": "inflow"
   }
  ],
  "not_found": [],
  "exchange_count": 2,
  "cache_age_hours": 0,
  "cache_refreshed_at": "2026-10-11T22:48:42Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-chainpeek-exchange-reserves-74fe9408/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)