> For the complete documentation index, see [llms.txt](https://docs.bbx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bbx.com/bbx-dex-public-api/coingecko-integration/overview.md).

# Overview

This section documents the public market-data endpoints provided by **BBX DEX** for CoinGecko derivatives exchange integration.

The current integration covers supported cryptocurrency perpetual futures markets only. Spot markets and non-crypto instruments, including tokenized equities, stock futures, ETFs, indices, and commodities, are outside the scope of this integration.

All endpoints are read-only, publicly accessible, and require no API key, signature, login, authentication token, or custom request header.

***

### Base URL

```
https://dex.bbx.com
```

***

### Endpoint Overview

| Data                                  | Method | Endpoint                                     |
| ------------------------------------- | ------ | -------------------------------------------- |
| Contracts and contract specifications | `GET`  | `/fapi/market/v1/public/coingecko/contracts` |
| Futures order book                    | `GET`  | `/fapi/market/v1/public/coingecko/orderbook` |

The Contracts endpoint combines CoinGecko's Contracts and Contract Specs requirements into a single response.

***

### Supported Markets

The CoinGecko integration endpoints return active cryptocurrency perpetual futures markets supported by BBX for CoinGecko integration.

The following markets are excluded:

* Delisted or disabled contracts
* Spot markets
* Tokenized equities and stock futures
* ETFs and indices
* Commodities
* Other non-crypto instruments

***

### General Conventions

| Item                  | Convention                                                        |
| --------------------- | ----------------------------------------------------------------- |
| Authentication        | None                                                              |
| Access type           | Public and read-only                                              |
| Response format       | Plain JSON; successful responses have no wrapper envelope         |
| Numeric values        | Prices, volumes, open interest, and rates are returned as strings |
| Timestamps            | Returned as JSON integers                                         |
| Contract identifier   | `BASE-TARGET`, for example `BTC-USDT`                             |
| Funding timestamps    | Unix seconds                                                      |
| Order-book timestamps | Unix milliseconds                                                 |

***

### API Access and Polling

The endpoints are designed to support regular automated market-data polling, including minutely polling by CoinGecko.

BBX may apply reasonable rate limits and traffic controls to maintain the stability and availability of its public API services.

***

### Documentation

Refer to the following pages for endpoint definitions, request parameters, response fields, and example responses:

* **Contracts & Contract Specifications**
* **Order Book**