# Poloniex Exchange API
> Live spot market data from Poloniex, one of the longest-running global crypto exchanges, served straight from its public v2 API with no key and nothing cached. The ticker endpoint returns a market's last price, open, 24-hour high and low, best bid and ask, the spread, 24-hour change, base and quote volume, trade count and mark price. The tickers endpoint returns every market for a quote currency ranked by 24-hour quote volume, so one call surfaces the most-traded pairs on the venue. The markets endpoint lists the tradable pairs with their price and quantity scales and minimum order size. The book endpoint returns live order-book depth — every bid and ask level with price and amount, plus the best bid/ask and spread. The trades endpoint returns the most recent public trades with price, size and taker side, so you can see the tape in real time. Everything is read live from Poloniex on each request, nothing stored. A distinct venue, separate from the other exchange feeds on the marketplace. Ideal for trading bots, price tickers, tape readers, arbitrage scanners and market dashboards. Live, no key. 5 spot endpoints. For candles or perpetuals use an OHLC or derivatives API.

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

## Pricing
- **Free** (Free) — 5,400 calls/Mo, 2 req/s
- **Starter** ($9/Mo) — 93,000 calls/Mo, 6 req/s
- **Pro** ($25/Mo) — 485,000 calls/Mo, 18 req/s
- **Business** ($59/Mo) — 2,920,000 calls/Mo, 45 req/s

## Endpoints

### Market

#### `GET /v1/book` — Live order-book depth

**Parameters:**
- `market` (query, required, string) — Market BASE_QUOTE Example: `BTC_USDT`
- `limit` (query, optional, string) — Levels (snaps to 5/10/20/50/100/150) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/poloniex-api/v1/book?market=BTC_USDT&limit=10"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 62765,
                "amount": 0.016774
            },
            {
                "price": 62766.74,
                "amount": 1.6e-5
            },
            {
                "price": 62766.94,
                "amount": 1.6e-5
            },
            {
                "price": 62767.14,
                "amount": 1.6e-5
            },
            {
                "price": 62767.34,
                "amount": 1.6e-5
            },
            {
                "price": 62767.54,
                "amount": 1.6e-5
            },
            {
                "price": 62767.74,
                "amount": 1.6e-5
            },
            {
                "price": 62767.94,
                "amount": 1.6e-5
            },
            {
                "price": 62768.14,
                "amount": 1.6e-5
            },
            {
                "price": 62782.51,
                "amount": 0.007871
            }
        ],
        "bids": [
            {
                "price": 62747.74,
                "amount": 0.000123
            },
            {
                "price": 62744.6,
                "amount": 0.000123
            },
            {
                "price": 62735.19,
                "amount": 0.005367
            },
            {
                "price": 62732.06,
                "amount": 0.005471
            },
            {
                "price": 62721.67,
                "amount
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/markets` — Tradable pairs with scales and limits

**Parameters:**
- `quote` (query, optional, string) — Filter by quote currency Example: `USDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/poloniex-api/v1/markets?quote=USDT"
```

**Response:**
```json
{
    "data": {
        "count": 861,
        "quote": "USDT",
        "source": "Poloniex",
        "markets": [
            {
                "base": "BTC",
                "quote": "USDT",
                "state": "NORMAL",
                "market": "BTC_USDT",
                "min_amount": 1,
                "price_scale": 2,
                "min_quantity": 1.0e-6,
                "quantity_scale": 6
            },
            {
                "base": "DASH",
                "quote": "USDT",
                "state": "NORMAL",
                "market": "DASH_USDT",
                "min_amount": 1,
                "price_scale": 2,
                "min_quantity": 1.0e-6,
                "quantity_scale": 6
            },
            {
                "base": "LTC",
                "quote": "USDT",
                "state": "NORMAL",
                "market": "LTC_USDT",
                "min_amount": 1,
                "price_scale": 3,
                "min_quantity": 1.0e-6,
                "quantity_scale": 6
            },
            {
                "base": "XLM",
                "quote": "USDT",
                "state": "NORMAL",
                "market": "XLM_USDT",
                "min_amount": 1,
                "price_scale": 4,
                "min_quantity": 0.0001,
                "quantity_scale": 4
            },
            {
                "base": "XMR",
                "quote": "USDT",
                "state": "NORMAL",
                "market": "XMR_USDT
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/ticker` — Ticker for one market

**Parameters:**
- `market` (query, required, string) — Market BASE_QUOTE Example: `BTC_USDT`
- `symbol` (query, optional, string) — Base coin (alternative to market) Example: `BTC`
- `quote` (query, optional, string) — Quote currency for symbol Example: `USDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/poloniex-api/v1/ticker?market=BTC_USDT&symbol=BTC&quote=USDT"
```

**Response:**
```json
{
    "data": {
        "ask": 62765,
        "bid": 62747.74,
        "base": "BTC",
        "last": 62744.2,
        "quote": "USDT",
        "market": "BTC_USDT",
        "source": "Poloniex",
        "spread": 17.26,
        "low_24h": 60750.41,
        "high_24h": 63016.91,
        "open_24h": 61690.89,
        "timestamp": 1781164140118,
        "mark_price": 62728.22,
        "trade_count": 239876,
        "change_24h_pct": 1.71,
        "base_volume_24h": 4724.30371,
        "quote_volume_24h": 292733593.08
    },
    "meta": {
        "timestamp": "2026-06-11T07:49:19.118Z",
        "request_id": "d09ec5f7-db28-48b2-a4b1-6087b112e1ba"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

#### `GET /v1/tickers` — All markets for a quote by volume

**Parameters:**
- `quote` (query, optional, string) — Quote currency (default USDT) Example: `USDT`
- `limit` (query, optional, string) — Max markets (default 50) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/poloniex-api/v1/tickers?quote=USDT&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "quote": "USDT",
        "source": "Poloniex",
        "tickers": [
            {
                "ask": 62765,
                "bid": 62747.74,
                "base": "BTC",
                "last": 62744.2,
                "quote": "USDT",
                "market": "BTC_USDT",
                "spread": 17.26,
                "low_24h": 60750.41,
                "high_24h": 63016.91,
                "open_24h": 61690.89,
                "timestamp": 1781164140798,
                "mark_price": 62728.22,
                "trade_count": 239876,
                "change_24h_pct": 1.71,
                "base_volume_24h": 4724.30371,
                "quote_volume_24h": 292733593.08
            },
            {
                "ask": 1654.54,
                "bid": 1654.53,
                "base": "ETH",
                "last": 1654.01,
                "quote": "USDT",
                "market": "ETH_USDT",
                "spread": 0.01,
                "low_24h": 1604.44,
                "high_24h": 1666.22,
                "open_24h": 1640.26,
                "timestamp": 1781164156845,
                "mark_price": 1654.27,
                "trade_count": 117160,
                "change_24h_pct": 0.84,
                "base_volume_24h": 79454.037733,
                "quote_volume_24h": 129915319.51
            },
            {
                "ask": 418.47,
                "bid": 414.46,
                "base": "ZEC",
                "l
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/trades` — Recent public trades

**Parameters:**
- `market` (query, required, string) — Market BASE_QUOTE Example: `BTC_USDT`
- `limit` (query, optional, string) — Max trades (default 25) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/poloniex-api/v1/trades?market=BTC_USDT&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "market": "BTC_USDT",
        "source": "Poloniex",
        "trades": [
            {
                "id": "218534570",
                "side": "SELL",
                "price": 62761.54,
                "value": 1806.21435966,
                "amount": 0.028779,
                "timestamp": 1781164159224
            },
            {
                "id": "218534569",
                "side": "BUY",
                "price": 62761.54,
                "value": 2530.04320048,
                "amount": 0.040312,
                "timestamp": 1781164159224
            },
            {
                "id": "218534568",
                "side": "BUY",
                "price": 62750.73,
                "value": 2599.95099609,
                "amount": 0.041433,
                "timestamp": 1781164157780
            },
            {
                "id": "218534567",
                "side": "BUY",
                "price": 62750.73,
                "value": 2599.95099609,
                "amount": 0.041433,
                "timestamp": 1781164157780
            },
            {
                "id": "218534566",
                "side": "BUY",
                "price": 62757.51,
                "value": 938.91510711,
                "amount": 0.014961,
                "timestamp": 1781164154429
            },
            {
                "id": "218534565",
                "side": "BUY",
                "price": 62757.51,
                "value"
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Markets are BASE_QUOTE (e.g. BTC_USDT). change_24h_pct is the 24h change; quote_volume_24h is in the quote currency. Book limit snaps to 5/10/20/50/100/150.",
        "source": "Poloniex API (api.poloniex.com, live)",
        "service": "poloniex-api",
        "endpoints": {
            "GET /v1/book": "Live order-book depth — best bid/ask and spread (market=BTC_USDT, limit=10).",
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "Ticker for one market (market=BTC_USDT or symbol=BTC&quote=USDT).",
            "GET /v1/trades": "Recent public trades with price, size and taker side (market=BTC_USDT, limit=25).",
            "GET /v1/markets": "Tradable pairs with scales and minimum order size (quote=USDT optional).",
            "GET /v1/tickers": "All markets for a quote ranked by 24h quote volume (quote=USDT, limit=50)."
        },
        "description": "Live spot market data from Poloniex, one of the longest-running global crypto exchanges. The ticker endpoint returns a market's last price, open, 24h high/low, best bid/ask, 24h change, base/quote volume, trade count and mark price; the tickers endpoint ranks every market for a quote currency by 24h quote volume; the markets endpoint lists tradable pairs with scales and minimum order size; the book endpoint returns live order-book depth; the trades endpoint returns recent public trades with price, size and taker side. Live, no key, nothing stored. A distinct venue,
…(truncated, see openapi.json for full schema)
```


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