# Nami Perp Volume History

> Nami Perp Volume History is a paid API for AI agents from api.usenami.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns historical 24-hour trading volume timeseries (1h, 4h, or 1d granularity) for a perpetual futures ticker/venue pair over a 30–90 day window.

## Facts

- Endpoint: GET https://api.usenami.io/v1/perp/volume-history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-usenami-io-074a4f5a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eU81GEj8nw9mW9M5gbN0q

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 api-usenami-io-074a4f5a
```

Example prompt: Pull the historical 24h volume timeseries for BTC-PERP on Binance from Nami at 4-hour granularity over the last 30 days so I can spot any unusual volume spikes.

## When to prefer this

Use this endpoint when you need historical volume timeseries for a specific perpetual futures market at a specific venue with configurable granularity. Prefer this over the 24h rolling snapshot endpoint when you need multi-day trend data rather than a single current reading, and over open-interest history when volume (not OI) is the relevant signal.

## Known failure modes

- Ticker or venue not supported — returns 404 or empty dataset
- Requested window exceeds 90-day cap — may be truncated or return error
- Invalid granularity value — returns validation error
- Rate limit exceeded — returns 429
- Payment not provided or insufficient — returns 402

## How this service works

Historical 24h-volume timeseries for one crypto perpetual on one venue, aggregated 1h/4h/1d — liquidity over time for backtests and venue selection. 30–90d window cap.

## Output

A timeseries array of 24h trading volume data points for the specified ticker and venue, with timestamps and USD volume values at the requested granularity (1h, 4h, or 1d), covering up to a 30–90 day lookback window.

## Example request

```json
{
 "days": 30,
 "type": "perpetual_futures",
 "venue": "binance",
 "method": "volume_history",
 "ticker": "BTC",
 "granularity": "4h"
}
```

## 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"
    },
    "method": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-usenami-io-074a4f5a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.usenami.io](https://www.zero.xyz/host/api.usenami.io/llms.txt)