> ## Documentation Index
> Fetch the complete documentation index at: https://docs.binibit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Versioned changes to the Binibit public API.

## v1.0 — 2026-04-29

Initial public release of the Spot Market API on `public-api.binibit.com` plus the aggregator-spec namespace on `internal-api.binibit.com/.../getcoingecko/*`.

### Market data endpoints (public-api.binibit.com/api)

* `GET /tickers` — single-pair ticker
* `GET /orderbook` — 40 bids + 40 asks per pair
* `GET /deals` — recent trades per pair, paginated
* `GET /ohlc` — OHLCV candles, intervals from 1 minute to 1 year
* `GET /currencies` — list of currency codes
* `GET /currencies/pairs` — pair settings (precision, min order size)
* `GET /currencies/commissions` — default commissions catalogue
* `GET /healthcheck` — liveness probe

### Aggregator-spec endpoints (internal-api.binibit.com/.../getcoingecko)

* `GET /tickers` — all pairs in one call, CoinGecko array shape
* `GET /orderbook` — CoinGecko `bids/asks` shape
* `GET /historical_trades` — CoinGecko `{buy: [], sell: []}` shape
* `GET /asset` — CoinMarketCap-compatible asset metadata

### Standards

* Aggregator-spec schema follows CoinGecko Integration API Standards v8 (Section A: Spot Exchanges)
* Public OpenAPI 3.0 spec for `public-api.binibit.com` available at [/swagger/v1/swagger.json](https://public-api.binibit.com/swagger/v1/swagger.json)

## Roadmap

### v1.x — planned

* **Cleaner path alias** `/v1/spot/market/*` mapped to current routes (so the user-facing path doesn't carry the `getcoingecko` legacy name)
* **Server time** endpoint (`GET /api/time`) — useful for clients signing requests against the trading API
* **24h summary** endpoint (`GET /api/summary`) — compact one-call summary of all pairs (CMC-compatible)
* **Status page** at `status.binibit.com`

### v2.0 — planned

* **Authenticated trading API documentation** — endpoints already exist on `public-api.binibit.com`, currently with auth-signature disabled. v2 documents the HMAC-SHA256 signing scheme already used by the Binibit web client.
* **WebSocket streams** for tickers, order book diffs, and trades

## Subscribe

The recommended ways to track changes:

* **Email** — send a request to [api@binibit.com](mailto:api@binibit.com) with subject `[Subscribe: API updates]` to be notified of breaking changes and new versions
* **GitHub** — star or watch [github.com/Binibit/docs](https://github.com/Binibit/docs) for release and PR notifications
* **Atom feed** — `https://github.com/Binibit/docs/releases.atom`