# Crypto Funding Rate Arbitrage API
> The perpetual-futures funding rate for a coin side by side across the major exchanges, and the spread between them — computed live from each venue's public API, no key, nothing stored. A perpetual swap charges or pays funding every few hours to keep its price tethered to spot; when the same coin's funding differs across exchanges, a trader can be long the perp where funding is most negative (and gets paid) and short where it is most positive, harvesting the spread market-neutral. The funding endpoint returns, for a coin, the current funding rate on Binance, Bybit, OKX and Gate.io — per interval and annualised — the venue paying the most, the one charging the most, and the cross-exchange spread (the arbitrage edge). The screener endpoint scans a basket and ranks the coins by the size of that spread, surfacing the biggest funding-arbitrage opportunities. This is the cross-exchange funding-rate / basis-arbitrage cut for crypto — distinct from the single-exchange funding-rates feed (one venue), the spot-versus-perpetual basis and the price APIs in the catalogue. Funding is per interval (most venues settle every 8 hours); annualisation assumes three settlements a day, and intervals can differ by venue, so verify before trading. Coins are bases (BTC, ETH).

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/fundingarbitrage-api/..."
```

## Pricing
- **Free** (Free) — 350 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 10,600 calls/Mo, 6 req/s
- **Pro** ($38/Mo) — 64,000 calls/Mo, 16 req/s
- **Business** ($86/Mo) — 330,000 calls/Mo, 40 req/s

## Endpoints

### Funding Arbitrage

#### `GET /v1/funding` — Funding rate across exchanges & arbitrage spread

**Parameters:**
- `coin` (query, required, string) — Coin base symbol Example: `BTC`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fundingarbitrage-api/v1/funding?coin=BTC"
```

#### `GET /v1/screener` — Rank a basket by cross-exchange funding spread

**Parameters:**
- `coins` (query, optional, string) — Comma list of coins (default liquid majors) Example: `BTC,ETH,SOL,DOGE,XRP`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fundingarbitrage-api/v1/screener?coins=BTC%2CETH%2CSOL%2CDOGE%2CXRP"
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fundingarbitrage-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/fundingarbitrage-api
OpenAPI spec: https://www.oanor.com/api/fundingarbitrage-api/openapi.json