Tickers

Per-exchange tickers for an asset.

# Tickers

`GET https://api.rarebl.com/open/market/tickers`

The individual exchange tickers behind a price.

**Rate class:** read (5 requests per second, burst 20, per IP). **Available since:** Open API v2.

## Request

Send the parameters as query parameters (GET) or as a JSON object (POST with `Content-Type: application/json`). They are identical either way. No API key is needed: `X-API-KEY` is reserved and ignored.

Example: `curl "https://api.rarebl.com/open/market/tickers?asset=btc"`

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `asset` | string | Yes | An asset symbol. |

## Responses

### API200 (HTTP 200): OK

Tickers by source (a real reply, shortened).

```json
{
  "status": 1,
  "code": "API200",
  "message": "success",
  "data": {
    "tickers": [
      {
        "source": "binance",
        "pair": "BTC/USD",
        "last": "63449.83",
        "bid": "63392.39",
        "ask": "63437.98",
        "volume24h": "11.75039",
        "ts": "2026-11-15T01:00:51.309Z"
      },
      {
        "source": "bitfinex",
        "pair": "BTC/USD",
        "last": "63499",
        "bid": "63495",
        "ask": "63502",
        "volume24h": "1644.58469326",
        "ts": "2026-11-15T01:00:45.910Z"
      },
      {
        "source": "bitstamp",
        "pair": "BTC/USD",
        "last": "63413.18",
        "bid": "63407.27",
        "ask": "63407.28",
        "volume24h": "1899.15444542",
        "ts": "2026-11-15T01:00:44.225Z"
      }
    ]
  },
  "go": null,
  "meta": {
    "requestid": "0123456789abcdef",
    "notices": []
  }
}
```

| Field | Type | Description |
| --- | --- | --- |
| `data.tickers[]` | object[] | `{source, pair, last, bid, ask, volume24h, ts}`. |

### API400 (HTTP 400): Bad Request

A parameter is missing or malformed. `data.param` names it (here `asset`).

```json
{
  "status": 0,
  "code": "API400",
  "message": "Missing parameter: asset.",
  "data": {
    "param": "asset"
  },
  "go": null,
  "meta": {
    "requestid": "0123456789abcdef",
    "notices": []
  }
}
```

### API429 (HTTP 429): Too Many Requests

Rate limited (read class: 5 requests per second, burst 20, per IP). A `Retry-After` header says how long to wait, in seconds.

```json
{
  "status": 0,
  "code": "API429",
  "message": "Too many requests. Please retry shortly.",
  "data": null,
  "go": null,
  "meta": {
    "requestid": "0123456789abcdef",
    "notices": []
  }
}
```

## Notes

- Reference data from public feeds, not Rarebl trading rates.

Back to the Rarebl AI documentation index