# Bitso API
> Live spot market data from Bitso, the largest regulated crypto exchange in Latin America (Mexico, Argentina, Brazil, Colombia) — served straight from its public API, no key, nothing cached. Get a book's last price, 24h high/low, best bid/ask, VWAP, volume and 24h change (in Mexican peso, Argentine peso, US dollar, Bitcoin and more); rank every book by approximate 24h quote volume; list trading pairs with their min/max order size, tick size and maker/taker fees; and read live market depth (top bids and asks). A distinct Latin-American venue with local-fiat pricing, separate from other exchange feeds.

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

## Pricing
- **Free** (Free) — 3,400 calls/Mo, 2 req/s
- **Starter** ($9/Mo) — 76,000 calls/Mo, 6 req/s
- **Pro** ($24/Mo) — 410,000 calls/Mo, 15 req/s
- **Business** ($58/Mo) — 2,650,000 calls/Mo, 40 req/s

## Endpoints

### Bitso

#### `GET /v1/books` — List trading pairs with fees and limits

**Parameters:**
- `quote` (query, optional, string) — Filter by quote currency e.g. mxn (omit for all) Example: `mxn`

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

**Response:**
```json
{
    "data": {
        "books": [
            {
                "base": "sol",
                "book": "sol_mxn",
                "quote": "mxn",
                "tick_size": 0.01,
                "maker_fee_pct": 0.6,
                "taker_fee_pct": 0.78,
                "margin_enabled": true,
                "maximum_amount": 500000,
                "minimum_amount": 0.0005
            },
            {
                "base": "ltc",
                "book": "ltc_mxn",
                "quote": "mxn",
                "tick_size": 0.1,
                "maker_fee_pct": 0.6,
                "taker_fee_pct": 0.78,
                "margin_enabled": true,
                "maximum_amount": 100000,
                "minimum_amount": 0.0001
            },
            {
                "base": "avax",
                "book": "avax_mxn",
                "quote": "mxn",
                "tick_size": 0.01,
                "maker_fee_pct": 0.6,
                "taker_fee_pct": 0.78,
                "margin_enabled": true,
                "maximum_amount": 600000,
                "minimum_amount": 0.0006
            },
            {
                "base": "pyusd",
                "book": "pyusd_mxn",
                "quote": "mxn",
                "tick_size": 0.001,
                "maker_fee_pct": 0.6,
                "taker_fee_pct": 0.78,
                "margin_enabled": true,
                "maximum_amount": 10000000,
                "minimum_amount": 0.01
            },
           
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/meta` — Service metadata and endpoint list

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

**Response:**
```json
{
    "data": {
        "source": "Bitso API (api.bitso.com/v3, live)",
        "service": "bitso-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/books": "List trading pairs with fees and limits (quote=mxn optional).",
            "GET /v1/ticker": "Ticker for one book (book=btc_mxn or symbol=btc&quote=mxn).",
            "GET /v1/tickers": "All books ranked by approximate 24h quote volume (limit=50).",
            "GET /v1/orderbook": "Live market depth — top bids and asks (book=btc_mxn, limit=20)."
        },
        "book_count": 98,
        "description": "Live spot market data from Bitso, the largest regulated crypto exchange in Latin America (Mexico, Argentina, Brazil, Colombia). The ticker endpoint returns a book's last price, 24h high/low, best bid/ask, VWAP, volume and 24h change (in Mexican peso, Argentine peso, US dollar, Bitcoin and more); the tickers endpoint ranks every book by approximate 24h quote volume; the books endpoint lists trading pairs with min/max order size, tick size and maker/taker fees; the orderbook endpoint returns live market depth. Live, no key, nothing stored. A distinct Latin-American venue with local-fiat pricing, separate from other exchange feeds.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:26.651Z",
        "request_id": "1fbcd0e6-8494-469e-b8b0-fc6cc7a88050"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```

#### `GET /v1/orderbook` — Live market depth — top bids and asks

**Parameters:**
- `book` (query, required, string) — Book code base_quote Example: `btc_mxn`
- `limit` (query, optional, string) — Levels per side 1-100 (default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bitso-api/v1/orderbook?book=btc_mxn&limit=20"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 1070180,
                "amount": 0.0886135
            },
            {
                "price": 1070190,
                "amount": 0.16274
            },
            {
                "price": 1070220,
                "amount": 0.7
            },
            {
                "price": 1071360,
                "amount": 1.6467515
            },
            {
                "price": 1074730,
                "amount": 0.00317044
            },
            {
                "price": 1074740,
                "amount": 0.102
            },
            {
                "price": 1074750,
                "amount": 0.7678
            },
            {
                "price": 1079760,
                "amount": 0.21
            },
            {
                "price": 1080000,
                "amount": 0.2
            },
            {
                "price": 1082460,
                "amount": 0.278
            },
            {
                "price": 1092000,
                "amount": 2.07424259
            },
            {
                "price": 1092010,
                "amount": 0.00018314
            },
            {
                "price": 1092440,
                "amount": 4.576e-5
            },
            {
                "price": 1092690,
                "amount": 0.142
            },
            {
                "price": 1092700,
                "amount": 0.15
            },
            {
    
…(truncated, see openapi.json for full schema)
```

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

**Parameters:**
- `book` (query, required, string) — Book code base_quote (or use symbol & quote) Example: `btc_mxn`

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

**Response:**
```json
{
    "data": {
        "ask": 1070180,
        "bid": 1069720,
        "low": 1061400,
        "base": "btc",
        "book": "btc_mxn",
        "high": 1091510,
        "last": 1069990,
        "vwap": 1074985.560058218,
        "quote": "mxn",
        "source": "Bitso",
        "spread": 460,
        "change_24h": -5840,
        "created_at": "2026-06-10T22:56:26+00:00",
        "volume_24h": 6.9580661,
        "quote_volume_24h_approx": 7445061.15
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:27.150Z",
        "request_id": "12fab013-5f66-474e-adf2-a908caf451ff"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

#### `GET /v1/tickers` — All books ranked by approximate 24h quote volume

**Parameters:**
- `limit` (query, optional, string) — Max results 1-200 (default 50) Example: `50`

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

**Response:**
```json
{
    "data": {
        "count": 50,
        "source": "Bitso",
        "tickers": [
            {
                "ask": 1493.37,
                "bid": 1492.5,
                "low": 1489.48,
                "base": "usdt",
                "book": "usdt_ars",
                "high": 1514.09,
                "last": 1492.5,
                "vwap": 1500.3204040712,
                "quote": "ars",
                "spread": 0.87,
                "change_24h": -15.64,
                "created_at": "2026-06-10T22:56:27+00:00",
                "volume_24h": 790937.2569374,
                "quote_volume_24h_approx": 1180473855.98
            },
            {
                "ask": 1494.52,
                "bid": 1493.07,
                "low": 1490.44,
                "base": "usd",
                "book": "usd_ars",
                "high": 1515,
                "last": 1493.16,
                "vwap": 1503.3975980313,
                "quote": "ars",
                "spread": 1.45,
                "change_24h": -17.12,
                "created_at": "2026-06-10T22:56:27+00:00",
                "volume_24h": 781869.33114149,
                "quote_volume_24h_approx": 1167456010.49
            },
            {
                "ask": 3559.8,
                "bid": 3541.9,
                "low": 3536.6,
                "base": "usd",
                "book": "usd_cop",
                "high": 3647.6,
                "last": 3545.4,
                "vwap": 3564.4765036746,
               
…(truncated, see openapi.json for full schema)
```


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