> ## 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.

# API Reference

> REST endpoints for the Binibit Spot Market API.

## Overview

Binibit exposes its REST API across **two hostnames**:

| Group                        | Host                       | Endpoints                                                                |
| ---------------------------- | -------------------------- | ------------------------------------------------------------------------ |
| **Market Data**              | `public-api.binibit.com`   | Primary public API — tickers, order book, trades, candles, currencies    |
| **Aggregator Compatibility** | `internal-api.binibit.com` | Subset reshaped for CoinGecko / CoinMarketCap-style aggregator ingestion |

## Market Data (public-api.binibit.com)

| Method | Path                          | Page                                                          |
| ------ | ----------------------------- | ------------------------------------------------------------- |
| `GET`  | `/api/tickers`                | [Tickers](/api-reference/market-data/tickers)                 |
| `GET`  | `/api/orderbook`              | [Order Book](/api-reference/market-data/orderbook)            |
| `GET`  | `/api/deals`                  | [Deals](/api-reference/market-data/deals)                     |
| `GET`  | `/api/ohlc`                   | [OHLC](/api-reference/market-data/ohlc)                       |
| `GET`  | `/api/currencies`             | [Currencies](/api-reference/market-data/currencies)           |
| `GET`  | `/api/currencies/pairs`       | [Currency Pairs](/api-reference/market-data/currencies-pairs) |
| `GET`  | `/api/currencies/commissions` | [Commissions](/api-reference/market-data/commissions)         |
| `GET`  | `/api/healthcheck`            | [Healthcheck](/api-reference/market-data/healthcheck)         |

The full OpenAPI 3.0 spec for `public-api.binibit.com` is published at [/swagger/v1/swagger.json](https://public-api.binibit.com/swagger/v1/swagger.json), with an interactive playground at [/swagger/](https://public-api.binibit.com/swagger/).

## Aggregator Compatibility (internal-api.binibit.com)

| Method | Path                 | Page                                                                          |
| ------ | -------------------- | ----------------------------------------------------------------------------- |
| `GET`  | `/pairs`             | [Pairs (aggregator)](/api-reference/aggregator/pairs)                         |
| `GET`  | `/tickers`           | [Tickers (aggregator)](/api-reference/aggregator/tickers)                     |
| `GET`  | `/orderbook`         | [Order Book (aggregator)](/api-reference/aggregator/orderbook)                |
| `GET`  | `/historical_trades` | [Historical Trades (aggregator)](/api-reference/aggregator/historical-trades) |

These endpoints follow the CoinGecko Integration API Standards v8 schema (Section A: Spot Exchanges) so aggregators (CoinGecko, CoinMarketCap, DefiLlama) can ingest Binibit market data without translation.

## Authentication

The market data endpoints documented here are **public** — no API key required. See [Authentication](/general/authentication) for the trading API.

## Rate limits

See [Rate Limits](/general/rate-limits).

## Conventions

* All requests are `GET` with query parameters
* All responses are JSON
* All numeric values are decimals (prices, volumes) or integers (timestamps, IDs)
* Timestamps differ between the two surfaces:
  * `public-api.binibit.com` uses **ISO 8601 strings** (`2026-04-29T10:26:08.0053357Z`) and **seconds** for ticker timestamp
  * `internal-api.binibit.com` aggregator namespace uses **Unix milliseconds** (CoinGecko convention)
* Errors follow a unified envelope — see [Errors](/general/errors)

## Try it

Every endpoint page below includes copy-paste curl examples that work against the live production API.

<Card title="Start with /api/tickers" icon="chart-line" href="/api-reference/market-data/tickers">
  Single-pair ticker — the simplest call to confirm your integration works.
</Card>