# Bitstamp Exchange API
> Live market data straight from Bitstamp's public API — one of the oldest and most established crypto exchanges, founded in 2011 and strong in EUR and GBP pairs alongside USD, exposed as clean JSON with no key and nothing cached. The markets endpoint lists every trading pair with its decimals, minimum order size and trading status. The ticker endpoint returns a pair's full snapshot: last price, best bid and ask, 24-hour open, high and low, the VWAP, the 24-hour percentage change and base volume — BTC/USD around $63,300 and BTC/EUR around €54,900. The tickers endpoint returns that snapshot for every pair on the exchange in a single call, the whole Bitstamp market at once, sortable by 24-hour change or volume. The orderbook endpoint returns the top of the book with the spread. The trades endpoint returns the live trade tape — the most recent executed trades with price, amount, side and time — the raw market activity that aggregated price feeds throw away. The ohlc endpoint returns candles at a step you choose, from one minute to three days. Everything is Bitstamp's live venue data, nothing stored. This is the Bitstamp price, tape and liquidity layer for any trading, charting, arbitrage or market-data app. Distinct from Coinbase, Binance and Kraken venue APIs and from aggregated feeds — this is Bitstamp's own order book, trade tape and EUR/GBP markets. 6 endpoints, no key on our side, real-time.

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

## Pricing
- **Free** (Free) — 5,000 calls/Mo, 5 req/s
- **Starter** ($12/Mo) — 130,000 calls/Mo, 12 req/s
- **Pro** ($32/Mo) — 800,000 calls/Mo, 30 req/s
- **Mega** ($78/Mo) — 4,500,000 calls/Mo, 80 req/s

## Endpoints

### Bitstamp

#### `GET /v1/markets` — All trading pairs

**Parameters:**
- `status` (query, optional, string) — all to include disabled pairs

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

**Response:**
```json
{
    "data": {
        "count": 294,
        "source": "Bitstamp",
        "markets": [
            {
                "name": "AAVE/EUR",
                "pair": "aaveeur",
                "trading": "Enabled",
                "base_decimals": 8,
                "minimum_order": "10.00 EUR",
                "counter_decimals": 2
            },
            {
                "name": "AAVE/USD",
                "pair": "aaveusd",
                "trading": "Enabled",
                "base_decimals": 8,
                "minimum_order": "10.00 USD",
                "counter_decimals": 2
            },
            {
                "name": "ADA/EUR",
                "pair": "adaeur",
                "trading": "Enabled",
                "base_decimals": 8,
                "minimum_order": "10.00000 EUR",
                "counter_decimals": 5
            },
            {
                "name": "ADA/USD",
                "pair": "adausd",
                "trading": "Enabled",
                "base_decimals": 8,
                "minimum_order": "10.00000 USD",
                "counter_decimals": 5
            },
            {
                "name": "AERO/EUR",
                "pair": "aeroeur",
                "trading": "Enabled",
                "base_decimals": 2,
                "minimum_order": "10.00000 EUR",
                "counter_decimals": 5
            },
            {
                "name": "AERO/USD",
                "pair": "aerousd",
                "trading": "Ena
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/ohlc` — OHLC candles

**Parameters:**
- `pair` (query, required, string) — Bitstamp url symbol Example: `ethusd`
- `step` (query, optional, string) — Seconds: 60..259200 Example: `3600`
- `limit` (query, optional, string) — Max candles (default 100) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitstamp-api/v1/ohlc?pair=ethusd&step=3600&limit=50"
```

**Response:**
```json
{
    "data": {
        "pair": "ETHUSD",
        "count": 50,
        "source": "Bitstamp",
        "candles": [
            {
                "iso": "2026-06-07T10:00:00.000Z",
                "low": 1624.43,
                "high": 1634.99,
                "open": 1633.08,
                "time": 1780826400,
                "close": 1625.26,
                "volume": 196.380692
            },
            {
                "iso": "2026-06-07T11:00:00.000Z",
                "low": 1622.11,
                "high": 1633.26,
                "open": 1624.98,
                "time": 1780830000,
                "close": 1629.55,
                "volume": 235.440091
            },
            {
                "iso": "2026-06-07T12:00:00.000Z",
                "low": 1606.45,
                "high": 1630.43,
                "open": 1629.73,
                "time": 1780833600,
                "close": 1619.22,
                "volume": 480.235425
            },
            {
                "iso": "2026-06-07T13:00:00.000Z",
                "low": 1613.13,
                "high": 1622.18,
                "open": 1619.52,
                "time": 1780837200,
                "close": 1617.42,
                "volume": 203.807568
            },
            {
                "iso": "2026-06-07T14:00:00.000Z",
                "low": 1616.41,
                "high": 1639.02,
                "open": 1616.71,
                "time": 1780840800,
                "close": 1627.58,
             
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/orderbook` — Top of order book

**Parameters:**
- `pair` (query, required, string) — Bitstamp url symbol Example: `btcusd`
- `depth` (query, optional, string) — Levels per side (max 100) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitstamp-api/v1/orderbook?pair=btcusd&depth=10"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 62531.32,
                "amount": 0.32995768
            },
            {
                "price": 62532.99,
                "amount": 0.5
            },
            {
                "price": 62533.07,
                "amount": 0.1094123
            },
            {
                "price": 62533.08,
                "amount": 2.16300233
            },
            {
                "price": 62533.61,
                "amount": 0.07995701
            },
            {
                "price": 62534.27,
                "amount": 0.23983791
            },
            {
                "price": 62535.29,
                "amount": 0.07995486
            },
            {
                "price": 62536.28,
                "amount": 0.01599134
            },
            {
                "price": 62537.4,
                "amount": 0.23983791
            },
            {
                "price": 62537.94,
                "amount": 0.39975734
            }
        ],
        "bids": [
            {
                "price": 62531.31,
                "amount": 0.75391987
            },
            {
                "price": 62530.01,
                "amount": 0.33542449
            },
            {
                "price": 62530,
                "amount": 0.0799616
            },
            {
                "price": 62529.94,
                "amount": 0.07994664
            },
            {
                "price"
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/ticker` — Full ticker for a pair

**Parameters:**
- `pair` (query, required, string) — Bitstamp url symbol (e.g. btcusd, btceur) Example: `btcusd`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitstamp-api/v1/ticker?pair=btcusd"
```

**Response:**
```json
{
    "data": {
        "ask": 62531.32,
        "bid": 62531.31,
        "last": 62541.13,
        "pair": "BTCUSD",
        "vwap": 63286.57,
        "source": "Bitstamp",
        "spread": 0.01,
        "low_24h": 62401.21,
        "high_24h": 64191.09,
        "open_24h": 63757.76,
        "timestamp": 1781005104,
        "volume_24h": 2113.57736078,
        "market_type": "SPOT",
        "change_24h_pct": -1.91
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:25.534Z",
        "request_id": "e3904daf-a9ba-42b3-a900-21b4b3a01cee"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

#### `GET /v1/tickers` — All pairs ticker snapshot

**Parameters:**
- `sort` (query, optional, string) — pair (default), change or volume Example: `change`
- `market_type` (query, optional, string) — Filter (e.g. SPOT)
- `limit` (query, optional, string) — Max pairs

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

**Response:**
```json
{
    "data": {
        "sort": "change",
        "count": 312,
        "source": "Bitstamp",
        "tickers": [
            {
                "ask": 0.0372,
                "bid": 0.0287,
                "last": 0.0301,
                "pair": "STRK/EUR",
                "vwap": 0.0301,
                "spread": 0.0085,
                "low_24h": 0.0262,
                "high_24h": 0.0301,
                "open_24h": 0.0262,
                "timestamp": 1781005104,
                "volume_24h": 1247.54,
                "market_type": "SPOT",
                "change_24h_pct": 14.89
            },
            {
                "ask": 0.010299,
                "bid": 0.003843,
                "last": 0.004374,
                "pair": "XCN/USD",
                "vwap": 0.003856,
                "spread": 0.006456,
                "low_24h": 0.003843,
                "high_24h": 0.004374,
                "open_24h": 0.003843,
                "timestamp": 1781005104,
                "volume_24h": 765068.9,
                "market_type": "SPOT",
                "change_24h_pct": 13.82
            },
            {
                "ask": 0.035393,
                "bid": 0.035373,
                "last": 0.035384,
                "pair": "CHIP/USD",
                "vwap": 0.033711,
                "spread": 2.0e-5,
                "low_24h": 0.03129,
                "high_24h": 0.035938,
                "open_24h": 0.03161,
                "timestamp": 1781005104,
                "
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/trades` — Live trade tape

**Parameters:**
- `pair` (query, required, string) — Bitstamp url symbol Example: `btcusd`
- `time` (query, optional, string) — Window: minute, hour (default) or day Example: `hour`
- `limit` (query, optional, string) — Max trades (default 100, max 500) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitstamp-api/v1/trades?pair=btcusd&time=hour&limit=20"
```

**Response:**
```json
{
    "data": {
        "pair": "BTCUSD",
        "count": 20,
        "source": "Bitstamp",
        "trades": [
            {
                "tid": "588301470",
                "side": "sell",
                "time": 1781005098,
                "price": 62541.13,
                "amount": 0.00028853
            },
            {
                "tid": "588301469",
                "side": "sell",
                "time": 1781005098,
                "price": 62541.71,
                "amount": 0.00871686
            },
            {
                "tid": "588301449",
                "side": "buy",
                "time": 1781005089,
                "price": 62541.73,
                "amount": 0.00171209
            },
            {
                "tid": "588301448",
                "side": "buy",
                "time": 1781005088,
                "price": 62541.73,
                "amount": 0.00392066
            },
            {
                "tid": "588301438",
                "side": "sell",
                "time": 1781005086,
                "price": 62541.72,
                "amount": 0.00023871
            },
            {
                "tid": "588301434",
                "side": "sell",
                "time": 1781005086,
                "price": 62556.57,
                "amount": 0.00237306
            },
            {
                "tid": "588301430",
                "side": "buy",
                "time": 1781005085,
                "price": 62556.58,
       
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "source": "Bitstamp public HTTP API v2 (live)",
        "service": "bitstamp-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ohlc": "OHLC candles (pair=btcusd, step=60..259200 seconds).",
            "GET /v1/ticker": "A pair's full ticker (pair=btcusd): last, bid/ask, 24h OHLC, VWAP, 24h % change, volume.",
            "GET /v1/trades": "Live trade tape — recent executed trades (pair=btcusd, time=minute|hour|day).",
            "GET /v1/markets": "All trading pairs with decimals, minimum order and status (status=all to include disabled).",
            "GET /v1/tickers": "Ticker snapshot for every pair in one call (sort=change|volume, market_type=SPOT).",
            "GET /v1/orderbook": "Top of the order book with spread (pair=btcusd, depth)."
        },
        "description": "Live market data from Bitstamp's public API, one of the oldest crypto exchanges (2011), strong in EUR and GBP pairs: all trading pairs with decimals, minimum order and status; a pair's full ticker (last, bid/ask, 24h open/high/low, VWAP, 24h % change, volume); the same snapshot for every pair in one call; the order book with spread; the live trade tape (recent executed trades with price, amount, side, time); and OHLC candles at a chosen step. Live venue data, no key, nothing stored. Distinct from Coinbase, Binance and Kraken venue APIs and from aggregated feeds — this is Bitstamp's own order book, trade tape and EUR/GBP market
…(truncated, see openapi.json for full schema)
```


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