Prices for crypto coins in US dollars: the coin list, the latest quote for one coin or up to 25, daily candles back to each coin's first trade, and candles within the day down to one minute. Crypto trades around the clock, so every day and candle is on UTC.

A coin is named by its symbol, such as `BTC`, or by its pair with a dash, `BTC-USD`. Coins are known by symbol only: there is no coin name, market cap or circulating supply. A coin's symbol is not a stock ticker, even when both exist: `/v1/crypto/BTC/quote` is Bitcoin, and `/v1/stocks/BTC/quote` is the stock listed under that ticker.

Prices and volume are from one exchange, not the whole market, so volume is that exchange's volume and a price can differ slightly from another venue's. A quiet coin can go hours or days without a trade; its quote then carries the time of its real last trade.

Timing depends on the caller's plan:

| Endpoints | Free | Plus | Pro |
|---|---|---|---|
| `/v1/crypto` | Included | Included | Included |
| `/v1/crypto/{symbol}/quote`, `/v1/crypto/quotes` | Unavailable (`403`) | 15 minutes delayed | Real time |
| `/v1/crypto/{symbol}/prices` | Each day 4 hours after it ends | Also the day in progress, 15 minutes delayed | Also the day in progress, as far as it is stored |
| `/v1/crypto/{symbol}/bars` | Unavailable (`403`) | Each candle 15 minutes after it ends | Each candle once it is stored |

Candles are built from stored trades, which are added some minutes after they happen. `storedThrough` says how far a coin's stored trades reach and `through` how far the caller's plan reads them. The quote is the only real-time reading.

## Coin list

`GET /v1/crypto`

The coins with prices, in symbol order. `active` is `false` once a coin no longer trades on the exchange; its history still answers. `firstTradeDate` is the UTC day of the coin's first stored trade, and `null` while none is stored. Included on every plan.

**Parameters:** `query` (keep the coins whose symbol starts with it, e.g. `BT`; letters and digits only); `limit` (default 100, max 500); `offset`.

```bash
curl "https://api.equibles.com/v1/crypto?query=BT" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
import requests
r = requests.get(
    "https://api.equibles.com/v1/crypto",
    params={"query": "BT"},
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
```

```javascript
const res = await fetch("https://api.equibles.com/v1/crypto?query=BT", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
```

```json
{
  "data": [
    { "symbol": "BTC", "pair": "BTC/USD", "currency": "USD", "active": true, "firstTradeDate": "2013-10-06" },
    { "symbol": "BTR", "pair": "BTR/USD", "currency": "USD", "active": true, "firstTradeDate": "2025-08-27" },
    { "symbol": "BTT", "pair": "BTT/USD", "currency": "USD", "active": true, "firstTradeDate": "2022-07-01" }
  ],
  "meta": { "limit": 100, "offset": 0, "count": 3, "hasMore": false }
}
```

## Crypto quote

`GET /v1/crypto/{symbol}/quote`

The latest price of one coin: the last trade's `price` and `tradeTime`, the `change` and `changePercent` against the last trade price 24 hours before `asOf`, and the volume, high, low and trade count of the 24 hours ending at `dayThrough`. `dayVolume` is in units of the coin. `asOf` is the instant the reading stands for: no newer trade is known up to it.

`stale` is `true` only when the reading may be missing recent trades. A quiet coin is never stale for being quiet: read `tradeTime` to see how old its last trade is.

Needs a paid plan. Pro reads real time. Plus reads 15 minutes delayed (`delayed: true`): it shows no trade newer than 15 minutes, and `tradeTime` is the start of the minute that trade printed in. Free is refused with `403` and reads daily candles at `/v1/crypto/{symbol}/prices`. A symbol that is not a coin returns `404`, as does a coin whose history is still loading and has no price yet.

**Parameters:** `{symbol}` (coin symbol such as `BTC`, or its pair with a dash, `BTC-USD`).

```bash
curl "https://api.equibles.com/v1/crypto/BTC/quote" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
import requests
r = requests.get(
    "https://api.equibles.com/v1/crypto/BTC/quote",
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
```

```javascript
const res = await fetch("https://api.equibles.com/v1/crypto/BTC/quote", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
```

```json
{
  "symbol": "BTC",
  "pair": "BTC/USD",
  "currency": "USD",
  "price": 64760.2,
  "tradeTime": "2026-11-17T22:43:06.761264+00:00",
  "asOf": "2026-11-17T22:43:08.971963+00:00",
  "delayed": false,
  "stale": false,
  "change": -563.5,
  "changePercent": -0.86,
  "dayVolume": 4241.64266607,
  "dayHigh": 65471.3,
  "dayLow": 63272.3,
  "dayTradeCount": 175047,
  "dayThrough": "2026-11-17T22:42:09.448013+00:00"
}
```

## Crypto quotes for several coins

`GET /v1/crypto/quotes`

The same reading for up to 25 coins in one call, in the order asked. A symbol that is not a coin fails the call with `400` and is named in the message. A coin whose history is still loading has no price yet and is left out. The plan rules are the quote's.

**Parameters:** `symbols` (comma-separated coin symbols, max 25, e.g. `BTC,ETH`; `BTC/USD` and `BTC-USD` also work).

```bash
curl "https://api.equibles.com/v1/crypto/quotes?symbols=BTC,ETH" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
import requests
r = requests.get(
    "https://api.equibles.com/v1/crypto/quotes",
    params={"symbols": "BTC,ETH"},
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
```

```javascript
const res = await fetch("https://api.equibles.com/v1/crypto/quotes?symbols=BTC,ETH", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
```

```json
{
  "data": [
    {
      "symbol": "BTC",
      "pair": "BTC/USD",
      "currency": "USD",
      "price": 64760.2,
      "tradeTime": "2026-11-17T22:43:06.761264+00:00",
      "asOf": "2026-11-17T22:43:08.990103+00:00",
      "delayed": false,
      "stale": false,
      "change": -563.5,
      "changePercent": -0.86,
      "dayVolume": 4241.64266607,
      "dayHigh": 65471.3,
      "dayLow": 63272.3,
      "dayTradeCount": 175047,
      "dayThrough": "2026-11-17T22:42:09.448013+00:00"
    },
    {
      "symbol": "ETH",
      "pair": "ETH/USD",
      "currency": "USD",
      "price": 1814.41,
      "tradeTime": "2026-11-17T22:43:07.846385+00:00",
      "asOf": "2026-11-17T22:43:08.990103+00:00",
      "delayed": false,
      "stale": false,
      "change": -16.71,
      "changePercent": -0.91,
      "dayVolume": 48796.9050117,
      "dayHigh": 1841.74,
      "dayLow": 1749.17,
      "dayTradeCount": 57532,
      "dayThrough": "2026-11-17T22:40:00.769007+00:00"
    }
  ]
}
```

## Daily crypto candles

`GET /v1/crypto/{symbol}/prices`

Daily candles for one coin, newest first: open, high, low, close, `volume` in units of the coin and `tradeCount`. A day runs from midnight to midnight UTC and `time` is its first instant. A day without trades has no candle, so a gap means no trades. History reaches back to the coin's first trade on the exchange, 2013 for `BTC`.

Plus and Pro also receive the day in progress as the newest candle: `forming` is `true`, and its figures are read up to `through` and still change. Free reads a day 4 hours after it ends and never the day in progress; `notice` says so.

`limit` cuts the oldest days. When `truncated` is `true`, pass the day before the oldest candle as `endDate` to continue.

**Parameters:** `{symbol}` (coin symbol such as `BTC`, or `BTC-USD`); `startDate` / `endDate` (`yyyy-MM-dd` UTC days, default the coin's first trade through today); `limit` (default 250, max 500).

```bash
curl "https://api.equibles.com/v1/crypto/BTC/prices?startDate=2026-09-28&endDate=2026-09-30" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
import requests
r = requests.get(
    "https://api.equibles.com/v1/crypto/BTC/prices",
    params={"startDate": "2026-09-28", "endDate": "2026-09-30"},
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
```

```javascript
const res = await fetch("https://api.equibles.com/v1/crypto/BTC/prices?startDate=2026-09-28&endDate=2026-09-30", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
```

```json
{
  "symbol": "BTC",
  "pair": "BTC/USD",
  "currency": "USD",
  "interval": "1day",
  "returned": 3,
  "truncated": false,
  "delayed": false,
  "forming": false,
  "storedThrough": "2026-11-17T22:42:09.448013+00:00",
  "through": "2026-11-17T22:42:09.448013+00:00",
  "notice": "Prices and volume are from one exchange, not the whole market.",
  "candles": [
    { "time": "2026-09-30T00:00:00+00:00", "open": 83633.5, "high": 85604.0, "low": 82920.1, "close": 83564.7, "volume": 2715.90924755, "tradeCount": 147967 },
    { "time": "2026-09-29T00:00:00+00:00", "open": 83462.7, "high": 84527.1, "low": 82735.1, "close": 83633.4, "volume": 2167.13703048, "tradeCount": 142236 },
    { "time": "2026-09-28T00:00:00+00:00", "open": 84444.2, "high": 85060.8, "low": 82566.4, "close": 83462.7, "volume": 3143.19416898, "tradeCount": 153717 }
  ]
}
```

## Intraday crypto candles

`GET /v1/crypto/{symbol}/bars`

Candles within the day for one coin, newest first, around the clock. `interval` is any whole number of minutes from `1min` (default) to `240min`, such as `5min` or `15min`, or a whole number of hours from `1hour` to `4hour`, counted from midnight UTC. A period without trades has no candle. A candle is returned only once its period has ended, so `forming` is always `false` here and no figure changes later.

The newest candles come first and `limit` cuts the oldest. When `truncated` is `true`, pass the oldest candle's `time` as `endTime` to continue; it returns only candles that start before it, so none repeats. Keep `startDate` on the continuing request: without it the default window slides back with `endTime`.

Needs a paid plan. Plus receives each candle 15 minutes after it ends (`delayed: true`). Pro receives each candle once it is stored. Free is refused with `403` and reads daily candles at `/v1/crypto/{symbol}/prices`.

**Parameters:** `{symbol}` (coin symbol such as `BTC`, or `BTC-USD`); `interval` (default `1min`); `startDate` / `endDate` (`yyyy-MM-dd` UTC days, default the trailing 7 days through now, 30 days for the hourly intervals); `endTime` (RFC 3339, replaces `endDate`); `limit` (default 250, max 500).

```bash
curl "https://api.equibles.com/v1/crypto/BTC/bars?interval=15min&limit=3" \
  -H "Authorization: Bearer eq_your_api_key"
```

```python
import requests
r = requests.get(
    "https://api.equibles.com/v1/crypto/BTC/bars",
    params={"interval": "15min", "limit": 3},
    headers={"Authorization": "Bearer eq_your_api_key"},
)
print(r.json())
```

```javascript
const res = await fetch("https://api.equibles.com/v1/crypto/BTC/bars?interval=15min&limit=3", {
  headers: { Authorization: "Bearer eq_your_api_key" },
});
console.log(await res.json());
```

The three newest 15-minute candles at 22:43 UTC on 2026-11-17:

```json
{
  "symbol": "BTC",
  "pair": "BTC/USD",
  "currency": "USD",
  "interval": "15min",
  "returned": 3,
  "truncated": true,
  "delayed": false,
  "forming": false,
  "storedThrough": "2026-11-17T22:42:09.448013+00:00",
  "through": "2026-11-17T22:42:09.448013+00:00",
  "notice": "Prices and volume are from one exchange, not the whole market.",
  "candles": [
    { "time": "2026-11-17T22:15:00+00:00", "open": 64397.8, "high": 64558.5, "low": 64332.4, "close": 64558.5, "volume": 25.33999322, "tradeCount": 1335 },
    { "time": "2026-11-17T22:00:00+00:00", "open": 64289.6, "high": 64475.7, "low": 64105.3, "close": 64408.6, "volume": 62.12013583, "tradeCount": 2053 },
    { "time": "2026-11-17T21:45:00+00:00", "open": 64315.3, "high": 64341.5, "low": 64179.2, "close": 64289.6, "volume": 28.5416707, "tradeCount": 1922 }
  ]
}
```