# CoinPaprika Crypto Market Data API
> Live crypto market data from CoinPaprika, with no key. Get the global market snapshot (total market cap, 24h volume, Bitcoin dominance, number of coins); a ranked ticker list with price, market cap, 24h volume and multi-window percentage changes; a single-coin ticker by symbol or id; and a coin's historical daily price/volume/market-cap series. Symbols are accepted as a plain ticker (BTC) or a CoinPaprika id (btc-bitcoin) and resolved automatically. A distinct market-data provider covering 12,000+ coins — ideal for dashboards, screeners and portfolio trackers.

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

## Pricing
- **Free** (Free) — 1,660 calls/Mo, 3 req/s
- **Basic** ($13/Mo) — 48,500 calls/Mo, 8 req/s
- **Pro** ($39/Mo) — 198,000 calls/Mo, 19 req/s
- **Business** ($82/Mo) — 818,000 calls/Mo, 47 req/s

## Endpoints

### Market

#### `GET /v1/coin` — Single-coin ticker by symbol or id

**Parameters:**
- `symbol` (query, required, string) — Ticker or CoinPaprika id Example: `BTC`

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

**Response:**
```json
{
    "data": {
        "id": "btc-bitcoin",
        "name": "Bitcoin",
        "rank": 1,
        "symbol": "BTC",
        "ath_date": "2025-10-06T19:00:40Z",
        "ath_price": 126173.1777846797,
        "price_usd": 65934.87345802576,
        "max_supply": 21000000,
        "last_updated": "2026-06-15T11:14:15Z",
        "total_supply": 20043038,
        "market_cap_usd": 1321535569853,
        "volume_24h_usd": 24902579482.423485,
        "percent_from_ath": -47.77,
        "percent_change_1h": 0.4000000059604645,
        "percent_change_7d": 4.71999979019165,
        "percent_change_24h": 2.2899999618530273,
        "percent_change_30d": 0
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:45.183Z",
        "request_id": "329c58fc-64d8-4e19-9b05-baa0750b712e"
    },
    "status": "ok",
    "message": "Coin retrieved successfully",
    "success": true
}
```

#### `GET /v1/global` — Global market snapshot

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

**Response:**
```json
{
    "data": {
        "last_updated": 1781522005,
        "market_cap_usd": 2356484862085,
        "volume_24h_usd": 116602877350,
        "market_cap_change_24h": 2.37,
        "volume_24h_change_24h": 57.12,
        "cryptocurrencies_number": 13147,
        "bitcoin_dominance_percent": 56.04
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:45.295Z",
        "request_id": "6a39432b-fbef-4cb6-99d7-1376fb40c5c2"
    },
    "status": "ok",
    "message": "Global market retrieved successfully",
    "success": true
}
```

#### `GET /v1/historical` — Daily historical price/volume/market-cap series

**Parameters:**
- `symbol` (query, required, string) — Ticker or CoinPaprika id Example: `ETH`
- `interval` (query, optional, string) — Interval (1h,6h,12h,1d,7d,30d) Example: `1d`
- `start` (query, optional, string) — Start date YYYY-MM-DD (defaults to 14 days ago)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/coinpaprika-api/v1/historical?symbol=ETH&interval=1d"
```

**Response:**
```json
{
    "data": {
        "id": "eth-ethereum",
        "count": 15,
        "start": "2026-06-01",
        "points": [
            {
                "price_usd": 1989.5,
                "timestamp": "2026-06-01T00:00:00Z",
                "market_cap_usd": 239588514695,
                "volume_24h_usd": 10632513351
            },
            {
                "price_usd": 1952.49,
                "timestamp": "2026-06-02T00:00:00Z",
                "market_cap_usd": 235131407321,
                "volume_24h_usd": 14290367516
            },
            {
                "price_usd": 1849.39,
                "timestamp": "2026-06-03T00:00:00Z",
                "market_cap_usd": 222714876598,
                "volume_24h_usd": 19993365650
            },
            {
                "price_usd": 1773.29,
                "timestamp": "2026-06-04T00:00:00Z",
                "market_cap_usd": 213550354608,
                "volume_24h_usd": 21807734728
            },
            {
                "price_usd": 1652.26,
                "timestamp": "2026-06-05T00:00:00Z",
                "market_cap_usd": 198975681606,
                "volume_24h_usd": 23191981219
            },
            {
                "price_usd": 1563.52,
                "timestamp": "2026-06-06T00:00:00Z",
                "market_cap_usd": 188288807673,
                "volume_24h_usd": 25491075686
            },
            {
                "price_usd": 1619.43,
                "timestamp": "2026-06-07T00:00:
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/tickers` — Ranked ticker list with price, market cap & changes

**Parameters:**
- `limit` (query, optional, string) — Number of coins (1-250) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/coinpaprika-api/v1/tickers?limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "tickers": [
            {
                "id": "btc-bitcoin",
                "name": "Bitcoin",
                "rank": 1,
                "symbol": "BTC",
                "ath_date": "2025-10-06T19:00:40Z",
                "ath_price": 126173.1777846797,
                "price_usd": 65903.54325140818,
                "max_supply": 21000000,
                "last_updated": "2026-06-15T11:15:16Z",
                "total_supply": 20043038,
                "market_cap_usd": 1320907617143,
                "volume_24h_usd": 24882719291.158867,
                "percent_from_ath": -47.77,
                "percent_change_1h": 0.33000001311302185,
                "percent_change_7d": 4.769999980926514,
                "percent_change_24h": 2.25,
                "percent_change_30d": 0
            },
            {
                "id": "eth-ethereum",
                "name": "Ethereum",
                "rank": 2,
                "symbol": "ETH",
                "ath_date": "2025-08-24T19:24:38Z",
                "ath_price": 4946.229669645212,
                "price_usd": 1739.8551168526421,
                "max_supply": 0,
                "last_updated": "2026-06-15T11:15:16Z",
                "total_supply": 120232214,
                "market_cap_usd": 209524342096,
                "volume_24h_usd": 9019392563.314157,
                "percent_from_ath": -64.84,
                "percent_change_1h": 0.9200000166893005,
                "pe
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Provider metadata & endpoint guide

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

**Response:**
```json
{
    "data": {
        "note": "Coins accepted by ticker (BTC) or CoinPaprika id (btc-bitcoin); on symbol collision the highest-ranked coin wins.",
        "source": "CoinPaprika public REST (api.coinpaprika.com/v1), keyless",
        "examples": {
            "coin": "/v1/coin?symbol=BTC",
            "global": "/v1/global",
            "tickers": "/v1/tickers?limit=25",
            "historical": "/v1/historical?symbol=ETH&interval=1d"
        },
        "provider": "CoinPaprika",
        "endpoints": {
            "/v1/coin": "single-coin ticker by symbol or id (symbol=BTC)",
            "/v1/global": "global market snapshot (total cap, 24h volume, BTC dominance, coin count)",
            "/v1/tickers": "ranked ticker list with price, market cap, volume & % changes (limit)",
            "/v1/historical": "daily historical price/volume/market-cap series (symbol, start, interval)"
        },
        "cache_ttl_ms": 30000
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:45.756Z",
        "request_id": "934d856e-cfea-4fee-b26e-fa21d2a91aed"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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