# CoinLore Crypto Market Data API
> Live crypto market data from CoinLore, with no key. Get the global market snapshot (total market cap, 24h volume, BTC/ETH dominance, coin & market counts); a paginated ticker list with price, market cap, volume and multi-window percentage changes; a single-coin ticker by symbol or id; the markets/exchanges a coin trades on with pair prices and volumes; and the ranked exchange list with volumes and pair counts. Symbols are accepted as a plain ticker (BTC) or a CoinLore numeric id and resolved automatically. A distinct market-data provider covering 14,000+ coins and 300+ exchanges.

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

## Pricing
- **Free** (Free) — 1,720 calls/Mo, 3 req/s
- **Basic** ($13/Mo) — 49,800 calls/Mo, 8 req/s
- **Pro** ($36/Mo) — 204,000 calls/Mo, 19 req/s
- **Business** ($77/Mo) — 838,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 CoinLore id Example: `BTC`

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

**Response:**
```json
{
    "data": {
        "id": "90",
        "name": "Bitcoin",
        "rank": 1,
        "symbol": "BTC",
        "price_btc": 1,
        "price_usd": 65963.55,
        "max_supply": 21000000,
        "total_supply": 19970852,
        "market_cap_usd": 1317348382886.9,
        "volume_24h_usd": 22130849020.74018,
        "percent_change_1h": 0.4,
        "percent_change_7d": 4.95,
        "circulating_supply": 19970852,
        "percent_change_24h": 2.23
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:44.314Z",
        "request_id": "d6555420-0856-4d47-940d-1bfb9c5e9c0c"
    },
    "status": "ok",
    "message": "Coin retrieved successfully",
    "success": true
}
```

#### `GET /v1/exchanges` — Ranked exchange list, or one exchange's pairs

**Parameters:**
- `id` (query, optional, string) — Exchange id (optional)
- `limit` (query, optional, string) — Number of exchanges (1-200) Example: `50`

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

**Response:**
```json
{
    "data": {
        "count": 50,
        "exchanges": [
            {
                "id": "5",
                "url": "https://www.binance.com",
                "name": "Binance",
                "country": "Japan",
                "volume_usd": 5383844360.183821,
                "active_pairs": 966
            },
            {
                "id": "9",
                "url": "https://www.bitfinex.com",
                "name": "Bitfinex",
                "country": "Hong Kong",
                "volume_usd": 391424641.0659047,
                "active_pairs": 101
            },
            {
                "id": "10",
                "url": "https://bitflyer.com/",
                "name": "bitFlyer",
                "country": "Japan",
                "volume_usd": 22048886.73806642,
                "active_pairs": 3
            },
            {
                "id": "14",
                "url": "https://www.bitmex.com/",
                "name": "BitMEX",
                "country": "Seychelles",
                "volume_usd": 4611.9731,
                "active_pairs": 2
            },
            {
                "id": "15",
                "url": "https://bitso.com",
                "name": "Bitso",
                "country": "Mexico",
                "volume_usd": 1464764.7994675892,
                "active_pairs": 24
            },
            {
                "id": "16",
                "url": "https://www.bitstamp.net/",
                "name": "Bitstamp",
       
…(truncated, see openapi.json for full schema)
```

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

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

**Response:**
```json
{
    "data": {
        "coins_count": 14471,
        "active_markets": 31552,
        "market_cap_usd": 2259477600091.774,
        "volume_24h_usd": 96352942330.02693,
        "avg_change_percent": 0.27,
        "btc_dominance_percent": 58.3,
        "eth_dominance_percent": 9.42,
        "volume_change_percent": 49.05,
        "market_cap_change_percent": 2.69
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:44.581Z",
        "request_id": "17b30e1e-efeb-4a65-b453-1043e8d20987"
    },
    "status": "ok",
    "message": "Global market retrieved successfully",
    "success": true
}
```

#### `GET /v1/markets` — Markets/exchanges a coin trades on

**Parameters:**
- `symbol` (query, required, string) — Ticker or CoinLore id Example: `ETH`
- `limit` (query, optional, string) — Number of markets (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/coinlore-api/v1/markets?symbol=ETH&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "coin_id": "80",
        "markets": [
            {
                "base": "ETH",
                "time": 1781521567,
                "price": 1735.73,
                "quote": "USDT",
                "volume": 672472.304,
                "exchange": "Bitunix",
                "price_usd": 1735.73,
                "volume_usd": 1167230352.2219
            },
            {
                "base": "ETH",
                "time": 1781521567,
                "price": 1744.3,
                "quote": "USDT",
                "volume": 279347.499,
                "exchange": "AscendEX (BitMax)",
                "price_usd": 1744.3,
                "volume_usd": 487265842.5057
            },
            {
                "base": "ETH",
                "time": 1781521569,
                "price": 1734.29,
                "quote": "USDT",
                "volume": 270437.7654,
                "exchange": "Binance",
                "price_usd": 1734.29,
                "volume_usd": 469017512.15557
            },
            {
                "base": "ETH",
                "time": 1781521505,
                "price": 1737.21,
                "quote": "USDT",
                "volume": 245525.4968,
                "exchange": "Tapbit",
                "price_usd": 1737.21,
                "volume_usd": 426529348.29593
            },
            {
                "base": "ETH",
                "time": 1781521502,
                "price": 1737.21
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/tickers` — Paginated ticker list

**Parameters:**
- `start` (query, optional, string) — Offset Example: `0`
- `limit` (query, optional, string) — Number of coins (1-100) Example: `25`

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

**Response:**
```json
{
    "data": {
        "count": 25,
        "limit": 25,
        "start": 0,
        "tickers": [
            {
                "id": "90",
                "name": "Bitcoin",
                "rank": 1,
                "symbol": "BTC",
                "price_btc": 1,
                "price_usd": 65963.55,
                "max_supply": 21000000,
                "total_supply": 19970852,
                "market_cap_usd": 1317348382886.9,
                "volume_24h_usd": 22130849020.74018,
                "percent_change_1h": 0.4,
                "percent_change_7d": 4.95,
                "circulating_supply": 19970852,
                "percent_change_24h": 2.23
            },
            {
                "id": "80",
                "name": "Ethereum",
                "rank": 2,
                "symbol": "ETH",
                "price_btc": 0.026376,
                "price_usd": 1739.73,
                "max_supply": null,
                "total_supply": 122374665.71823,
                "market_cap_usd": 212899049841.29,
                "volume_24h_usd": 8842615436.703878,
                "percent_change_1h": 1.06,
                "percent_change_7d": 3.79,
                "circulating_supply": 122374665.72,
                "percent_change_24h": 3.93
            },
            {
                "id": "518",
                "name": "Tether",
                "rank": 3,
                "symbol": "USDT",
                "price_btc": 1.5e-5,
                "price_usd": 1.01,
      
…(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/coinlore-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Coins accepted by ticker (BTC) or CoinLore numeric id (90); the top-100 symbol map resolves common tickers, pass a numeric id for long-tail coins.",
        "source": "CoinLore public REST (api.coinlore.net/api), keyless",
        "examples": {
            "coin": "/v1/coin?symbol=BTC",
            "global": "/v1/global",
            "markets": "/v1/markets?symbol=ETH",
            "tickers": "/v1/tickers?start=0&limit=25",
            "exchanges": "/v1/exchanges?limit=20"
        },
        "provider": "CoinLore",
        "endpoints": {
            "/v1/coin": "single-coin ticker by symbol or id (symbol=BTC)",
            "/v1/global": "global market snapshot (cap, volume, BTC/ETH dominance, coin & market counts)",
            "/v1/markets": "markets/exchanges a coin trades on with pair prices & volumes (symbol, limit)",
            "/v1/tickers": "paginated ticker list with price, market cap, volume & changes (start, limit)",
            "/v1/exchanges": "ranked exchange list, or one exchange's pairs (id optional, limit)"
        },
        "cache_ttl_ms": 30000
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:44.921Z",
        "request_id": "3a5be9c7-86e6-4a44-89ad-77e6e20a27be"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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