# Crypto API
> Live cryptocurrency market data: prices, top coins & markets, price/OHLC charts, historical snapshots, trending coins, global stats, exchanges and categories.

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

## Pricing
- **Free** (Free) — 5,000 calls/Mo, 2 req/s
- **Basic** ($29/Mo) — 50,000 calls/Mo, 15 req/s
- **Pro** ($99/Mo) — 300,000 calls/Mo, 40 req/s
- **Mega** ($299/Mo) — 1,500,000 calls/Mo, 100 req/s

## Endpoints

### Markets

#### `GET /v1/categories` — Coin categories

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

**Response:**
```json
{
    "data": {
        "count": 712,
        "categories": [
            {
                "id": "smart-contract-platform",
                "name": "Smart Contract Platform",
                "market_cap": 2104524603211.8145,
                "volume_24h": 64483344313.1523,
                "top_3_coins": [
                    "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png",
                    "https://coin-images.coingecko.com/coins/images/279/small/ethereum.png",
                    "https://coin-images.coingecko.com/coins/images/825/small/bnb-icon2_2x.png"
                ],
                "market_cap_change_24h": -0.6007025937269063
            },
            {
                "id": "layer-1",
                "name": "Layer 1 (L1)",
                "market_cap": 2077970633252.2668,
                "volume_24h": 61455730923.07344,
                "top_3_coins": [
                    "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png",
                    "https://coin-images.coingecko.com/coins/images/279/small/ethereum.png",
                    "https://coin-images.coingecko.com/coins/images/825/small/bnb-icon2_2x.png"
                ],
                "market_cap_change_24h": -0.6921758146805653
            },
            {
                "id": "proof-of-work-pow",
                "name": "Proof of Work (PoW)",
                "market_cap": 1524210201030.2856,
                "volume_24h": 38059589684.312904,
                "top_3
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/coins/markets` — Top coins with market data

**Parameters:**
- `vs_currency` (query, optional, string) — Fiat currency Example: `usd`
- `per_page` (query, optional, string) — Results per page (1-250) Example: `50`
- `page` (query, optional, string) — Page Example: `1`
- `order` (query, optional, string) — Sort order Example: `market_cap_desc`
- `ids` (query, optional, string) — Comma-separated coin ids

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crypto-api/v1/coins/markets?vs_currency=usd&per_page=50&page=1&order=market_cap_desc"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "coins": [
            {
                "id": "bitcoin",
                "ath": 126080,
                "atl": 67.81,
                "name": "Bitcoin",
                "rank": 1,
                "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
                "price": 73542,
                "symbol": "btc",
                "low_24h": 72515,
                "ath_date": "2025-10-06T18:57:42.558Z",
                "atl_date": "2013-07-06T00:00:00.000Z",
                "high_24h": 74214,
                "market_cap": 1475555054053,
                "max_supply": 21000000,
                "volume_24h": 36196307412,
                "last_updated": "2026-05-29T18:47:57.479Z",
                "total_supply": 20036221,
                "price_change_24h": 29.02,
                "circulating_supply": 20036203,
                "ath_change_percentage": -41.66999,
                "fully_diluted_valuation": 1475556379653,
                "price_change_percentage_24h": 0.03947,
                "market_cap_change_percentage_24h": 0.19888
            },
            {
                "id": "ethereum",
                "ath": 4946.05,
                "atl": 0.432979,
                "name": "Ethereum",
                "rank": 2,
                "image": "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628",
                "price": 2017.36,
                "symbol": "eth",
          
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/global` — Global crypto market stats

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

**Response:**
```json
{
    "data": {
        "markets": 1477,
        "updated_at": 1780080043,
        "total_volume_usd": 88461243221.62668,
        "total_market_cap_usd": 2563361099938.048,
        "market_cap_percentage": {
            "bnb": 3.3731791309329733,
            "btc": 57.622951404271916,
            "eth": 9.518435663402235,
            "sol": 1.8628703211206563,
            "trx": 1.274687255141869,
            "xrp": 3.2011221633886193,
            "usdc": 2.9731395305189294,
            "usdt": 7.386264008240029,
            "steth": 0.7011254748466603,
            "figr_heloc": 0.7356149109943756
        },
        "active_cryptocurrencies": 17410,
        "market_cap_change_percentage_24h_usd": 0.16331819545173515
    },
    "meta": {
        "timestamp": "2026-05-29T18:47:59.251Z",
        "request_id": "7deba77d-366c-40cc-817f-936f317f2adb"
    },
    "status": "ok",
    "message": "Global stats retrieved successfully",
    "success": true
}
```

### Coins

#### `GET /v1/coins/detail` — Full coin detail

**Parameters:**
- `id` (query, required, string) — Coin id Example: `bitcoin`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crypto-api/v1/coins/detail?id=bitcoin"
```

**Response:**
```json
{
    "data": {
        "id": "bitcoin",
        "name": "Bitcoin",
        "rank": 1,
        "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
        "symbol": "btc",
        "homepage": "http://www.bitcoin.org",
        "categories": [
            "Smart Contract Platform",
            "Layer 1 (L1)",
            "FTX Holdings",
            "Proof of Work (PoW)",
            "Bitcoin Ecosystem",
            "GMCI 30 Index",
            "GMCI Index",
            "Coinbase 50 Index"
        ],
        "description": "Bitcoin is the world's first decentralized cryptocurrency, created in 2009 by the pseudonymous Satoshi Nakamoto. It enables peer-to-peer electronic cash transactions without intermediaries like banks or governments, operating on a blockchain secured by Proof of Work mining and the SHA-256 cryptographic algorithm. \n\nWith a fixed supply cap of 21 million coins and programmatic halvings every four years that reduce miner rewards, Bitcoin is designed as a deflationary digital asset often called \"digital gold.\" Its value stems from solving the double-spending problem without trusted intermediaries, creating the first truly scarce digital asset with censorship resistance and permissionless access that no government, corporation, or individual can control.\n\nBitcoin operates as a decentralized peer-to-peer network where transactions are recorded on a public ledger called the blockchain, distributed across thousands of compu
…(truncated, see openapi.json for full schema)
```

### Prices

#### `GET /v1/simple/price` — Quick price for ids

**Parameters:**
- `ids` (query, required, string) — Comma-separated coin ids Example: `bitcoin,ethereum`
- `vs_currencies` (query, optional, string) — Comma-separated currencies Example: `usd`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crypto-api/v1/simple/price?ids=bitcoin%2Cethereum&vs_currencies=usd"
```

**Response:**
```json
{
    "data": {
        "prices": {
            "bitcoin": {
                "usd": 73565,
                "usd_24h_vol": 36203166719.91717,
                "usd_24h_change": 0.06993443227068287,
                "usd_market_cap": 1475555054052.5483,
                "last_updated_at": 1780080442
            },
            "ethereum": {
                "usd": 2017.31,
                "usd_24h_vol": 14199350498.351685,
                "usd_24h_change": -0.20959536133032253,
                "usd_market_cap": 243974336263.93015,
                "last_updated_at": 1780080442
            }
        },
        "vs_currencies": "usd"
    },
    "meta": {
        "timestamp": "2026-05-29T18:48:01.061Z",
        "request_id": "a29f1dad-a476-40af-949a-7b2f062101be"
    },
    "status": "ok",
    "message": "Price retrieved successfully",
    "success": true
}
```

### Charts

#### `GET /v1/coins/market-chart` — Price/mcap/volume chart

**Parameters:**
- `id` (query, required, string) — Coin id Example: `bitcoin`
- `days` (query, optional, string) — Days back Example: `7`
- `vs_currency` (query, optional, string) — Currency Example: `usd`
- `interval` (query, optional, string) — Data interval

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crypto-api/v1/coins/market-chart?id=bitcoin&days=7&vs_currency=usd"
```

**Response:**
```json
{
    "data": {
        "id": "bitcoin",
        "days": "7",
        "prices": [
            [
                1779476433943,
                76442.19264835134
            ],
            [
                1779480054825,
                75784.62429980212
            ],
            [
                1779483614646,
                75890.90629208337
            ],
            [
                1779487242236,
                75909.30496418383
            ],
            [
                1779490874868,
                75650.83264919114
            ],
            [
                1779494427144,
                75482.52379955728
            ],
            [
                1779498055005,
                75308.69543704066
            ],
            [
                1779501631482,
                75391.63727313517
            ],
            [
                1779505228357,
                75482.60880877408
            ],
            [
                1779508823630,
                75547.72106173361
            ],
            [
                1779512430210,
                75432.26111879738
            ],
            [
                1779516043618,
                75390.38033389076
            ],
            [
                1779519666509,
                75315.48120471499
            ],
            [
                1779523215397,
                74501.44624467158
            ],
            [
                1779526817082,
                74594.266948548
            ],
          
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/coins/ohlc` — OHLC candlesticks

**Parameters:**
- `id` (query, required, string) — Coin id Example: `bitcoin`
- `days` (query, optional, string) — Days back Example: `7`
- `vs_currency` (query, optional, string) — Currency Example: `usd`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crypto-api/v1/coins/ohlc?id=bitcoin&days=7&vs_currency=usd"
```

**Response:**
```json
{
    "data": {
        "id": "bitcoin",
        "days": "7",
        "count": 42,
        "candles": [
            {
                "low": 75680,
                "high": 76918,
                "open": 76798,
                "time": 1779480000000,
                "close": 75785
            },
            {
                "low": 75419,
                "high": 75979,
                "open": 75825,
                "time": 1779494400000,
                "close": 75483
            },
            {
                "low": 75201,
                "high": 75570,
                "open": 75501,
                "time": 1779508800000,
                "close": 75548
            },
            {
                "low": 74478,
                "high": 75555,
                "open": 75540,
                "time": 1779523200000,
                "close": 74501
            },
            {
                "low": 74344,
                "high": 74772,
                "open": 74532,
                "time": 1779537600000,
                "close": 74727
            },
            {
                "low": 74589,
                "high": 75543,
                "open": 74678,
                "time": 1779552000000,
                "close": 75429
            },
            {
                "low": 75344,
                "high": 75859,
                "open": 75484,
                "time": 1779566400000,
                "close": 75859
            },
            {
                "low": 75873,
               
…(truncated, see openapi.json for full schema)
```

### Discovery

#### `GET /v1/search` — Search coins/exchanges/categories

**Parameters:**
- `query` (query, required, string) — Search text Example: `solana`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crypto-api/v1/search?query=solana"
```

**Response:**
```json
{
    "data": {
        "coins": [
            {
                "id": "solana",
                "name": "Solana",
                "rank": 7,
                "thumb": "https://coin-images.coingecko.com/coins/images/4128/thumb/solana.png",
                "symbol": "SOL"
            },
            {
                "id": "solana-name-service",
                "name": "Solana Name Service",
                "rank": 2251,
                "thumb": "https://coin-images.coingecko.com/coins/images/55691/thumb/0cxkA759_400x400.jpg",
                "symbol": "SNS"
            },
            {
                "id": "green-satoshi-token",
                "name": "STEPN Green Satoshi Token on Solana",
                "rank": 2456,
                "thumb": "https://coin-images.coingecko.com/coins/images/21841/thumb/gst.png",
                "symbol": "GST-SOL"
            },
            {
                "id": "harambe-2",
                "name": "Harambe on Solana",
                "rank": 3028,
                "thumb": "https://coin-images.coingecko.com/coins/images/34668/thumb/haram_%281%29.jpg",
                "symbol": "HARAMBE"
            },
            {
                "id": "play-solana-token",
                "name": "Play Solana Token",
                "rank": 3084,
                "thumb": "https://coin-images.coingecko.com/coins/images/70610/thumb/_PLAY_200x200.png",
                "symbol": "PLAY"
            },
            {
                "id": "pepecoin-on-solana",
  
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/trending` — Trending coins (24h)

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

**Response:**
```json
{
    "data": {
        "coins": [
            {
                "id": "bonk",
                "name": "Bonk",
                "rank": 107,
                "thumb": "https://coin-images.coingecko.com/coins/images/28600/standard/bonk.jpg?1696527587",
                "symbol": "BONK",
                "price_btc": 7.443150764182561e-11
            },
            {
                "id": "aptos",
                "name": "Aptos",
                "rank": 82,
                "thumb": "https://coin-images.coingecko.com/coins/images/26455/standard/Aptos-Network-Symbol-Black-RGB-1x.png?1761789140",
                "symbol": "APT",
                "price_btc": 1.275655420808264e-5
            },
            {
                "id": "hyperliquid",
                "name": "Hyperliquid",
                "rank": 11,
                "thumb": "https://coin-images.coingecko.com/coins/images/50882/standard/hyperliquid.jpg?1729431300",
                "symbol": "HYPE",
                "price_btc": 0.0008947849403712949
            },
            {
                "id": "pudgy-penguins",
                "name": "Pudgy Penguins",
                "rank": 105,
                "thumb": "https://coin-images.coingecko.com/coins/images/52622/standard/PUDGY_PENGUINS_PENGU_PFP.png?1733809110",
                "symbol": "PENGU",
                "price_btc": 1.0729187995115414e-7
            },
            {
                "id": "lighter",
                "name": "Lighter",
                "rank": 138,
     
…(truncated, see openapi.json for full schema)
```

### Exchanges

#### `GET /v1/exchanges` — Top exchanges

**Parameters:**
- `per_page` (query, optional, string) — Per page Example: `50`
- `page` (query, optional, string) — Page Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/crypto-api/v1/exchanges?per_page=50&page=1"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "count": 50,
        "per_page": 50,
        "exchanges": [
            {
                "id": "gdax",
                "url": "https://www.coinbase.com/",
                "name": "Coinbase Exchange",
                "image": "https://coin-images.coingecko.com/markets/images/23/small/Coinbase_Coin_Primary.png?1706864258",
                "country": "United States",
                "trust_score": 10,
                "trust_score_rank": 1,
                "year_established": 2012,
                "trade_volume_24h_btc": 25836.413340101
            },
            {
                "id": "binance",
                "url": "https://www.binance.com/",
                "name": "Binance",
                "image": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274",
                "country": "Cayman Islands",
                "trust_score": 10,
                "trust_score_rank": 2,
                "year_established": 2017,
                "trade_volume_24h_btc": 117381.41005551393
            },
            {
                "id": "kraken",
                "url": "https://www.kraken.com/",
                "name": "Kraken",
                "image": "https://coin-images.coingecko.com/markets/images/29/small/kraken.jpg?1706864265",
                "country": "United States",
                "trust_score": 10,
                "trust_score_rank": 3,
                "year_established": 2011,
                "trade_volu
…(truncated, see openapi.json for full schema)
```


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