# Bitstamp Crypto Market API

> Bitstamp spot market data: ticker, order book, OHLC candles and recent trades for BTC, ETH and more

- Vendor: `bitstampcryptomarketapi` · version 1.0 · category Crypto Market Data · tags bitstamp api, crypto ticker api, bitcoin price api, order book api, ohlc candles api, crypto exchange api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/bitstampcryptomarketapi
- This document: https://apiclay.com/docs/bitstampcryptomarketapi.md
- OpenAPI 3.1: https://apiclay.com/api/bitstampcryptomarketapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `bitstampcryptomarketapi`
- Updated: 2026-11-18

## About

## Bitstamp Crypto Market API

Public market data from the Bitstamp crypto exchange: the 24-hour ticker (last, bid, ask, high, low, volume, VWAP), the order book, OHLC candles at intervals from 1 minute to 3 days, recent trades and the list of trading pairs.

Data comes from **bitstamp.net** (https://www.bitstamp.net). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/ticker?pair=btcusd`, `/ohlc?pair=ethusd&amp;step=3600&amp;limit=24`.

### Routes

#### GET `/ticker` - Ticker
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| pair | path | string | yes | e.g. `btcusd`, `etheur`. |

Returns: `last`, `bid`, `ask`, `high`, `low`, `open`, `volume`, `vwap`, `percent_change_24`, `timestamp`.

#### GET `/order-book` - Order book
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| pair | path | string | yes | Pair. |
| group | query | number | no | `1` grouped (default), `0` every order. |

Returns: `bids[]`, `asks[]` as `[price, amount]`, `timestamp`.

#### GET `/ohlc` - OHLC candles
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| pair | path | string | yes | Pair. |
| step | query | number | yes | Seconds: 60, 300, 900, 3600, 86400... |
| limit | query | number | yes | Candles, up to 1000. |
| start | query | number | no | Unix start. |
| end | query | number | no | Unix end. |

Returns: `data.ohlc[]` with `timestamp`, `open`, `high`, `low`, `close`, `volume`.

#### GET `/trades` - Recent trades
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| pair | path | string | yes | Pair. |
| time | query | string | no | `minute`, `hour` (default) or `day`. |

Returns: array of trades (`date`, `price`, `amount`, `type`).

#### GET `/pairs` - Trading pairs
No parameters.

Returns: array of pairs with `name`, `url_symbol`, `trading`, `minimum_order`.

### Caveats

- Exchange market data; check Bitstamp's terms before commercial redistribution.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by bitstamp.net.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /ticker — Ticker
- Gateway: `GET https://api.apiclay.com/v1/api/bitstampcryptomarketapi/ticker`
- Public query params: `pair` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /order-book — Order book
- Gateway: `GET https://api.apiclay.com/v1/api/bitstampcryptomarketapi/order-book`
- Public query params: `group` (number), `pair` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /ohlc — OHLC candles
- Gateway: `GET https://api.apiclay.com/v1/api/bitstampcryptomarketapi/ohlc`
- Public query params: `step` (number, required), `limit` (number, required), `start` (number), `end` (number), `pair` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /trades — Recent trades
- Gateway: `GET https://api.apiclay.com/v1/api/bitstampcryptomarketapi/trades`
- Public query params: `time` (string), `pair` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /pairs — Trading pairs
- Gateway: `GET https://api.apiclay.com/v1/api/bitstampcryptomarketapi/pairs`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/bitstampcryptomarketapi/ticker?pair=<pair>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
