24h 거래량—미결제약정—24h 청산$1.36B24h 롱/숏—BTC 점유율—ETH 점유율—
앱
언어 ▾
₩ KRW ▾
/api/content/summary
GET사용 가능베타

사이트 전체 섹션 요약

사이트 전체 섹션 요약(콘텐츠 페이지용)

GET/api/content/summary

요청

이 엔드포인트에는 파라미터가 없습니다.

요청 예시

curl -s "https://www.coinboss.com/api/content/summary"

응답 필드

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

필드타입단위설명
successboolean—요청이 성공하면 true입니다. 실패하면 본문은 `{ success: false, code, error, request_id }`입니다.
nownumberms응답이 생성된 서버 시각.
exchangesobject—거래소.
exchanges.countnumber—항목 수.
exchanges.total_volnumberUSD모든 거래소를 합산한 24h 선물 거래량, 주식 연계 계약 제외.
exchanges.total_oinumber—총 미결제약정.
exchanges.total_contractsnumbercount모든 거래소의 선물 계약 시세 수, 주식 연계 계약 제외.
exchanges.top3array—상위 3개 항목.
exchanges.top3[]object—상위 3개 항목.
exchanges.top3[].namestring—이름.
exchanges.top3[].volnumber—거래량.
exchanges.top3[].share_pctnumber%전체 대비 비중.
exchanges.dex_share_vol_pctnumber%`total_vol` 중 탈중앙화 무기한 선물 거래소에서 거래된 비중.
exchanges.dex_share_oi_pctnumber%`total_oi` 중 탈중앙화 무기한 선물 거래소에 있는 비중.
exchanges.stock_vol_excludednumberUSD`total_vol`에서 제외된 주식 연계 계약의 24h 거래량.
fundingobject—펀딩비 블록 또는 값.
funding.weighted_pctnumber%미결제약정으로 가중한 암호화폐 USDT 무기한 선물의 현재 펀딩비, 펀딩 주기당 퍼센트 단위(8시간으로 환산하지 않은 값).
funding.top_posarray—미결제약정이 300,000 USD 이상인 USDT 무기한 선물 중 현재 펀딩비가 가장 높은 3개.
funding.top_pos[]object—계약 하나: `base`(코인), `ex`(거래소 표시 이름), `rate_pct`.
funding.top_pos[].basestring—기초 자산 심볼.
funding.top_pos[].exstring—거래소 ID, 소문자.
funding.top_pos[].rate_pctnumber%계약의 현재 펀딩비, 해당 계약 자체의 펀딩 주기당 퍼센트 단위.
funding.top_negarray—미결제약정이 300,000 USD 이상인 USDT 무기한 선물 중 현재 펀딩비가 가장 낮은(가장 큰 음수인) 3개.
funding.top_neg[]object—계약 하나: `base`(코인), `ex`(거래소 표시 이름), `rate_pct`.
funding.top_neg[].basestring—기초 자산 심볼.
funding.top_neg[].exstring—거래소 ID, 소문자.
funding.top_neg[].rate_pctnumber%계약의 현재 펀딩비, 해당 계약 자체의 펀딩 주기당 퍼센트 단위.
funding.intervalsobject—주기.
funding.intervals.h1_pctnumber%최근 24시간 동안 펀딩을 16회 이상 정산한 계약의 비중(1시간 주기로 분류).
funding.intervals.h4_pctnumber%최근 24시간 동안 펀딩을 5~15회 정산한 계약의 비중(4시간 주기로 분류).
funding.intervals.h8_pctnumber%최근 24시간 동안 펀딩을 5회 미만 정산한 계약의 비중(8시간 주기로 분류).
oiobject—미결제약정.
oi.totalnumber—합계.
oi.chg24_pctnumber%약 24시간 전의 1시간 단위 스냅샷 대비 미결제약정 합계의 변화로, 양쪽 모두에 있는 계약을 대상으로 합니다. 스냅샷이 없으면 null.
oi.gainersarray—상승률 상위.
oi.gainers[]object—상승률 상위.
oi.gainers[].basestring—기초 자산 심볼.
oi.gainers[].oinumber—미결제약정.
oi.gainers[].chg_pctnumber%등락률(%).
oi.losersarray—하락률 상위.
oi.losers[]object—하락률 상위.
oi.losers[].basestring—기초 자산 심볼.
oi.losers[].oinumber—미결제약정.
oi.losers[].chg_pctnumber%등락률(%).
oi.top_exarray—미결제약정이 가장 큰 거래소 3곳.
oi.top_ex[]object—거래소 하나: `name`, `oi`(USD), `share_pct`(`oi.total` 대비 %).
oi.top_ex[].namestring—이름.
oi.top_ex[].oinumber—미결제약정.
oi.top_ex[].share_pctnumber%전체 대비 비중.
marketobject—시장.
market.total_oinumber—총 미결제약정.
market.liq_totalnumberUSD최근 24시간의 롱 청산과 숏 청산 합계, 주식 연계 계약 제외.
market.liq_longnumber—롱 청산액.
market.liq_shortnumber—숏 청산액.
market.up_cntnumbercount시가총액 상위 500개 코인 중 24h 가격 변화가 양수인 코인 수.
market.down_cntnumbercount시가총액 상위 500개 코인 중 24h 가격 변화가 음수인 코인 수.
market.btc_dom_pctnumber%BTC 시가총액 ÷ 추적 대상 코인의 총 시가총액 × 100. 시가총액 스냅샷을 사용할 수 없으면 null.
stocksobject—최근 12시간 이내의 시세가 있는 주식 연계 무기한 선물 계약: 기초 자산 수, 계약 수, 거래소 수, 24h 거래량, 상위 3개 기초 자산.
stocks.underlyingsnumber—기초 자산 심볼.
stocks.contractsnumber—계약별 행.
stocks.volnumber—거래량.
stocks.exchangesnumber—거래소.
stocks.top3array—상위 3개 항목.
stocks.top3[]object—상위 3개 항목.
stocks.top3[].ustring—기초 자산인 주식 또는 ETF의 티커.
stocks.top3[].volnumber—거래량.
preipoobject—주식 연계 계약 중 프리IPO(합성) 기초 자산: 개수, 24h 거래량, 최고 가격, 가장 큰 가격 스프레드.
preipo.underlyingsnumber—기초 자산 심볼.
preipo.volnumber—거래량.
preipo.top_priceobject—거래량 가중 계약 가격이 가장 높은 프리IPO 기초 자산(`u`, `price`). 거래되는 것이 없으면 null.
preipo.top_price.ustring—해당 기초 자산의 이름.
preipo.top_price.pricenumber—표시 통화 기준 최종 가격(별도 언급이 없으면 USD 또는 USDT).
preipo.max_spreadobject—계약 간 가격 차이가 가장 큰 프리IPO 기초 자산(`u`, `spread_pct`, `pmin`, `pmax`). 계약이 두 개 이상인 것이 없으면 null.
preipo.max_spread.ustring—해당 기초 자산의 이름.
preipo.max_spread.spread_pctnumber%(`pmax` − `pmin`) ÷ `pmin` × 100의 값.
preipo.max_spread.pminnumberUSD여러 거래소에 걸친 해당 기초 자산의 현재 계약 가격 중 최저가.
preipo.max_spread.pmaxnumberUSD여러 거래소에 걸친 해당 기초 자산의 현재 계약 가격 중 최고가.

2026-11-11 23:01 UTC에 실제 응답 1건으로 생성.

응답 예시

/api/content/summary · 2026-11-13 03:53:48 UTC에 수집한 실제 응답. 긴 배열과 맵은 표시를 위해 줄였습니다: oi.losers: 원래 항목 3개; oi.top_ex: 원래 항목 3개; oi.gainers: 원래 항목 3개; stocks.top3: 원래 항목 3개; exchanges.top3: 원래 항목 3개; funding.top_neg: 원래 항목 3개.

  • {
    • "success": true,
    • "now": 1794541766928,
    • "exchanges": {
      • "count": 25,
      • "total_vol": 169675954910.26993,
      • "total_oi": 107737040199.58,
      • "total_contracts": 10843,
      • "top3": [ … 2 ],
      • "dex_share_vol_pct": 8.3,
      • "dex_share_oi_pct": 11.3,
      • "stock_vol_excluded": 41319457587.51
      },
    • "funding": {
      • "weighted_pct": 0.0047,
      • "top_pos": [ … 2 ],
      • "top_neg": [ … 2 ],
      • "intervals": { … 3 }
      },
    • "oi": {
      • "total": 107737040199.58,
      • "chg24_pct": -3.33,
      • "gainers": [ … 2 ],
      • "losers": [ … 2 ],
      • "top_ex": [ … 2 ]
      },
    • "market": {
      • "total_oi": 107737040199.58,
      • "liq_total": 1197925242.48,
      • "liq_long": 1104557190,
      • "liq_short": 93368052.48,
      • "up_cnt": 150,
      • "down_cnt": 327,
      • "btc_dom_pct": 57.4
      },
    • "stocks": {
      • "underlyings": 648,
      • "contracts": 2338,
      • "vol": 41225031460.52995,
      • "exchanges": 18,
      • "top3": [ … 2 ]
      },
    • "preipo": {
      • "underlyings": 3,
      • "vol": 2214168764.27,
      • "top_price": { … 2 },
      • "max_spread": { … 4 }
      }
    }

상세 정보

인증
없음. 공개 엔드포인트.
요청 한도
IP당 분당 1200회
서버 캐시
10m
엣지 마이크로 캐시
10s
갱신 주기
시세는 1분마다; OI/펀딩비는 5분마다; API 캐시 600 s
구간
24h
데이터 소스
거래소 데이터에서 자체 집계한 사이트 전체 요약 수치(거래소별 거래량 및 미결제약정 점유율, 펀딩비 극값, 미결제약정 변동 상위, 청산, 토큰화 주식 및 프리IPO 계약 통계)이며, BTC 점유율과 상승·하락 종목 수는 제3자 시장 데이터 집계 서비스에서 가져옵니다.
거래소 커버리지
수집 중인 모든 파생상품 거래소; 토큰화 주식 계약은 암호화폐 합계에서 제외
페이지네이션
없음
단위
USD; percentages
산출 방식
funding.weighted_pct = SUM(rate * oi) / SUM(oi) * 100 over USDT perpetuals refreshed within 3h (not normalized to 8h); oi.chg24_pct compares contracts present both now and 24h ago
타임스탬프
필드 설명에 별도 언급이 없는 한 Unix epoch 밀리초(UTC)
응답 형식
json
안정성
베타

실시간 상태

사용 가능2026-11-13 03:53:48 UTC 점검HTTP 2001 ms스키마 일치

최근 30일 가용성

점검 407회 중 99.75% 통과

오류

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

코드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/content/summary사용 가능
파라미터

파라미터 없음.

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