API

Authenticated REST + WebSocket API. Default users are rate limited (Premium: no rate limit).

base: —

auth: —

loading…

1) Authentication

Use Authorization: Bearer <token> for REST. For WebSocket, connect to the Socket.IO namespace /api with auth: { token }.

Token name (optional)

Failed.

OK.

Name	Created	Last used	Status	Actions
loading…

2) REST endpoints (v1)

All endpoints below require a Bearer token. Use the token manager above to create one, then paste it here to render the live endpoint reference.

Bearer token (for explorer)

Failed.

OK.

Quick curl template

loading…

Aggregated vs per-venue prices

The /api/v1/market/tick payload includes both the aggregated price (tick.price) and individual venue prices (tick.prices.<exchange>).

loading…

Endpoint reference (from OpenAPI)

Load OpenAPI to see endpoints…

Raw OpenAPI

(hidden until loaded)

3) WebSocket (Socket.IO)

Connect to /api and then emit subscribe_symbols with { symbols: ["BTC-USD"] }. You will receive events like tick, dom, tape, heatmap.

loading…

4) Historical Data — GET /api/history/<symbol>

Returns aggregated OHLCV candles built from live trade data and backfilled from all connected exchanges (Hyperliquid, Kraken, Coinbase, HTX Spot&Perps, BloFin, Aster). No authentication required.

Query parameters

Param	Default	Description
`interval`	`1m`	Candle size — one of `1m`, `5m`, `15m`, `1h`, `4h`, `1d`
`from`	now − 24 h	Window start, Unix milliseconds
`to`	now	Window end, Unix milliseconds
`limit`	`500`	Max candles returned (hard cap 2 000)

Candle fields

Field	Type	Description
`open_ms`	int	Candle open time (Unix ms)
`open`	float	First trade price in bucket
`high`	float	Highest price across all sources
`low`	float	Lowest price across all sources
`close`	float	Last trade price in bucket
`volume`	float	Total volume (summed across sources)
`buy_volume`	float	Taker-buy volume (where available)
`sell_volume`	float	Taker-sell volume (where available)
`trade_count`	int	Total individual trades in bucket

Example requests

# Last 24 h of BTC-USD at 1 h resolution
GET /api/history/BTC-USD?interval=1h

# Custom time window (Unix ms)
GET /api/history/ETH-USD?interval=15m&from=1712000000000&to=1712345678000

# Up to 2 000 daily candles
GET /api/history/SOL-USD?interval=1d&limit=2000

# curl example
curl "https://www.bleedingedgealpha.net/api/history/BTC-USD?interval=1h&limit=24"

Example response

{
  "symbol": "BTC-USD",
  "interval": "1h",
  "from_ms": 1712259278000,
  "to_ms":   1712345678000,
  "count": 24,
  "backfilling": false,
  "candles": [
    {
      "open_ms": 1712259600000,
      "open": 82950.0, "high": 83400.0, "low": 82800.0, "close": 83200.0,
      "volume": 142.83, "buy_volume": 88.12, "sell_volume": 54.71,
      "trade_count": 4821
    }
  ]
}

Automatic backfill

If the database has less than 80 % of the expected candles for the requested window, the server automatically fetches missing data from all exchanges before responding.

Window size	Behaviour
≤ 7 days	Synchronous — request waits for the backfill to complete, then returns full data.
> 7 days	Async — cached data is returned immediately with `"backfilling": true`; retry after a few seconds for complete data.

Backfill sources (public REST, no auth): Hyperliquid · Kraken · Coinbase · HTX Spot · HTX Perps · BloFin · Aster. Candles from each source are merged per time-bucket — volume and trade count are summed; high/low are taken across all sources.

5) Notes

Keep your token secret. If it leaks, revoke it immediately. Tokens are stored server-side as hashes.

New token