> 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/ru/publichnyi-api-bbx-dex/integraciya-coingecko/kontrakty-i-specifikacii-kontraktov.md). # Контракты и спецификации контрактов Возвращает активные рынки бессрочных криптовалютных фьючерсов, поддерживаемые **BBX DEX** для интеграции биржи деривативов CoinGecko. Этот конечный пункт объединяет **Контракты** и **Спецификации контракта** требования в один ответ. Исключены делистингованные, отключенные, спотовые и не-криптовалютные рынки. *** ### Эндпоинт ```http GET /fapi/market/v1/public/coingecko/contracts ``` ### Полный URL ``` https://dex.bbx.com/fapi/market/v1/public/coingecko/contracts ``` *** ### Аутентификация Аутентификация не требуется. Эндпоинт общедоступен и не требует: * API-ключ * Подпись запроса * Учетные данные для входа * Токен аутентификации * Пользовательский заголовок запроса *** ### Параметры запроса Этот конечный пункт не требует никаких параметров запроса. *** ### Область охвата рынка Конечный пункт возвращает активные рынки бессрочных криптовалютных фьючерсов, поддерживаемые BBX для интеграции с CoinGecko. Следующие инструменты исключены: * Контракты, исключённые из листинга или отключённые * Спотовые рынки * Токенизированные акции и фьючерсы на акции * ETF и индексы * Сырьевые товары * Другие не криптовалютные инструменты *** ### Пример запроса ```bash curl -s \ 'https://dex.bbx.com/fapi/market/v1/public/coingecko/contracts' ``` *** ### Пример ответа ```json [ { "ticker_id": "BTC-USDT", "base_currency": "BTC", "target_currency": "USDT", "last_price": "67250.5", "base_volume": "1523.447", "target_volume": "102450321.88", "bid": "67249.8", "ask": "67251.2", "high": "68100.0", "low": "66300.0", "product_type": "Perpetual", "open_interest": "8452.331", "open_interest_usd": "568432100.55", "index_price": "67248.9", "index_name": "BTC-USDT", "index_currency": "USDT", "funding_rate": "0.0001", "next_funding_rate": "0.0001", "next_funding_rate_timestamp": 1721548800, "contract_type": "Vanilla", "contract_price": "0.0001", "contract_price_currency": "USDT" } ] ``` > Приведённые выше значения носят иллюстративный характер. В реальных ответах содержатся актуальные рыночные данные BBX. *** ### Поля ответа #### Рыночные данные | Поле | Тип | Требование | Описание | | ----------------- | ------ | ------------- | -------------------------------------------------------------------- | | `ticker_id` | строка | Обязательное | Идентификатор контракта в `BASE-TARGET` формате, например `BTC-USDT` | | `base_currency` | строка | Обязательное | Символ базового актива | | `target_currency` | строка | Обязательное | Символ целевой или котируемой валюты | | `last_price` | строка | Обязательное | Последняя цена сделки | | `base_volume` | строка | Обязательное | Скользящий 24-часовой объем торгов в единицах базового актива | | `target_volume` | строка | Обязательное | Скользящий 24-часовой объем торгов в единицах целевой валюты | | `bid` | строка | Рекомендуемое | Текущая наивысшая цена покупки; опускается, если сторона bid пуста | | `ask` | строка | Рекомендуемое | Текущая наименьшая цена продажи; опускается, если сторона ask пуста | | `high` | строка | Рекомендуемое | Скользящая 24-часовая наивысшая цена сделки | | `low` | строка | Рекомендуемое | Скользящая 24-часовая наименьшая цена сделки | #### Информация о продукте | Поле | Тип | Требование | Описание | | ----------------- | ----------- | ------------- | --------------------------------------------------------------------------------------------------- | | `product_type` | строка | Обязательное | Тип продукта: `Бессрочный` или `Фьючерсы` | | `start_timestamp` | целое число | Необязательно | Время начала продукта в виде Unix-метки времени в секундах; опускается, если недоступно | | `end_timestamp` | целое число | Необязательно | Время истечения продукта в виде Unix-метки времени в секундах; опускается для бессрочных контрактов | #### Открытый интерес и данные индекса | Поле | Тип | Требование | Описание | | ------------------- | ------ | ------------- | ------------------------------------------------------------------------ | | `open_interest` | строка | Обязательное | Двусторонний открытый интерес в единицах базового актива | | `open_interest_usd` | строка | Обязательное | Двусторонний открытый интерес в USD | | `index_price` | строка | Обязательное | Текущая цена базового индекса | | `index_name` | строка | Рекомендуемое | Название или идентификатор базового индекса; опускается, если недоступно | | `index_currency` | строка | Обязательное | Котируемая валюта базового индекса | #### Данные по финансированию | Поле | Тип | Требование | Описание | | ----------------------------- | ----------- | ------------------------------------- | ---------------------------------------------------------------------- | | `funding_rate` | строка | Обязательно для бессрочных контрактов | Текущая ставка финансирования | | `next_funding_rate` | строка | Обязательно для бессрочных контрактов | Значение ставки финансирования для следующего интервала финансирования | | `next_funding_rate_timestamp` | целое число | Обязательно для бессрочных контрактов | Время следующего финансирования в виде Unix-метки времени в секундах | #### Спецификации контракта | Поле | Тип | Требование | Описание | | ------------------------- | ------ | ------------ | ----------------------------------------------------------------------------------- | | `contract_type` | строка | Обязательное | `Ванильный` для линейных контрактов или `Обратный` для контрактов с маржой в монете | | `contract_price` | строка | Обязательное | Размер контракта или цена, представляемая одним контрактом | | `contract_price_currency` | строка | Обязательное | Валюта, в которой номинирован контракт | *** ### Именование пары Идентификаторы контрактов используют следующий формат: ``` BASE-TARGET ``` Примеры: ``` BTC-USDT ETH-USDT SOL-USDT ``` *** ### Числовые значения Цены, объемы, значения открытого интереса и ставки финансирования возвращаются как строки, чтобы избежать потери точности с плавающей запятой. Пример: ```json { "last_price": "67250.5", "open_interest": "8452.331", "funding_rate": "0.0001" } ``` Метки времени возвращаются как целые числа JSON. *** ### Единицы меток времени Следующие поля используют Unix-метки времени в секундах: ``` start_timestamp end_timestamp next_funding_rate_timestamp ``` Бессрочные контракты могут опускать `start_timestamp` и `end_timestamp`. *** ### Методология открытого интереса Конечный пункт сообщает об открытом интересе, используя двустороннюю методологию CoinGecko. Двусторонний открытый интерес представляет собой совокупность длинных и коротких открытых позиций. API предоставляет: * `open_interest` в единицах базового актива * `open_interest_usd` в USD *** ### Формат ставки финансирования Ставки финансирования возвращаются в виде десятичных значений и не приводятся к годовому выражению. Пример: ``` 0.0001 = 0.01% ``` Пара `next_funding_rate_timestamp` поле определяет начало следующего интервала финансирования. *** ### Доступность данных Рекомендуемые поля, такие как `bid`, `ask`, `high`, `low`, и `index_name` могут быть опущены, когда соответствующие рыночные данные недоступны. Обязательные поля включены для каждого активного рынка, возвращаемого конечным пунктом. Успешные ответы возвращаются как обычный JSON без оболочки-обёртки.