Объём 24ч—Открытый интерес—Ликвидации 24ч$1.36BЛонг/Шорт 24ч—Доминация BTC—Доминация ETH—

Приложение

Язык ▾

₽ RUB ▾

/api/sd/basis

GETДеградацияSTALE

Базис фьючерсов (все площадки)

Базис бессрочных контрактов (цена маркировки против индексной цены), базис бессрочного контракта к споту на той же бирже и базис срочных фьючерсов с годовой ставкой — по каждому контракту, а также агрегаты: взвешенный по OI, взвешенный по объёму и медианный.

GET/api/sd/basis

Деградация. Эндпоинт сообщает качество данных STALE

Запрос

Параметры запроса

Имя	Тип	Обязательный	По умолчанию	Допустимые значения	Описание
coin	string	Обязательный	—	—	Символ монеты без учёта регистра (например, `BTC`). При отсутствии или некорректном значении возвращается 400. Пример: BTC

Пример запроса

curl -s "https://www.coinboss.com/api/sd/basis?coin=BTC"

Поля ответа

Таблица полей формируется из реальных ответов, поэтому в ней перечислено ровно то, что возвращает эндпоинт. В путях a[] обозначает элементы массива, а {*} — объекты с динамическим ключом, например монетой или биржей.

Поле	Тип	Единица	Описание
success	boolean	—	true, если запрос выполнен успешно. При ошибке тело ответа имеет вид `{ success: false, code, error, request_id }`.
schema	string	—	Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
now	number	ms	Время сервера в момент формирования ответа.
coin	string	—	Символ монеты (в верхнем регистре).
perp	object	—	Базис бессрочных контрактов: цена маркировки относительно индексной цены той же биржи.
perp.unit	string	—	Единица значений базиса (проценты).
perp.aggregate	object	—	Агрегат раздела по всем биржам.
perp.aggregate.oi_weighted_pct	number	%	Базис, взвешенный по открытому интересу; строки без веса OI не учитываются.
perp.aggregate.oi_weight_usd	number	USD	Сумма использованных весов открытого интереса.
perp.aggregate.n_oi_weighted	number	—	Строки, у которых был вес OI.
perp.aggregate.vol_weighted_pct	number	%	Базис, взвешенный по номинальному объёму за 24h.
perp.aggregate.vol_weight_usd	number	USD	Сумма использованных весов объёма.
perp.aggregate.n_vol_weighted	number	—	Строки, у которых был вес объёма.
perp.aggregate.median_pct	number	%	Медиана базиса по одному основному контракту на биржу.
perp.aggregate.mean_pct	number	%	Простое среднее по тому же набору, что и медиана.
perp.aggregate.n_exchanges	number	—	Биржи в агрегате.
perp.aggregate.n_contracts	number	—	Контракты в агрегате.
perp.aggregate.min	object	—	Биржа и контракт с наименьшим базисом.
perp.aggregate.min.exchange	string	—	Идентификатор биржи (в нижнем регистре).
perp.aggregate.min.symbol	string	—	Символ контракта в формате хранения CoinBoss.
perp.aggregate.min.basis_pct	number	%	(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
perp.aggregate.max	object	—	Биржа и контракт с наибольшим базисом.
perp.aggregate.max.exchange	string	—	Идентификатор биржи (в нижнем регистре).
perp.aggregate.max.symbol	string	—	Символ контракта в формате хранения CoinBoss.
perp.aggregate.max.basis_pct	number	%	(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
perp.aggregate.median_last_pct	number	%	Медиана базиса по последней цене.
perp.aggregate.n_exchanges_last	number	—	Биржи в медиане по последней цене.
perp.aggregate.weights	object	—	Откуда взяты веса, их окно актуальности и возраст самого старого веса.
perp.aggregate.weights.oi	object	—	Открытый интерес.
perp.aggregate.weights.oi.source	string	—	Публичные эндпоинты источников, из которых собраны данные.
perp.aggregate.weights.oi.fresh_window_s	number	s	Вес старше этого значения не используется.
perp.aggregate.weights.oi.oldest_age_s	number	s	Возраст самого старого использованного веса.
perp.aggregate.weights.oi.side	string	—	Является ли вес открытого интереса односторонним.
perp.aggregate.weights.vol	object	—	Объём.
perp.aggregate.weights.vol.source	string	—	Публичные эндпоинты источников, из которых собраны данные.
perp.aggregate.weights.vol.fresh_window_s	number	s	Вес старше этого значения не используется.
perp.aggregate.weights.vol.oldest_age_s	number	s	Возраст самого старого использованного веса.
perp.contracts	array	—	Одна строка на контракт.
perp.contracts[]	object	—	Одна строка на контракт.
perp.contracts[].exchange	string	—	Идентификатор биржи (в нижнем регистре).
perp.contracts[].symbol	string	—	Символ контракта в формате хранения CoinBoss.
perp.contracts[].native_symbol	string	—	Символ контракта так, как его записывает биржа.
perp.contracts[].quote	string	—	Валюта котировки контракта.
perp.contracts[].margin_type	string	—	Тип маржи контракта (например, с маржой в USDT, с маржой в монете).
perp.contracts[].multiplier	number	—	Число монет на единицу котировки (1000 для контрактов вида `1000PEPE`). На базис не влияет.
perp.contracts[].mark_price	number\|null	—	Цена маркировки, опубликованная биржей.
perp.contracts[].index_price	number\|null	—	Индексная цена, опубликованная биржей.
perp.contracts[].last_price	number\|null	—	Цена последней сделки.
perp.contracts[].index_kind	string\|null	—	Что представляет собой индекс: `exchange_index`, `oracle` или иной вид, который показывается, но не агрегируется.
perp.contracts[].basis_pct	number\|null	%	(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
perp.contracts[].basis_abs	number\|null	—	mark − index, в валюте котировки.
perp.contracts[].basis_last_pct	number\|null	%	(last − index) ÷ index × 100; `null`, если недавних сделок нет.
perp.contracts[].basis_last_reason	string\|null	—	Почему `basis_last_pct` равно null.
perp.contracts[].index_lag_s	number\|null	s	Число секунд между меткой времени цены маркировки и меткой времени индекса в строке.
perp.contracts[].oi_usd	number\|null	USD	Открытый интерес контракта, односторонний; используется как вес.
perp.contracts[].vol_usd_24h	number\|null	USD	Номинальный объём контракта за 24h; используется как вес.
perp.contracts[].primary	boolean	—	True для контракта, который представляет свою биржу в медиане и среднем.
perp.contracts[].in_aggregate	boolean	—	True, если строка прошла правила включения.
perp.contracts[].excluded_reason	string\|null	—	Почему строка не входит в агрегат.
perp.contracts[].last_ts	number\|null	ms	Время последней сделки.
perp.contracts[].observed_at	number\|null	ms	Метка времени, указанная источником для данных.
perp.contracts[].received_at	number	ms	Время получения данных коллектором CoinBoss.
perp.contracts[].age_s	number	s	Число секунд с момента получения строки.
spot_perp	object	—	Цена бессрочного контракта относительно спотовой цены той же биржи.
spot_perp.unit	string	—	Единица значений базиса (проценты).
spot_perp.aggregate	object	—	Агрегат раздела по всем биржам.
spot_perp.aggregate.oi_weighted_pct	number	%	Базис, взвешенный по открытому интересу; строки без веса OI не учитываются.
spot_perp.aggregate.oi_weight_usd	number	USD	Сумма использованных весов открытого интереса.
spot_perp.aggregate.n_oi_weighted	number	—	Строки, у которых был вес OI.
spot_perp.aggregate.vol_weighted_pct	number	%	Базис, взвешенный по номинальному объёму за 24h.
spot_perp.aggregate.vol_weight_usd	number	USD	Сумма использованных весов объёма.
spot_perp.aggregate.n_vol_weighted	number	—	Строки, у которых был вес объёма.
spot_perp.aggregate.median_pct	number	%	Медиана базиса по одному основному контракту на биржу.
spot_perp.aggregate.mean_pct	number	%	Простое среднее по тому же набору, что и медиана.
spot_perp.aggregate.n_exchanges	number	—	Биржи в агрегате.
spot_perp.aggregate.n_contracts	number	—	Контракты в агрегате.
spot_perp.aggregate.min	object	—	Биржа и контракт с наименьшим базисом.
spot_perp.aggregate.min.exchange	string	—	Идентификатор биржи (в нижнем регистре).
spot_perp.aggregate.min.symbol	string	—	Символ контракта в формате хранения CoinBoss.
spot_perp.aggregate.min.basis_pct	number	%	(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
spot_perp.aggregate.max	object	—	Биржа и контракт с наибольшим базисом.
spot_perp.aggregate.max.exchange	string	—	Идентификатор биржи (в нижнем регистре).
spot_perp.aggregate.max.symbol	string	—	Символ контракта в формате хранения CoinBoss.
spot_perp.aggregate.max.basis_pct	number	%	(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
spot_perp.pairs	array	—	Одна строка на пару «бессрочный контракт / спот» одной и той же биржи.
spot_perp.pairs[]	object	—	Одна строка на пару «бессрочный контракт / спот» одной и той же биржи.
spot_perp.pairs[].exchange	string	—	Идентификатор биржи (в нижнем регистре).
spot_perp.pairs[].symbol	string	—	Символ контракта в формате хранения CoinBoss.
spot_perp.pairs[].spot_symbol	string	—	Спотовый рынок, использованный как спотовая составляющая.
spot_perp.pairs[].quote	string	—	Валюта котировки контракта.
spot_perp.pairs[].spot_mult	number	—	Коэффициент, применяемый к спотовой цене, чтобы обе составляющие котировали одно и то же количество.
spot_perp.pairs[].futures_price	number\|null	—	Использованная цена бессрочного контракта; см. `price_kind`.
spot_perp.pairs[].price_kind	string\|null	—	Какая цена бессрочного контракта использована: `last` или `mark`.
spot_perp.pairs[].spot_price	number	—	Последняя спотовая цена после применения `spot_mult`.
spot_perp.pairs[].basis_pct	number\|null	%	(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
spot_perp.pairs[].basis_last_pct	number\|null	%	(last − index) ÷ index × 100; `null`, если недавних сделок нет.
spot_perp.pairs[].basis_mark_pct	number\|null	%	(mark − spot) ÷ spot × 100.
spot_perp.pairs[].leg_gap_s	number	s	Число секунд между метками времени двух составляющих.
spot_perp.pairs[].spot_time_kind	string	—	Что представляет собой спотовая метка времени (время сделки или время получения).
spot_perp.pairs[].spot_vol_24h	number\|null	—	Оборот спотового рынка за 24h в его валюте котировки.
spot_perp.pairs[].oi_usd	number\|null	USD	Открытый интерес контракта, односторонний; используется как вес.
spot_perp.pairs[].vol_usd_24h	number\|null	USD	Номинальный объём контракта за 24h; используется как вес.
spot_perp.pairs[].primary	boolean	—	True для контракта, который представляет свою биржу в медиане и среднем.
spot_perp.pairs[].in_aggregate	boolean	—	True, если строка прошла правила включения.
spot_perp.pairs[].excluded_reason	string\|null	—	Почему строка не входит в агрегат.
spot_perp.pairs[].received_at	number	ms	Время получения данных коллектором CoinBoss.
spot_perp.pairs[].spot_received_at	number	ms	Время получения спотовой составляющей.
delivery	object	—	Базис срочных (поставочных) фьючерсов.
delivery.unit	string	—	Единица значений базиса (проценты).
delivery.contracts	array	—	Одна строка на контракт.
delivery.contracts[]	object	—	Одна строка на контракт.
delivery.contracts[].exchange	string	—	Идентификатор биржи (в нижнем регистре).
delivery.contracts[].symbol	string	—	Символ контракта в формате хранения CoinBoss.
delivery.contracts[].native_symbol	string	—	Символ контракта так, как его записывает биржа.
delivery.contracts[].quote	string	—	Валюта котировки контракта.
delivery.contracts[].margin_type	string	—	Тип маржи контракта (например, с маржой в USDT, с маржой в монете).
delivery.contracts[].expiry_ts	number	ms	Время экспирации срочного контракта.
delivery.contracts[].days_to_expiry	number	days	Число дней до экспирации.
delivery.contracts[].mark_price	number	—	Цена маркировки, опубликованная биржей.
delivery.contracts[].last_price	number\|null	—	Цена последней сделки.
delivery.contracts[].index_price	number	—	Индексная цена, опубликованная биржей.
delivery.contracts[].index_kind	string	—	Что представляет собой индекс: `exchange_index`, `oracle` или иной вид, который показывается, но не агрегируется.
delivery.contracts[].basis_pct	number	%	(mark − index) ÷ index × 100 для бессрочных и срочных контрактов; в рейтингах — медиана по биржам.
delivery.contracts[].annualized_pct	number\|null	% per year	basis_pct × 365 ÷ число дней до экспирации, простые проценты; `null` в течение последнего дня.
delivery.contracts[].basis_reason	null	—	Почему `basis_pct` равно null.
delivery.contracts[].index_lag_s	number	s	Число секунд между меткой времени цены маркировки и меткой времени индекса в строке.
delivery.contracts[].basis_last_pct	number\|null	%	(last − index) ÷ index × 100; `null`, если недавних сделок нет.
delivery.contracts[].annualized_last_pct	number\|null	% per year	Базис в годовом выражении по цене последней сделки.
delivery.contracts[].spot_symbol	string\|null	—	Спотовый рынок, использованный как спотовая составляющая.
delivery.contracts[].spot_price	number\|null	—	Последняя спотовая цена после применения `spot_mult`.
delivery.contracts[].spot_price_kind	string\|null	—	Какая цена фьючерса сравнивалась со спотом.
delivery.contracts[].basis_spot_pct	number\|null	%	(futures − спот той же биржи) ÷ spot × 100.
delivery.contracts[].annualized_spot_pct	number\|null	% per year	Базис в годовом выражении относительно спота той же биржи.
delivery.contracts[].annualized_reason	string\|null	—	Почему значение в годовом выражении равно null (например, `expiry_lt_1d`).
delivery.contracts[].oi_usd	number\|null	USD	Открытый интерес контракта, односторонний; используется как вес.
delivery.contracts[].vol_usd_24h	number\|null	USD	Номинальный объём контракта за 24h; используется как вес.
delivery.contracts[].last_ts	number\|null	ms	Время последней сделки.
delivery.contracts[].observed_at	number\|null	ms	Метка времени, указанная источником для данных.
delivery.contracts[].received_at	number	ms	Время получения данных коллектором CoinBoss.
delivery.contracts[].age_s	number	s	Число секунд с момента получения строки.
coverage	object	—	Что входит и что не входит в эти значения. Сверьтесь с этим блоком, прежде чем сравнивать итоги с другим источником.
coverage.included_exchanges	array	—	Источники, актуальные данные которых учтены.
coverage.included_exchanges[]	string	—	Источники, актуальные данные которых учтены.
coverage.unavailable	array	—	Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0.
coverage.unavailable[]	object	—	Источники, которые не удалось включить, с указанием причины для каждого. Они никогда не учитываются как 0.
coverage.unavailable[].exchange	string	—	Идентификатор биржи (в нижнем регистре).
coverage.unavailable[].reason	string	—	Машиночитаемый код причины.
coverage.unavailable[].detail	string	—	Понятное человеку объяснение причины.
coverage.stale_excluded	array	—	Строки, не учтённые потому, что их последнее обновление выходит за окно актуальности. пусто в образцах, по которым построена таблица
coverage.missing_fields	array	—	Биржи, которые не публикуют одну из цен.
coverage.excluded_from_aggregate	array	—	Строки, которые показаны, но не включены в агрегат, с указанием причины для каждой.
coverage.excluded_from_aggregate[]	object	—	Строки, которые показаны, но не включены в агрегат, с указанием причины для каждой.
coverage.excluded_from_aggregate[].exchange	string	—	Идентификатор биржи (в нижнем регистре).
coverage.excluded_from_aggregate[].symbol	string	—	Символ контракта в формате хранения CoinBoss.
coverage.excluded_from_aggregate[].section	string	—	Раздел, к которому относится строка.
coverage.excluded_from_aggregate[].reason	string	—	Машиночитаемый код причины.
coverage.stock_excluded	array	—	Бессрочные контракты на акции с тем же тикером, которые были удалены. пусто в образцах, по которым построена таблица
coverage.dropped_delisted_rows	number	—	Строки, отброшенные потому, что контракт перестал обновляться.
coverage.delivery_unavailable	array	—	Биржи, срочные контракты которых не собираются.
coverage.delivery_unavailable[]	object	—	Биржи, срочные контракты которых не собираются.
coverage.delivery_unavailable[].exchange	string	—	Идентификатор биржи (в нижнем регистре).
coverage.delivery_unavailable[].reason	string	—	Машиночитаемый код причины.
coverage.delivery_unavailable[].detail	string	—	Понятное человеку объяснение причины.
method	object	—	Текстовое описание формул, использованных для этого ответа, по одной записи на поле.
method.perp.basis_pct	string	—	Пояснение к формуле для `perp.basis_pct`, обычный текст.
method.perp.basis_last_pct	string	—	Пояснение к формуле для `perp.basis_last_pct`, обычный текст.
method.perp.aggregate.oi_weighted_pct	string	—	Пояснение к формуле для `perp.aggregate.oi_weighted_pct`, обычный текст.
method.perp.aggregate.vol_weighted_pct	string	—	Пояснение к формуле для `perp.aggregate.vol_weighted_pct`, обычный текст.
method.perp.aggregate.median_pct	string	—	Пояснение к формуле для `perp.aggregate.median_pct`, обычный текст.
method.perp.aggregate.inclusion	string	—	Пояснение к формуле для `perp.aggregate.inclusion`, обычный текст.
method.spot_perp.basis_pct	string	—	Пояснение к формуле для `spot_perp.basis_pct`, обычный текст.
method.spot_perp.aggregate.inclusion	string	—	Пояснение к формуле для `spot_perp.aggregate.inclusion`, обычный текст.
method.delivery.basis_pct	string	—	Пояснение к формуле для `delivery.basis_pct`, обычный текст.
method.delivery.annualized_pct	string	—	Пояснение к формуле для `delivery.annualized_pct`, обычный текст.
method.index_lag_s	string	—	Пояснение к формуле для `index_lag_s`, обычный текст.
method.multiplier	string	—	Пояснение к формуле для `multiplier`, обычный текст.
meta	object	—	Происхождение данных и актуальность этого ответа.
meta.schema	string	—	Идентификатор схемы этого ответа. Меняется только тогда, когда у существующего поля меняется смысл или тип.
meta.source	array	—	Публичные эндпоинты источников, из которых собраны данные.
meta.source[]	object	—	Публичные эндпоинты источников, из которых собраны данные.
meta.source[].exchange	string	—	Идентификатор биржи (в нижнем регистре).
meta.source[].endpoint	string	—	Публичный эндпоинт источника, который читает коллектор (показан для сведений о происхождении данных; клиенты его не вызывают).
meta.observed_at	number	ms	Метка времени, указанная источником для данных.
meta.received_at	number	ms	Время получения данных коллектором CoinBoss.
meta.fetched_at	number	ms	Время формирования этого ответа.
meta.window	string	—	Временное окно, которое охватывают значения.
meta.quality	string	—	FRESH, PARTIAL, STALE, BROKEN или UNAVAILABLE — оценка по меткам времени данных и покрытию.
meta.is_stale	boolean	—	True, если данные старше своего окна актуальности.
meta.cache_ttl_s	number	s	Время жизни кеша этого ответа.
meta.fallback	string	—	Что возвращает эндпоинт при сбое коллектора или источника.
meta.collector_heartbeat_age_s	number	s	Число секунд с последнего сообщения коллектора о том, что он работает.
coverage.missing_fields[]	object	—	Биржи, которые не публикуют одну из цен.
coverage.missing_fields[].exchange	string	—	Идентификатор биржи (в нижнем регистре).
coverage.missing_fields[].symbol	string	—	Символ контракта в формате хранения CoinBoss.
coverage.missing_fields[].missing	string	—	Цена, которую биржа не публикует (`mark` или `index`).

Сформировано 2026-11-11 23:00 UTC; использовано реальных ответов: 4.

Пример ответа

/api/sd/basis?coin=BTC · Реальный ответ, получен 2026-11-13 03:52:48 UTC. Длинные массивы и словари сокращены для отображения: meta.source: элементов было 20; perp.contracts: элементов было 37; spot_perp.pairs: элементов было 22; delivery.contracts: элементов было 53; coverage.unavailable: элементов было 4; coverage.included_exchanges: элементов было 20.

{
- "success": true,
- "schema": "coinboss.sd.basis/1",
- "now": 1794541956692,
- "coin": "BTC",
- "perp": {
  - "unit": "percent",
  - "aggregate": { … 15 },
  - "contracts": [ … 1 ]
  },
- "spot_perp": {
  - "unit": "percent",
  - "aggregate": { … 12 },
  - "pairs": [ … 1 ]
  },
- "delivery": {
  - "unit": "percent",
  - "contracts": [ … 1 ]
  },
- "coverage": {
  - "included_exchanges": [ … 8 ],
  - "unavailable": [ … 1 ],
  - "stale_excluded": [],
  - "missing_fields": [],
  - "excluded_from_aggregate": [ … 1 ],
  - "stock_excluded": [],
  - "dropped_delisted_rows": 0,
  - "delivery_unavailable": [ … 1 ]
  },
- "method": {
  - "perp.basis_pct": "(mark_price - index_price) / index_price * 100, percent; mark and index are both published by the same exchange for that…",
  - "perp.basis_last_pct": "(last_price - index_price) / index_price * 100; null when the exchange gives no last-trade price or the last trade is mo…",
  - "perp.aggregate.oi_weighted_pct": "sum(basis_pct * oi_usd) / sum(oi_usd) over all included perpetual contracts that have an open-interest weight; oi_usd fr…",
  - "perp.aggregate.vol_weighted_pct": "same with 24h notional volume (market_tickers.volume_usd / sd_contract_latest.vol_usd_24h, <= 1 h old) as weight",
  - "perp.aggregate.median_pct": "median of basis_pct over one primary contract per exchange (largest OI, then volume, then USDT-margined); mean_pct is th…",
  - "perp.aggregate.inclusion": "row is fresh (<= 180 s), basis_pct is not null, index_kind is exchange_index or oracle, the contract traded within 24 h …",
  - "spot_perp.basis_pct": "(perp last_price, or mark_price when last is unusable - spot last price * spot_mult) / (spot last price * spot_mult) * 1…",
  - "spot_perp.aggregate.inclusion": "as perp, plus spot 24h turnover >= 10000 (quote currency) when the exchange reports it",
  - "delivery.basis_pct": "(F - S) / S * 100 with F = mark_price and S = the exchange index price of the underlying; basis_last_pct uses F = last_p…",
  - "delivery.annualized_pct": "basis_pct * 365 / days_to_expiry, simple (not compounded); null when days_to_expiry < 1; days_to_expiry = (expiry_ts - p…",
  - "index_lag_s": "seconds between the mark timestamp and the index timestamp of the row; 0 when the exchange returns both in one response;…",
  - "multiplier": "contract units per coin (1000PEPE, kPEPE = 1000); mark and index carry the same multiplier so basis_pct is unaffected; s…"
  },
- "meta": {
  - "schema": "coinboss.sd.basis/1",
  - "source": [ … 1 ],
  - "observed_at": 1794539247345,
  - "received_at": 1794539247425,
  - "fetched_at": 1794541956692,
  - "window": "latest",
  - "quality": "STALE",
  - "is_stale": true,
  - "cache_ttl_s": 20,
  - "fallback": "rows older than 180 s are excluded; if no exchange is fresh the last stored rows (<= 1 h old) are served with is_stale=t…",
  - "collector_heartbeat_age_s": 2759
  }
}

Проверенные образцы

Помимо примера выше, автопроверка вызывает этот эндпоинт с указанными параметрами и каждый раз сверяет схему.

Параметры	HTTP	Задержка	Результат
coin=ETH	200	28 ms	Пройдено STALE
coin=SOL	200	26 ms	Пройдено STALE
coin=PEPE	200	26 ms	Пройдено STALE
—	400	2 ms	Пройдено возвращает ожидаемую ошибку

Проверено: 2026-11-13 03:28:06 UTC

Сведения

Аутентификация: Не требуется. Публичный эндпоинт.
Лимит запросов: 1200 запросов в минуту на один IP
Серверный кеш: 20s
Пограничный микрокеш: 10s
Частота обновления: Цикл коллектора — каждые 60 секунд; строка считается актуальной 180 секунд. Историю формируют почасовые снимки.
Окно: Последнее значение по каждому контракту.
Источники данных: Цена маркировки, индексная цена и последняя цена, публикуемые 21 биржей деривативов, а также спотовая цена той же биржи; данные собирает и хранит CoinBoss (sd_px_latest, sd_px_hourly).
Покрытие бирж: 21 биржа. Биржи, не публикующие индексную цену или цену маркировки, перечислены в `coverage.unavailable`; строки, у которых две ценовые составляющие разнесены более чем на 60 секунд, возвращают `null`. Строки, не включённые в агрегат, перечислены в `coverage.excluded_from_aggregate` с указанием причины.
Пагинация: Пагинации нет.
Сортировка: Сначала контракты с наибольшим открытым интересом.
Единицы измерения: All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
Метод расчёта: Perpetual: basis_pct = (mark − index) ÷ index × 100. Spot-perp: (perpetual price − spot price) ÷ spot price × 100, same exchange and quote currency. Delivery: basis_pct = (futures − index) ÷ index × 100; annualized_pct = basis_pct × 365 ÷ days to expiry (simple interest; `null` inside the last day). Aggregates use one primary contract per exchange; a row enters only if it is fresh, traded within 24 hours and |basis| ≤ 10 %.
Метки времени: Миллисекунды эпохи Unix (UTC), если в описании поля не указано иное
Формат ответа: json
Стабильность: Стабильный
Доступен с: 2026-11-11

Текущий статус

ДеградацияПроверено: 2026-11-13 03:52:48 UTCHTTP 2001 msСхема совпадаетВозраст самой новой точки данных: 45m

Эндпоинт сообщает качество данных STALE

Доступность за последние 30 дней

Пройдено 100% из 406 проверок

Ошибки

Неудачные вызовы имеют одинаковую структуру на всех эндпоинтах. Полный список приведён на странице ошибок. Ошибки и лимиты запросов →

Код	HTTP	Значение	Что делать
INVALID_PARAM	400	Отсутствует обязательный параметр, или значение не принимается. `param` называет параметр, если он известен.	Не повторяйте запрос без изменений; исправьте его.
UNAUTHORIZED	401	Заголовок `CB-API-KEY` был отправлен, но ключ неизвестен или отозван. Для публичных данных ключ не нужен — уберите заголовок или используйте действительный ключ.	Не повторяйте запрос без изменений.
FORBIDDEN	403	Маршрут не входит в публичный API (внутренний или только для аккаунта).	Не повторяйте запрос.
NOT_FOUND	404	Неизвестный маршрут, либо запрошенная монета / биржа / фонд не существует.	Не повторяйте запрос; сверьте путь и идентификаторы с каталогом.
RATE_LIMITED	429	Запросов больше, чем позволяет поминутный лимит. `Retry-After` указывает, сколько секунд нужно подождать.	Дождитесь истечения `Retry-After`, затем повторите запрос с нарастающей задержкой.
INTERNAL	500	Непредвиденная ошибка сервера. Сообщение намеренно общее; при обращении указывайте `request_id`.	Повторите запрос один раз через несколько секунд; если ошибка сохраняется, сообщите о ней, указав ID запроса.
UPSTREAM_FAILED	503	Источник данных, стоящий за этим эндпоинтом, не ответил вовремя. Устаревшие или подменные значения вместо него не возвращаются.	Повторите запрос с нарастающей задержкой; проверьте страницу статуса.
UNAVAILABLE	501 / 503	Набор данных временно не готов (прогрев кеша), либо у эндпоинта пока нет законного публичного источника.	Повторите запрос позже; каталог помечает эндпоинты, недоступные по проектному решению.
REQUEST_FAILED	200	Некоторые более старые эндпоинты отвечают HTTP 200 с `success: false`. Всегда проверяйте `success`, а не только статус HTTP.	Зависит от сообщения; считайте запрос неудачным.

Попробовать

GET/api/sd/basisДеградация

Параметры

coin Обязательный

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

URL запросаhttps://www.coinboss.com/api/sd/basis?coin=BTC

Выберите эндпоинт и нажмите «Отправить запрос». Здесь появятся ответ, заголовки и время выполнения.

Базис фьючерсов (все площадки) /api/sd/basis
История базиса (почасовая) /api/sd/basis/history
Рейтинг монет по базису /api/sd/basis/rank
Список базиса фьючерсов к споту /api/derivatives/basis
Дневной спред цены BTC между Coinbase и Kraken /api/p3/cb-kr-spread
Индекс премии Bitcoin на Coinbase /api/p3/coinbase-premium
Список индекса премии бессрочных контрактов /api/p3/premium-index
История индекса премии по одной монете /api/p3/premium-index/history
Свечи индекса премии /api/p3/premium-index/klines
Внебиржевая (OTC) премия USDT к курсам фиатных валют /api/usdt-premium
Полный список базиса фьючерсов к споту /api/basis/list