# Bitfinex Exchange API
> Live market data from Bitfinex, one of the longest-running crypto exchanges, served straight from its public v2 API — no key, nothing cached. Bitfinex is best known for two things this exposes as clean JSON: deep spot order books, and a peer-to-peer funding (margin-lending) market that few APIs surface. The ticker endpoint returns a trading pair's snapshot: best bid and ask, last price, 24-hour change and percentage, volume, high and low — BTC/USD near $63,000. The funding endpoint returns a currency's lending market: the Flash Return Rate, the best bid and ask lending rates with their loan periods, and the daily rate annualised to an APR — so you can see what lending US dollars or BTC on Bitfinex pays right now, around 14% APR for USD. The tickers endpoint returns the whole exchange in one call, either every trading pair or every funding currency. The trades endpoint returns the live trade tape — the most recent executed trades with price, amount, side and time. Everything is Bitfinex's live venue data, nothing stored. This is the Bitfinex price, funding-rate and tape layer for any trading, lending, charting or market-data app. Distinct from Coinbase, Binance and Kraken venue APIs and from aggregated feeds — this is Bitfinex's own order book, its margin-funding rates and tape. 4 endpoints, no key on our side, real-time.

## 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/bitfinex-api/..."
```

## Pricing
- **Free** (Free) — 5,000 calls/Mo, 5 req/s
- **Starter** ($14/Mo) — 125,000 calls/Mo, 12 req/s
- **Pro** ($37/Mo) — 780,000 calls/Mo, 30 req/s
- **Mega** ($88/Mo) — 4,200,000 calls/Mo, 80 req/s

## Endpoints

### Bitfinex

#### `GET /v1/funding` — A currency funding/lending market

**Parameters:**
- `currency` (query, required, string) — Currency (or symbol=fUSD) Example: `USD`

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

**Response:**
```json
{
    "data": {
        "low": 1.8e-6,
        "high": 0.00038701,
        "note": "rates are per day; *_apr = daily rate x 365",
        "source": "Bitfinex",
        "symbol": "fUSD",
        "volume": 865945794.2493058,
        "ask_apr": 3.4458,
        "bid_apr": 11,
        "ask_size": 4321671.11759634,
        "bid_size": 21056063.31726966,
        "currency": "USD",
        "ask_rate_daily": 9.440547945205479e-5,
        "bid_rate_daily": 0.00030136986301369865,
        "ask_period_days": 2,
        "bid_period_days": 120,
        "last_rate_daily": 9.54e-5,
        "frr_amount_available": 15484826.52872688,
        "flash_return_rate_apr": 14.1496,
        "flash_return_rate_daily": 0.00038766027397260275
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:06.464Z",
        "request_id": "708df7f8-2783-4d91-a4de-08e2eea54f2d"
    },
    "status": "ok",
    "message": "Funding market retrieved successfully",
    "success": true
}
```

#### `GET /v1/ticker` — A trading pair ticker

**Parameters:**
- `symbol` (query, required, string) — Trading symbol (tBASEQUOTE) Example: `tBTCUSD`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitfinex-api/v1/ticker?symbol=tBTCUSD"
```

**Response:**
```json
{
    "data": {
        "ask": 62669,
        "bid": 62659,
        "last": 62667,
        "pair": "BTCUSD",
        "source": "Bitfinex",
        "spread": 10,
        "symbol": "tBTCUSD",
        "low_24h": 62478,
        "high_24h": 64294,
        "change_24h": -1071,
        "volume_24h": 2112.7323556,
        "change_24h_pct": -1.6803
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:06.607Z",
        "request_id": "a34516ed-9a1d-4107-87d5-90d6178007b9"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

#### `GET /v1/tickers` — All pairs in one call

**Parameters:**
- `type` (query, optional, string) — trading (default) or funding Example: `trading`
- `sort` (query, optional, string) — change or volume (trading only) Example: `change`
- `limit` (query, optional, string) — Max rows

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitfinex-api/v1/tickers?type=trading&sort=change"
```

**Response:**
```json
{
    "data": {
        "type": "trading",
        "count": 299,
        "source": "Bitfinex",
        "tickers": [
            {
                "last": 0.7,
                "pair": "BMN2:BTC",
                "symbol": "tBMN2:BTC",
                "volume_24h": 1.0e-6,
                "change_24h_pct": 12.9032
            },
            {
                "last": 475,
                "pair": "ZECF0:USTF0",
                "symbol": "tZECF0:USTF0",
                "volume_24h": 136.60759723,
                "change_24h_pct": 10.2088
            },
            {
                "last": 0.0073655,
                "pair": "ZECBTC",
                "symbol": "tZECBTC",
                "volume_24h": 23.33676425,
                "change_24h_pct": 9.4591
            },
            {
                "last": 464.92,
                "pair": "ZECUST",
                "symbol": "tZECUST",
                "volume_24h": 54.08195935,
                "change_24h_pct": 9.3929
            },
            {
                "last": 0.027293,
                "pair": "CHZUSD",
                "symbol": "tCHZUSD",
                "volume_24h": 4282675.02467226,
                "change_24h_pct": 7.7497
            },
            {
                "last": 461.44,
                "pair": "ZECUSD",
                "symbol": "tZECUSD",
                "volume_24h": 1484.68673912,
                "change_24h_pct": 7.2144
            },
            {
                "last": 0.026596,
                "pair"
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/trades` — Live trade tape

**Parameters:**
- `symbol` (query, required, string) — Trading symbol Example: `tBTCUSD`
- `limit` (query, optional, string) — Max trades (1-200, default 30) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitfinex-api/v1/trades?symbol=tBTCUSD&limit=20"
```

**Response:**
```json
{
    "data": {
        "pair": "BTCUSD",
        "count": 20,
        "source": "Bitfinex",
        "symbol": "tBTCUSD",
        "trades": [
            {
                "id": 1933459449,
                "side": "sell",
                "time": "2026-06-09T11:38:06.301Z",
                "price": 62634,
                "amount": 0.0002
            },
            {
                "id": 1933459448,
                "side": "sell",
                "time": "2026-06-09T11:38:06.300Z",
                "price": 62635,
                "amount": 0.0002
            },
            {
                "id": 1933459446,
                "side": "sell",
                "time": "2026-06-09T11:38:06.060Z",
                "price": 62638,
                "amount": 0.0002
            },
            {
                "id": 1933459444,
                "side": "sell",
                "time": "2026-06-09T11:38:06.059Z",
                "price": 62640,
                "amount": 0.0002
            },
            {
                "id": 1933459445,
                "side": "sell",
                "time": "2026-06-09T11:38:06.059Z",
                "price": 62639,
                "amount": 0.0002
            },
            {
                "id": 1933459442,
                "side": "sell",
                "time": "2026-06-09T11:38:05.736Z",
                "price": 62646,
                "amount": 0.0002
            },
            {
                "id": 1933459441,
                "side": "buy",
       
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "source": "Bitfinex public API v2 (live)",
        "service": "bitfinex-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "A trading pair's ticker (symbol=tBTCUSD).",
            "GET /v1/trades": "Live trade tape for a pair (symbol=tBTCUSD, limit).",
            "GET /v1/funding": "A currency's funding/lending market with APR (currency=USD or symbol=fUSD).",
            "GET /v1/tickers": "All pairs in one call (type=trading|funding, sort=change|volume)."
        },
        "description": "Live market data from Bitfinex's public v2 API: a trading pair's ticker (bid/ask, last, 24h change and %, volume, high/low); a currency's peer-to-peer funding (margin-lending) market with the Flash Return Rate, best bid/ask lending rates and periods, and the daily rate annualised to an APR; the whole exchange in one call (all trading pairs or all funding currencies); and the live trade tape (recent trades with price, amount, side, time). Live, no key, nothing stored. Distinct from Coinbase, Binance and Kraken venue APIs and from aggregated feeds — this is Bitfinex's own order book, its margin-funding rates and tape.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:07.027Z",
        "request_id": "9eb0170c-bf12-4fb0-b918-053e4aef9480"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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