24h 거래량—미결제약정—24h 청산$1.36B24h 롱/숏—BTC 점유율—ETH 점유율—
앱
언어 ▾
₩ KRW ▾
/api/sd/basis
GET저하STALE

선물 베이시스(전체 거래소)

계약별 무기한 선물 베이시스(마크 가격 대 지수 가격), 같은 거래소의 무기한 선물-현물 베이시스, 연환산 수익률을 포함한 만기 선물 베이시스와 함께 OI 가중·거래량 가중·중앙값 집계를 제공합니다.

GET/api/sd/basis
저하. 엔드포인트가 보고한 데이터 품질: STALE

요청

쿼리 파라미터

이름타입필수기본값허용 값설명
coinstring필수——코인 심볼, 대소문자 구분 없음(예: `BTC`). 값이 없거나 형식이 잘못되면 400을 반환합니다. 예시: BTC

요청 예시

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

응답 필드

필드 표는 실제 응답에서 생성되므로 엔드포인트가 반환하는 내용을 그대로 보여 줍니다. 경로에서 a[]는 배열 항목을, {*}는 코인이나 거래소처럼 동적 이름을 키로 갖는 객체를 뜻합니다.

필드타입단위설명
successboolean—요청이 성공하면 true입니다. 실패하면 본문은 `{ success: false, code, error, request_id }`입니다.
schemastring—이 응답의 스키마 ID. 기존 필드의 의미나 타입이 바뀔 때만 변경됩니다.
nownumberms응답이 생성된 서버 시각.
coinstring—코인 심볼(대문자).
perpobject—무기한 선물 베이시스: 같은 거래소의 지수 가격 대비 마크 가격.
perp.unitstring—베이시스 값의 단위(퍼센트).
perp.aggregateobject—해당 섹션의 거래소 간 집계.
perp.aggregate.oi_weighted_pctnumber%미결제약정으로 가중한 베이시스. OI 가중치가 없는 행은 제외됩니다.
perp.aggregate.oi_weight_usdnumberUSD사용된 미결제약정 가중치의 합계.
perp.aggregate.n_oi_weightednumber—OI 가중치가 있는 행.
perp.aggregate.vol_weighted_pctnumber%24h 명목 거래량으로 가중한 베이시스.
perp.aggregate.vol_weight_usdnumberUSD사용된 거래량 가중치의 합계.
perp.aggregate.n_vol_weightednumber—거래량 가중치가 있는 행.
perp.aggregate.median_pctnumber%거래소당 주 계약 하나를 대상으로 한 베이시스 중앙값.
perp.aggregate.mean_pctnumber%중앙값과 동일한 집합에 대한 단순 평균.
perp.aggregate.n_exchangesnumber—집계에 포함된 거래소.
perp.aggregate.n_contractsnumber—집계에 포함된 계약.
perp.aggregate.minobject—베이시스가 가장 낮은 거래소와 계약.
perp.aggregate.min.exchangestring—거래소 ID(소문자).
perp.aggregate.min.symbolstring—CoinBoss 저장 형식의 계약 심볼.
perp.aggregate.min.basis_pctnumber%무기한 선물과 만기 선물은 (mark − index) ÷ index × 100. 순위에서는 거래소 간 중앙값.
perp.aggregate.maxobject—베이시스가 가장 높은 거래소와 계약.
perp.aggregate.max.exchangestring—거래소 ID(소문자).
perp.aggregate.max.symbolstring—CoinBoss 저장 형식의 계약 심볼.
perp.aggregate.max.basis_pctnumber%무기한 선물과 만기 선물은 (mark − index) ÷ index × 100. 순위에서는 거래소 간 중앙값.
perp.aggregate.median_last_pctnumber%최종 체결가 베이시스의 중앙값.
perp.aggregate.n_exchanges_lastnumber—최종 체결가 중앙값에 포함된 거래소.
perp.aggregate.weightsobject—가중치의 출처, 가중치의 신선도 창, 가장 오래된 가중치의 경과 시간.
perp.aggregate.weights.oiobject—미결제약정.
perp.aggregate.weights.oi.sourcestring—데이터를 수집한 업스트림 공개 엔드포인트.
perp.aggregate.weights.oi.fresh_window_snumbers이보다 오래된 가중치는 사용하지 않습니다.
perp.aggregate.weights.oi.oldest_age_snumbers사용된 가장 오래된 가중치의 경과 시간.
perp.aggregate.weights.oi.sidestring—미결제약정 가중치가 단방향 기준인지 여부.
perp.aggregate.weights.volobject—거래량.
perp.aggregate.weights.vol.sourcestring—데이터를 수집한 업스트림 공개 엔드포인트.
perp.aggregate.weights.vol.fresh_window_snumbers이보다 오래된 가중치는 사용하지 않습니다.
perp.aggregate.weights.vol.oldest_age_snumbers사용된 가장 오래된 가중치의 경과 시간.
perp.contractsarray—계약당 한 행.
perp.contracts[]object—계약당 한 행.
perp.contracts[].exchangestring—거래소 ID(소문자).
perp.contracts[].symbolstring—CoinBoss 저장 형식의 계약 심볼.
perp.contracts[].native_symbolstring—거래소가 표기하는 그대로의 계약 심볼.
perp.contracts[].quotestring—계약의 호가 통화.
perp.contracts[].margin_typestring—계약의 증거금 유형(예: USDT 마진, 코인 마진).
perp.contracts[].multipliernumber—호가 단위당 코인 수(`1000PEPE` 형태의 계약은 1000). 베이시스에는 영향이 없습니다.
perp.contracts[].mark_pricenumber|null—거래소가 공시한 마크 가격.
perp.contracts[].index_pricenumber|null—거래소가 공시한 지수 가격.
perp.contracts[].last_pricenumber|null—최종 체결가.
perp.contracts[].index_kindstring|null—지수의 종류: `exchange_index`, `oracle`, 또는 표시는 되지만 집계하지 않는 그 밖의 종류.
perp.contracts[].basis_pctnumber|null%무기한 선물과 만기 선물은 (mark − index) ÷ index × 100. 순위에서는 거래소 간 중앙값.
perp.contracts[].basis_absnumber|null—mark − index, 호가 통화 기준.
perp.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100. 최근 체결이 없으면 `null`입니다.
perp.contracts[].basis_last_reasonstring|null—`basis_last_pct`가 null인 이유.
perp.contracts[].index_lag_snumber|nulls행의 마크 타임스탬프와 지수 타임스탬프 사이의 초.
perp.contracts[].oi_usdnumber|nullUSD계약의 미결제약정, 단방향 기준. 가중치로 사용됩니다.
perp.contracts[].vol_usd_24hnumber|nullUSD계약의 24h 명목 거래량. 가중치로 사용됩니다.
perp.contracts[].primaryboolean—중앙값과 평균에서 해당 거래소를 대표하는 계약이면 true.
perp.contracts[].in_aggregateboolean—행이 포함 규칙을 통과했으면 true.
perp.contracts[].excluded_reasonstring|null—행이 집계에 포함되지 않은 이유.
perp.contracts[].last_tsnumber|nullms마지막 체결 시각.
perp.contracts[].observed_atnumber|nullms소스가 데이터에 부여한 타임스탬프.
perp.contracts[].received_atnumbermsCoinBoss 수집기가 데이터를 수신한 시각.
perp.contracts[].age_snumbers행을 수신한 이후 경과한 초.
spot_perpobject—같은 거래소의 현물 가격 대비 무기한 선물 가격.
spot_perp.unitstring—베이시스 값의 단위(퍼센트).
spot_perp.aggregateobject—해당 섹션의 거래소 간 집계.
spot_perp.aggregate.oi_weighted_pctnumber%미결제약정으로 가중한 베이시스. OI 가중치가 없는 행은 제외됩니다.
spot_perp.aggregate.oi_weight_usdnumberUSD사용된 미결제약정 가중치의 합계.
spot_perp.aggregate.n_oi_weightednumber—OI 가중치가 있는 행.
spot_perp.aggregate.vol_weighted_pctnumber%24h 명목 거래량으로 가중한 베이시스.
spot_perp.aggregate.vol_weight_usdnumberUSD사용된 거래량 가중치의 합계.
spot_perp.aggregate.n_vol_weightednumber—거래량 가중치가 있는 행.
spot_perp.aggregate.median_pctnumber%거래소당 주 계약 하나를 대상으로 한 베이시스 중앙값.
spot_perp.aggregate.mean_pctnumber%중앙값과 동일한 집합에 대한 단순 평균.
spot_perp.aggregate.n_exchangesnumber—집계에 포함된 거래소.
spot_perp.aggregate.n_contractsnumber—집계에 포함된 계약.
spot_perp.aggregate.minobject—베이시스가 가장 낮은 거래소와 계약.
spot_perp.aggregate.min.exchangestring—거래소 ID(소문자).
spot_perp.aggregate.min.symbolstring—CoinBoss 저장 형식의 계약 심볼.
spot_perp.aggregate.min.basis_pctnumber%무기한 선물과 만기 선물은 (mark − index) ÷ index × 100. 순위에서는 거래소 간 중앙값.
spot_perp.aggregate.maxobject—베이시스가 가장 높은 거래소와 계약.
spot_perp.aggregate.max.exchangestring—거래소 ID(소문자).
spot_perp.aggregate.max.symbolstring—CoinBoss 저장 형식의 계약 심볼.
spot_perp.aggregate.max.basis_pctnumber%무기한 선물과 만기 선물은 (mark − index) ÷ index × 100. 순위에서는 거래소 간 중앙값.
spot_perp.pairsarray—같은 거래소의 무기한 선물 / 현물 쌍당 한 행.
spot_perp.pairs[]object—같은 거래소의 무기한 선물 / 현물 쌍당 한 행.
spot_perp.pairs[].exchangestring—거래소 ID(소문자).
spot_perp.pairs[].symbolstring—CoinBoss 저장 형식의 계약 심볼.
spot_perp.pairs[].spot_symbolstring—현물 레그로 사용된 현물 시장.
spot_perp.pairs[].quotestring—계약의 호가 통화.
spot_perp.pairs[].spot_multnumber—두 레그가 같은 수량을 기준으로 호가되도록 현물 가격에 적용하는 계수.
spot_perp.pairs[].futures_pricenumber|null—사용된 무기한 선물 가격. `price_kind`를 참조하십시오.
spot_perp.pairs[].price_kindstring|null—사용된 무기한 선물 가격의 종류: `last` 또는 `mark`.
spot_perp.pairs[].spot_pricenumber—`spot_mult` 적용 후의 현물 최종 체결가.
spot_perp.pairs[].basis_pctnumber|null%무기한 선물과 만기 선물은 (mark − index) ÷ index × 100. 순위에서는 거래소 간 중앙값.
spot_perp.pairs[].basis_last_pctnumber|null%(last − index) ÷ index × 100. 최근 체결이 없으면 `null`입니다.
spot_perp.pairs[].basis_mark_pctnumber|null%(mark − spot) ÷ spot × 100.
spot_perp.pairs[].leg_gap_snumbers두 레그의 타임스탬프 사이의 초.
spot_perp.pairs[].spot_time_kindstring—현물 타임스탬프의 의미(체결 시각 또는 수신 시각).
spot_perp.pairs[].spot_vol_24hnumber|null—현물 시장의 24h 거래대금, 해당 시장의 호가 통화 기준.
spot_perp.pairs[].oi_usdnumber|nullUSD계약의 미결제약정, 단방향 기준. 가중치로 사용됩니다.
spot_perp.pairs[].vol_usd_24hnumber|nullUSD계약의 24h 명목 거래량. 가중치로 사용됩니다.
spot_perp.pairs[].primaryboolean—중앙값과 평균에서 해당 거래소를 대표하는 계약이면 true.
spot_perp.pairs[].in_aggregateboolean—행이 포함 규칙을 통과했으면 true.
spot_perp.pairs[].excluded_reasonstring|null—행이 집계에 포함되지 않은 이유.
spot_perp.pairs[].received_atnumbermsCoinBoss 수집기가 데이터를 수신한 시각.
spot_perp.pairs[].spot_received_atnumberms현물 레그를 수신한 시각.
deliveryobject—만기 선물 베이시스.
delivery.unitstring—베이시스 값의 단위(퍼센트).
delivery.contractsarray—계약당 한 행.
delivery.contracts[]object—계약당 한 행.
delivery.contracts[].exchangestring—거래소 ID(소문자).
delivery.contracts[].symbolstring—CoinBoss 저장 형식의 계약 심볼.
delivery.contracts[].native_symbolstring—거래소가 표기하는 그대로의 계약 심볼.
delivery.contracts[].quotestring—계약의 호가 통화.
delivery.contracts[].margin_typestring—계약의 증거금 유형(예: USDT 마진, 코인 마진).
delivery.contracts[].expiry_tsnumberms만기 선물 계약의 만기 시각.
delivery.contracts[].days_to_expirynumberdays만기일까지 남은 일수.
delivery.contracts[].mark_pricenumber—거래소가 공시한 마크 가격.
delivery.contracts[].last_pricenumber|null—최종 체결가.
delivery.contracts[].index_pricenumber—거래소가 공시한 지수 가격.
delivery.contracts[].index_kindstring—지수의 종류: `exchange_index`, `oracle`, 또는 표시는 되지만 집계하지 않는 그 밖의 종류.
delivery.contracts[].basis_pctnumber%무기한 선물과 만기 선물은 (mark − index) ÷ index × 100. 순위에서는 거래소 간 중앙값.
delivery.contracts[].annualized_pctnumber|null% per yearbasis_pct × 365 ÷ 만기일까지 남은 일수, 단리. 마지막 하루 동안은 `null`입니다.
delivery.contracts[].basis_reasonnull—`basis_pct`가 null인 이유.
delivery.contracts[].index_lag_snumbers행의 마크 타임스탬프와 지수 타임스탬프 사이의 초.
delivery.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100. 최근 체결이 없으면 `null`입니다.
delivery.contracts[].annualized_last_pctnumber|null% per year최종 체결가를 사용한 연환산 베이시스.
delivery.contracts[].spot_symbolstring|null—현물 레그로 사용된 현물 시장.
delivery.contracts[].spot_pricenumber|null—`spot_mult` 적용 후의 현물 최종 체결가.
delivery.contracts[].spot_price_kindstring|null—현물과 비교한 선물 가격의 종류.
delivery.contracts[].basis_spot_pctnumber|null%(선물 − 같은 거래소 현물) ÷ 현물 × 100.
delivery.contracts[].annualized_spot_pctnumber|null% per year같은 거래소 현물 대비 연환산 베이시스.
delivery.contracts[].annualized_reasonstring|null—연환산 값이 null인 이유(예: `expiry_lt_1d`).
delivery.contracts[].oi_usdnumber|nullUSD계약의 미결제약정, 단방향 기준. 가중치로 사용됩니다.
delivery.contracts[].vol_usd_24hnumber|nullUSD계약의 24h 명목 거래량. 가중치로 사용됩니다.
delivery.contracts[].last_tsnumber|nullms마지막 체결 시각.
delivery.contracts[].observed_atnumber|nullms소스가 데이터에 부여한 타임스탬프.
delivery.contracts[].received_atnumbermsCoinBoss 수집기가 데이터를 수신한 시각.
delivery.contracts[].age_snumbers행을 수신한 이후 경과한 초.
coverageobject—수치에 포함된 것과 포함되지 않은 것. 다른 소스와 합계를 비교하기 전에 먼저 이 항목을 비교하십시오.
coverage.included_exchangesarray—최신 데이터가 포함된 소스.
coverage.included_exchanges[]string—최신 데이터가 포함된 소스.
coverage.unavailablearray—포함할 수 없었던 소스와 각각의 사유. 0으로 집계하는 일은 없습니다.
coverage.unavailable[]object—포함할 수 없었던 소스와 각각의 사유. 0으로 집계하는 일은 없습니다.
coverage.unavailable[].exchangestring—거래소 ID(소문자).
coverage.unavailable[].reasonstring—기계 판독용 사유 코드.
coverage.unavailable[].detailstring—사람이 읽을 수 있는 사유 설명.
coverage.stale_excludedarray—마지막 갱신이 신선도 창을 벗어나 제외된 행. 이 표를 생성한 샘플에서는 비어 있음
coverage.missing_fieldsarray—해당 가격 중 하나를 공시하지 않는 거래소.
coverage.excluded_from_aggregatearray—표시는 되지만 집계에서 제외된 행과 각각의 사유.
coverage.excluded_from_aggregate[]object—표시는 되지만 집계에서 제외된 행과 각각의 사유.
coverage.excluded_from_aggregate[].exchangestring—거래소 ID(소문자).
coverage.excluded_from_aggregate[].symbolstring—CoinBoss 저장 형식의 계약 심볼.
coverage.excluded_from_aggregate[].sectionstring—행이 속한 섹션.
coverage.excluded_from_aggregate[].reasonstring—기계 판독용 사유 코드.
coverage.stock_excludedarray—티커가 같아 제거된 주식 무기한 선물. 이 표를 생성한 샘플에서는 비어 있음
coverage.dropped_delisted_rowsnumber—계약의 갱신이 멈춰 제외된 행.
coverage.delivery_unavailablearray—만기 선물 계약을 수집하지 않는 거래소.
coverage.delivery_unavailable[]object—만기 선물 계약을 수집하지 않는 거래소.
coverage.delivery_unavailable[].exchangestring—거래소 ID(소문자).
coverage.delivery_unavailable[].reasonstring—기계 판독용 사유 코드.
coverage.delivery_unavailable[].detailstring—사람이 읽을 수 있는 사유 설명.
methodobject—이 응답에 사용된 산식을 필드당 한 항목씩 일반 텍스트로 기술한 내용.
method.perp.basis_pctstring—`perp.basis_pct`의 산식 설명, 일반 텍스트.
method.perp.basis_last_pctstring—`perp.basis_last_pct`의 산식 설명, 일반 텍스트.
method.perp.aggregate.oi_weighted_pctstring—`perp.aggregate.oi_weighted_pct`의 산식 설명, 일반 텍스트.
method.perp.aggregate.vol_weighted_pctstring—`perp.aggregate.vol_weighted_pct`의 산식 설명, 일반 텍스트.
method.perp.aggregate.median_pctstring—`perp.aggregate.median_pct`의 산식 설명, 일반 텍스트.
method.perp.aggregate.inclusionstring—`perp.aggregate.inclusion`의 산식 설명, 일반 텍스트.
method.spot_perp.basis_pctstring—`spot_perp.basis_pct`의 산식 설명, 일반 텍스트.
method.spot_perp.aggregate.inclusionstring—`spot_perp.aggregate.inclusion`의 산식 설명, 일반 텍스트.
method.delivery.basis_pctstring—`delivery.basis_pct`의 산식 설명, 일반 텍스트.
method.delivery.annualized_pctstring—`delivery.annualized_pct`의 산식 설명, 일반 텍스트.
method.index_lag_sstring—`index_lag_s`의 산식 설명, 일반 텍스트.
method.multiplierstring—`multiplier`의 산식 설명, 일반 텍스트.
metaobject—이 응답의 데이터 경로와 신선도.
meta.schemastring—이 응답의 스키마 ID. 기존 필드의 의미나 타입이 바뀔 때만 변경됩니다.
meta.sourcearray—데이터를 수집한 업스트림 공개 엔드포인트.
meta.source[]object—데이터를 수집한 업스트림 공개 엔드포인트.
meta.source[].exchangestring—거래소 ID(소문자).
meta.source[].endpointstring—수집기가 읽는 소스의 공개 엔드포인트(데이터 경로 표시용이며 클라이언트가 직접 호출하지 않음).
meta.observed_atnumberms소스가 데이터에 부여한 타임스탬프.
meta.received_atnumbermsCoinBoss 수집기가 데이터를 수신한 시각.
meta.fetched_atnumberms이 응답이 조립된 시각.
meta.windowstring—수치가 포괄하는 시간 구간.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN 또는 UNAVAILABLE. 데이터 타임스탬프와 커버리지로 판정합니다.
meta.is_staleboolean—데이터가 신선도 창보다 오래되었으면 true.
meta.cache_ttl_snumbers이 응답의 캐시 수명.
meta.fallbackstring—수집기나 소스에 장애가 발생했을 때 엔드포인트가 반환하는 내용.
meta.collector_heartbeat_age_snumbers수집기가 가동 중임을 마지막으로 보고한 이후 경과한 초.
coverage.missing_fields[]object—해당 가격 중 하나를 공시하지 않는 거래소.
coverage.missing_fields[].exchangestring—거래소 ID(소문자).
coverage.missing_fields[].symbolstring—CoinBoss 저장 형식의 계약 심볼.
coverage.missing_fields[].missingstring—거래소가 공시하지 않는 가격(`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=ETH20028 ms통과 STALE
coin=SOL20026 ms통과 STALE
coin=PEPE20026 ms통과 STALE
—4002 ms통과 예상된 오류 반환

2026-11-13 03:28:06 UTC 점검

상세 정보

인증
없음. 공개 엔드포인트.
요청 한도
IP당 분당 1200회
서버 캐시
20s
엣지 마이크로 캐시
10s
갱신 주기
수집기는 60초마다 한 차례 실행되며, 행은 180초 동안 최신으로 간주됩니다. 1시간 단위 스냅샷이 히스토리에 반영됩니다.
구간
계약별 최신 값.
데이터 소스
파생상품 거래소 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 epoch 밀리초(UTC)
응답 형식
json
안정성
안정
제공 시작
2026-11-11

실시간 상태

저하2026-11-13 03:52:48 UTC 점검HTTP 2001 ms스키마 일치최신 데이터 포인트: 45m 경과

엔드포인트가 보고한 데이터 품질: STALE

최근 30일 가용성

점검 406회 중 100% 통과

오류

실패한 호출은 모든 엔드포인트에서 동일한 구조로 반환됩니다. 전체 목록은 오류 페이지에 있습니다. 오류 및 요청 한도 →

코드HTTP의미대응 방법
INVALID_PARAM400필수 파라미터가 누락되었거나 허용되지 않는 값입니다. 문제가 된 파라미터를 알 수 있으면 `param`에 그 이름이 들어갑니다.그대로 재시도하지 말고 요청을 수정하십시오.
UNAUTHORIZED401`CB-API-KEY` 헤더를 보냈지만 알 수 없거나 폐기된 키입니다. 공개 데이터에는 키가 필요 없으므로 헤더를 빼거나 유효한 키를 사용하십시오.그대로 재시도하지 마십시오.
FORBIDDEN403해당 경로는 공개 API에 포함되지 않습니다(내부용 또는 계정 전용).재시도하지 마십시오.
NOT_FOUND404알 수 없는 경로이거나, 요청한 코인 / 거래소 / 펀드가 존재하지 않습니다.재시도하지 말고 경로와 식별자를 카탈로그와 대조해 확인하십시오.
RATE_LIMITED429요청 수가 분당 한도를 초과했습니다. `Retry-After`가 대기해야 할 초를 알려 줍니다.`Retry-After`만큼 기다린 뒤 백오프를 적용해 재시도하십시오.
INTERNAL500예기치 않은 서버 오류입니다. 메시지는 의도적으로 일반적인 내용만 담습니다. 신고할 때 `request_id`를 인용하십시오.몇 초 뒤 한 번 재시도하고, 계속되면 요청 ID와 함께 신고하십시오.
UPSTREAM_FAILED503이 엔드포인트의 데이터 소스가 제시간에 응답하지 않았습니다. 그 대신 만료된 수치나 대체 수치를 반환하는 일은 없습니다.백오프를 적용해 재시도하고 상태 페이지를 확인하십시오.
UNAVAILABLE501 / 503데이터셋이 일시적으로 준비되지 않았거나(캐시 워밍 중) 엔드포인트에 아직 합법적인 공개 소스가 없습니다.나중에 재시도하십시오. 설계상 사용 불가인 엔드포인트는 카탈로그에 표시되어 있습니다.
REQUEST_FAILED200일부 이전 엔드포인트는 HTTP 200에 `success: false`로 응답합니다. HTTP 상태만 보지 말고 항상 `success`를 확인하십시오.메시지에 따라 다릅니다. 실패한 요청으로 처리하십시오.

직접 실행

GET/api/sd/basis저하
파라미터

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

요청 URLhttps://www.coinboss.com/api/sd/basis?coin=BTC
엔드포인트를 선택하고 “요청 보내기”를 누르십시오. 응답, 헤더, 소요 시간이 여기에 표시됩니다.