# 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"
```

#### `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"
```

#### `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"
```

#### `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"
```

#### `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"
```

### Meta

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

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


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