# Coinstore Market Data API
> Real-time spot market data from the Coinstore crypto exchange across 480+ trading pairs. Pull 24-hour tickers for all symbols at once or one at a time (last price, 24h open, high and low, best bid and ask with their sizes, percentage change, base and quote volume); read a lightweight latest-price feed for every actively traded pair; inspect full order-book depth with best bid, best ask, computed spread and the last traded price; and stream the most recent trades with price, size and taker side. Symbols are plain pairs such as BTCUSDT or ETHUSDT. A short protective cache keeps responses fast while staying within a few seconds of the exchange. Distinct from our perpetual-futures exchange feeds (BitMEX, BloFin, Bitunix, Phemex, WEEX): this surfaces the Coinstore spot order book and ticker tape specifically.

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

## Pricing
- **Free** (Free) — 1,660 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 48,700 calls/Mo, 8 req/s
- **Pro** ($33/Mo) — 203,000 calls/Mo, 20 req/s
- **Scale** ($75/Mo) — 838,000 calls/Mo, 45 req/s

## Endpoints

### Tickers

#### `GET /v1/tickers` — 24h tickers for all symbols or one symbol

**Parameters:**
- `symbol` (query, optional, string) — Single symbol; omit for all Example: `BTCUSDT`
- `quote` (query, optional, string) — Filter all-tickers by quote currency
- `limit` (query, optional, string) — Max rows when listing all

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

**Response:**
```json
{
    "data": {
        "ask": 65914.56,
        "bid": 65914.28,
        "low": 63651.2,
        "high": 65989.72,
        "last": 65914.53,
        "open": 64512.8,
        "symbol": "BTCUSDT",
        "ask_size": 0.003,
        "bid_size": 3.768787,
        "change_pct_24h": 2.1728,
        "base_volume_24h": 13610124.00335853,
        "quote_volume_24h": 209.260881
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:11.707Z",
        "request_id": "e9ed2a22-aace-4724-afaa-73cef39f4730"
    },
    "status": "ok",
    "message": "Tickers retrieved successfully",
    "success": true
}
```

### Prices

#### `GET /v1/prices` — Latest price for all symbols or one symbol

**Parameters:**
- `symbol` (query, optional, string) — Single symbol; omit for all Example: `ETHUSDT`

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

**Response:**
```json
{
    "data": {
        "price": 1740.75,
        "symbol": "ETHUSDT"
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:12.335Z",
        "request_id": "239ad70d-af07-4891-8ada-d03cc7a20136"
    },
    "status": "ok",
    "message": "Prices retrieved successfully",
    "success": true
}
```

### Order Book

#### `GET /v1/orderbook` — Order-book depth for a symbol

**Parameters:**
- `symbol` (query, required, string) — Market symbol Example: `BTCUSDT`
- `limit` (query, optional, string) — Levels per side (1-100)

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

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "size": 0.003,
                "price": 65914.54
            },
            {
                "size": 0.012,
                "price": 65914.78
            },
            {
                "size": 0.005,
                "price": 65915.2
            },
            {
                "size": 0.003,
                "price": 65915.67
            },
            {
                "size": 0.003,
                "price": 65916.06
            }
        ],
        "bids": [
            {
                "size": 1.208961,
                "price": 65914.28
            },
            {
                "size": 0.035156,
                "price": 65913.68
            },
            {
                "size": 0.002928,
                "price": 65913.33
            },
            {
                "size": 0.02336,
                "price": 65912.84
            },
            {
                "size": 0.004957,
                "price": 65912.41
            }
        ],
        "depth": {
            "asks": 5,
            "bids": 5
        },
        "spread": 0.26,
        "symbol": "BTCUSDT",
        "best_ask": 65914.54,
        "best_bid": 65914.28,
        "last_price": 65914.54
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:12.712Z",
        "request_id": "83ac44f8-5969-4d77-ac85-cc08d4b0cda8"
    },
    "status": "ok",
    "message": "Order book retrieved successfully",
    "success": true
}
```

### Trades

#### `GET /v1/trades` — Recent trades for a symbol

**Parameters:**
- `symbol` (query, required, string) — Market symbol Example: `BTCUSDT`
- `limit` (query, optional, string) — Max trades (1-100)

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

**Response:**
```json
{
    "data": {
        "count": 50,
        "symbol": "BTCUSDT",
        "trades": [
            {
                "side": "buy",
                "time": 1781522112000,
                "price": 65937.02,
                "volume": 0.000987,
                "trade_id": "235694203"
            },
            {
                "side": "buy",
                "time": 1781522112000,
                "price": 65937.04,
                "volume": 3.0e-6,
                "trade_id": "235694202"
            },
            {
                "side": "buy",
                "time": 1781522112000,
                "price": 65933.54,
                "volume": 0.000259,
                "trade_id": "235694201"
            },
            {
                "side": "buy",
                "time": 1781522112000,
                "price": 65914.45,
                "volume": 3.0e-6,
                "trade_id": "235694200"
            },
            {
                "side": "sell",
                "time": 1781522112000,
                "price": 65914.4,
                "volume": 1.3e-5,
                "trade_id": "235694199"
            },
            {
                "side": "buy",
                "time": 1781522111000,
                "price": 65914.46,
                "volume": 0.005987,
                "trade_id": "235694198"
            },
            {
                "side": "buy",
                "time": 1781522111000,
                "price": 65914.54,
                "volume": 3.0e-6,
       
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "name": "Coinstore Market Data API",
        "source": "Coinstore public REST (api.coinstore.com)",
        "endpoints": [
            {
                "path": "/v1/tickers",
                "description": "24h tickers for all symbols, or one via ?symbol="
            },
            {
                "path": "/v1/prices",
                "description": "Latest price for all symbols, or one via ?symbol="
            },
            {
                "path": "/v1/orderbook",
                "description": "Order-book depth for a symbol (?symbol=BTCUSDT)"
            },
            {
                "path": "/v1/trades",
                "description": "Recent trades for a symbol (?symbol=BTCUSDT)"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "disclaimer": "Unofficial proxy of public Coinstore endpoints. Not affiliated with Coinstore. Market data only; no guarantees of accuracy or availability.",
        "description": "Public spot market data from the Coinstore exchange: 24h tickers, latest prices, order-book depth and recent trades across 480+ spot trading pairs.",
        "market_type": "spot"
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:13.192Z",
        "request_id": "cde123f0-edb0-4aa2-9bd5-e2d4d48500ae"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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