# Nami Historical Funding Rates

> Nami Historical Funding Rates 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-13).

Returns historical per-venue perpetual funding rates for a ticker with 1h/4h/1d aggregations over 30-90 day windows

## Facts

- Endpoint: GET https://api.usenami.io/v1/funding/historical
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-usenami-io-bf07436d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Hh1DXXE9Ld_Pi_jh6cooo

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-bf07436d
```

Example prompt: Pull the historical funding rates for BTC across all venues using 4h aggregations over a 90-day window so I can analyze how rates have trended.

## When to prefer this

Use this endpoint when you need raw historical funding rate data per venue for a specific ticker to perform your own analysis, backtesting, or strategy research. Prefer this over the current rates endpoint when temporal context or trend analysis is needed. Choose this over the spread endpoint when you want granular per-venue time series rather than cross-venue spread comparisons. Ideal for quant researchers, algo traders, or risk managers who need clean rate history without pre-computed signals.

## Known failure modes

- Invalid or unsupported ticker symbol returns an error or empty result
- Unsupported aggregation interval (not 1h/4h/1d) causes a validation error
- Requested time window exceeds 90-day maximum, returning an error
- Venue not supported or has no data for the given ticker returns empty records
- Payment failure (x402 micropayment not processed) blocks the request
- Network or API timeout for large date ranges

## How this service works

Historical per-venue funding rates for one crypto perpetual, aggregated 1h/4h/1d, across tracked CEX and DEX venues — the timeseries a funding-arb backtest needs. Up to 30-day windows (30-day retention). Edge-isolated: raw rates only, no spread or signal logic.

## Output

A time series of raw per-venue funding rates for the requested ticker, segmented by the chosen aggregation interval (1h, 4h, or 1d) and covering up to 90 days of history. Each record includes the venue name, timestamp, and funding rate value. No spread calculations or signal logic is included — only raw rate data.

## 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-bf07436d/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)