개발자 레퍼런스
공개 JSON 엔드포인트는 ByKaranteli가 기록하는 시장 데이터를 제공합니다. 종목 보드, 펀딩비, 미결제약정, 청산, 옵션, ETF 흐름, 포지셔닝입니다. CORS 지원, 속도 제한, 캐시 적용. 이 사이트의 브라우저에는 아무것도 필요 없고, 프로그램은 2026-09-10부터 무료 계정 키(Authorization: Bearer)를 보내며, 유료 플랜은 한도를 높이고 회원 깊이를 추가합니다. Free 플랜에서는 임베드 콘텐츠에 출처 표기가 필수입니다.
핵심 정보
retry-after?format=csv는 symbols, heatmap, top-movers, correlations와 모든 데이터셋(/api/v1/public/datasets)에서 사용할 수 있습니다빠른 예시
자주 묻는 질문을 한 번의 호출로 답합니다. 명령은 아래 해당 엔드포인트에 적힌 것과 같고, MCP 도구는 어시스턴트 안에서 같은 답을 줍니다.
오늘 청산 규모는 얼마이고 어느 거래소에서 일어났습니까?
거래소 피드 11개의 실제 청산 이벤트를 한 번의 호출로 제공하며 거래소와 방향별로 나누고 영구 일별 집계를 더합니다. 업계 전체 합계가 아니라 하한입니다.
get_liquidationscurl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/liquidations | jq '{recorded, market_estimate, by_exchange}'BTC 가격 위아래로 청산 물량은 어디에 있고, 양쪽에 각각 얼마나 있습니까?
무기한 선물 201개의 가격대별 청산 밀집 구간으로, 거래소 6곳 모델에 실제 청산 기록을 겹쳐 보여 줍니다.
get_liqmapcurl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/liqmap/public?symbol=BTC' | jq '.real_levels.totals'
지금 플러스든 마이너스든 펀딩비가 가장 극단적인 무기한 선물은 무엇입니까?
거래량이 가장 많은 Binance USDT-M 무기한 선물의 심볼별 펀딩비를 색으로 표시하고 미결제약정 변화를 함께 보여 줍니다.
get_funding_heatmapcurl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/heatmap | jq '.rows[:5]'
BTC 옵션의 콜 월과 풋 월은 어디에 있습니까?
Deribit, Bybit, Binance, OKX 및 Delta Exchange 옵션 체인의 행사가별 미결제약정 월, 딜러 감마 익스포저, 만기별 맥스 페인, DVOL을 합산하거나 거래소별로 보여 줍니다.
get_options_snapshotcurl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" "https://bykaranteli.com/api/public/options?venue=all" | jq '.assets.BTC | {venues_included, call_wall, put_wall}'지난 거래일 미국 현물 비트코인 ETF에 얼마가 유입되거나 유출되었습니까?
미국 현물 BTC, ETH, SOL, XRP ETF의 일별 순유입을 펀드별 매트릭스와 함께 보여 주고, 발행사 자체 수치와 대조합니다.
get_etf_flowscurl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/etf | jq '{btc: .assets.BTC.latest_finalized, issuer: .issuer_check}'거래소가 어떤 자산의 출금이나 입금을 중단했습니까?
수집 중인 모든 거래소의 자산·네트워크별 출금과 입금 상태와 시작 시점을 보여 주고, 거래소별 출금 수수료, 최소 금액, 중단 기록을 제공합니다.
get_withdrawal_statuscurl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/withdrawals?asset=USDT' | jq '.rows[:5]'
프로그램용 플랜
2026-09-10부터 프로그램(이 사이트의 브라우저가 아닌 모든 호출자)의 모든 호출은 계정 키를 함께 보냅니다: Authorization: Bearer bk_... 이메일이 확인된 계정이라면 누구나 무료 키를 받을 수 있습니다. 유료 플랜은 요청 한도, 회원 깊이, 라이선스를 구매하는 것이며, 사이트를 읽는 사람은 아무것도 내지 않습니다.
| 플랜 | 가격 | 한도 | 월간 할당량 | 깊이 | 키 | 라이선스 | x402 카탈로그 |
|---|---|---|---|---|---|---|---|
| Free API | $0 | 30 / 분 | 15,000 / 월 | 공개 페이지 | 1 | 개인 및 연구, 출처 표기 | 호출당 결제 |
| Terminal | 요금제 페이지 참고 | 60 / 분 | 150,000 / 월 | 공개 페이지 | 1 | 개인 | 호출당 결제 |
| Builder | $49 / 월 · $470 / 년 | 300 / 분 | 1,000,000 / 월 공정 사용 | 회원: LiqMap 7개 타임프레임과 필터, 1m, 3m, 5m, 10m 시리즈, 5,000 바 | 2 | 개인 | 월 1,000회 · 최근 90일 · 호출당 최대 5,000행 · 원시 기록은 호출당 결제 |
| Business | $149 / 월 · $1,430 / 년 | 1,200 / 분 | 3,000,000 / 월 공정 사용 | 회원 | 5 | 상업 | 월 10,000회 · 최근 365일 · 호출당 최대 20,000행 · 원시 기록 포함 + 월간 대량 내보내기 |
| Scale | $399 / 월 · $3,830 / 년 | 3,000 / 분 | 10,000,000 / 월 공정 사용 | 회원 | 10 | 상업 + 파생 데이터 재배포 | 상한 없음 · 전체 아카이브 · 호출당 최대 20,000행 · 원시 기록 포함 + 월간 대량 내보내기 |
| Enterprise | 연 $4,800부터 | 맞춤 | 맞춤 | 회원 | 맞춤 | 맞춤 라이선스, SLA | 상한 없음 · 전체 아카이브 · 호출당 최대 20,000행 · 원시 기록 포함 + 월간 대량 내보내기 |
2026-09-10에 활성 상태였던 회원은 결제 기간이 끝날 때까지 Builder 권한을 유지합니다. 익명 에이전트를 위한 x402 선불 키와 호출당 USDC 결제는 그대로 유지됩니다. Enterprise: support@bykaranteli.com.
Stream (WebSocket)
폴링 대신 소켓 하나: 10개 거래소의 청산 체결, 100만 달러 이상 고래 체결, Hyperliquid 고래 포지션 이벤트, 발행되는 데스크 노트, 그리고 귀하의 알림 발동이 이벤트 채널(liquidations, whales, hl_whales, alerts, desk, candles)로 발생 즉시 도착합니다. 스냅샷 채널(pressure, oi, funding, liqmap, turkey, tokenized)은 페이로드가 바뀔 때만 전송됩니다. 유료 플랜 전용: Builder는 맛보기, Business부터 모든 채널이 열립니다.
wss://bykaranteli.com/ws/v1핸드셰이크에서 계정 키를 Authorization: Bearer bk_... 로 보냅니다(REST API와 같은 키). 쿼리 문자열의 키는 거부됩니다. Free와 Terminal 키는 403 plan_required를 받습니다.
빠른 시작: 연결, 인증, 구독
wss://bykaranteli.com/ws/v1
Authorization: Bearer bk_...
{"op":"subscribe","channel":"liquidations","symbols":["BTCUSDT"],"min_notional":50000,"id":"a1"}채널
| 채널 | 유형 | 전달 내용 | 필터 |
|---|---|---|---|
| liquidations | 이벤트 | Binance, Bybit, OKX, Gate, HTX, dYdX, Aster, Lighter, Kraken Futures 및 GMX가 보고한 청산 체결을 정규화: venue, symbol, side, price, qty, notional, ts(Deribit는 지연 공개되어 스트림에 포함되지 않습니다) | symbols, venues, min_notional |
| candles | 이벤트 | Binance USDT-M 무기한 1분 캔들의 형성 과정: 시가, 고가, 저가, 종가, 견적 통화 거래대금, 테이커 매수 거래대금, 마감 플래그를 심볼당 초당 최대 두 번 전달; SuperChart가 이를 어떤 봉 주기로든 접습니다 | symbols (필수) |
| whales | 이벤트 | 자체 Binance, Bybit, OKX, Gate, Bitget, HTX, MEXC 및 Hyperliquid 무기한 계약과 Coinbase 및 Kraken 현물 체결 소켓에서 잡은 100만 달러 이상 공격적 체결 | symbols, min_notional |
| hl_whales | 이벤트 | Hyperliquid 고래 포지션 이벤트: opened, increased, reduced, closed, flipped, 전후 규모, 명목가치, 진입가와 청산가 포함 | coins, kinds |
| desk | 이벤트 | 데스크 노트 발행 즉시 전송: slug, 발행 시각, 제목, 본문, 뉴스 가치, 근거 보드와 언급된 코인, 고유 URL; GET /api/public/desk와 같은 필드 | 없음 |
| alerts | 이벤트 | 귀하의 알림 규칙이 발동될 때 도착(이메일, 푸시와 같은 트리거): 규칙 id, 이름, 심볼, fired_at | 없음 |
| pressure | 스냅샷 | 심볼별 파생상품 압력 점수; GET /api/public/pressure/{symbol}과 같은 페이로드 | symbols(필수) |
| oi | 스냅샷 | 미결제약정 보드; GET /api/public/oi와 같은 페이로드 | 없음 |
| funding | 스냅샷 | 거래소 간 펀딩비 및 차익 보드; GET /api/public/funding-arb와 같은 페이로드 | 없음 |
| liqmap | 스냅샷 | 코인과 타임프레임의 LiqMap 레벨; GET /api/liqmap/public과 같은 페이로드 | coins(필수), timeframe(기본 24h) |
| turkey | 스냅샷 | 튀르키예 프리미엄 보드: TRY 및 USDT 기준가, 거래소별 상태, bp 프리미엄; GET /api/public/turkey-premium과 같은 페이로드 | 없음 |
| tokenized | 스냅샷 | 토큰화 주식 보드: 기초 주식별 온체인 및 거래소 래퍼와 발행사, 체인 또는 거래소, 가격, 기준가, 퍼센트 프리미엄, 공급량, as_of; GET /api/public/tokenized-stocks와 같은 페이로드 | 없음 |
플랜별 이용 범위
| 플랜 | 계정당 연결 | 연결당 구독 | 채널 | 구독당 심볼 | 리플레이 |
|---|---|---|---|---|---|
| Free API, Terminal | 없음 | ||||
| Builder | 1 | 3 | liquidations만 | 3, 지정 필수 | 없음 |
| Business | 5 | 50 | 12개 전체 | 50 | 15분 |
| Scale | 20 | 200 | 12개 전체 | 200 | 60분 |
| Enterprise | 50 | 1,000 | 12개 전체 | 1,000 | 24시간 |
프로토콜
- JSON 텍스트 프레임, 프레임당 메시지 하나, 클라이언트 프레임은 최대 4 KB입니다. 첫 프레임은 플랜의 한도와 채널을 담은 hello입니다.
- subscribe는 sub id가 담긴 subscribed를 돌려줍니다. 그 id로 unsubscribe하고, list는 열린 구독을 보여주며, ping에는 pong으로 답합니다.
- 이벤트 채널은 원본 행 id인 seq가 담긴 event 프레임을 보냅니다. 마지막으로 처리한 seq를 since로 재연결하면 플랜의 리플레이 창이 실시간 앞에 채워집니다(Business 이상).
- 스냅샷 채널은 구독 직후 캐시가 있으면 snapshot 하나를 보내고, 이후에는 페이로드가 바뀔 때만 비교 가능한 hash와 함께 보냅니다. 페이로드는 REST 경로와 같아 파싱을 공유합니다.
- 서버는 25초마다 WebSocket ping을 보냅니다. 라이브러리가 자동 응답하며, 60초간 pong이 없으면 연결이 닫힙니다.
- 배포 시 reconnect를 보낸 뒤 1012로 닫습니다. retry_in_ms 이후 백오프로 since와 함께 재연결하면 리플레이 창 안의 데이터는 잃지 않습니다.
- 스냅샷 채널은 계정당 서로 다른 대상 수로 제한됩니다(Business 100, Scale 400, Enterprise 1,000개, pressure, oi, funding, liqmap의 심볼 또는 코인 합산). 초과하면 snapshot_limit를 받습니다. 읽기를 멈춘 클라이언트는 slow_consumer와 1008 종료를 받습니다. 사용량은 키별로 측정되어 연결, 프레임, 연결 시간이 /dashboard/api에 표시됩니다. 스냅샷 읽기는 REST 속도 한도에 포함되지 않습니다.
예제
import asyncio, json, websockets # websockets >= 14
async def main():
async with websockets.connect(
"wss://bykaranteli.com/ws/v1",
additional_headers={"Authorization": "Bearer bk_..."},
) as ws:
print(json.loads(await ws.recv())["type"]) # hello
await ws.send(json.dumps({"op": "subscribe", "channel": "liquidations",
"symbols": ["BTCUSDT", "ETHUSDT"], "min_notional": 50000}))
async for raw in ws:
msg = json.loads(raw)
if msg["type"] == "event":
d = msg["data"]
print(msg["seq"], d["venue"], d["symbol"], d["side"], d["notional"])
elif msg["type"] == "reconnect":
break # reconnect after retry_in_ms with since=<last seq>
asyncio.run(main())import WebSocket from "ws";
const ws = new WebSocket("wss://bykaranteli.com/ws/v1", { headers: { Authorization: "Bearer bk_..." } });
ws.on("open", () => ws.send(JSON.stringify({ op: "subscribe", channel: "hl_whales", coins: ["BTC"], kinds: ["opened", "flipped"] })));
ws.on("message", (raw) => {
const m = JSON.parse(raw.toString());
if (m.type === "event") console.log(m.seq, m.data);
if (m.type === "snapshot") console.log(m.channel, m.key, m.hash);
});오류
| 코드 | 위치 | 의미 |
|---|---|---|
| 401 missing / invalid / revoked | 핸드셰이크 | Authorization 헤더에 사용 가능한 키가 없습니다. |
| 403 plan_required | 핸드셰이크 | Free와 Terminal 키는 stream을 열 수 없습니다. |
| 429 connection_limit | 핸드셰이크 | 계정이 이미 플랜의 연결 수를 모두 사용 중입니다. |
| 429 handshake_rate | 핸드셰이크 | 한 주소에서 분당 20회를 넘는 핸드셰이크입니다. |
| channel_not_in_plan | 프레임 | 이 플랜보다 상위 채널입니다(Builder: liquidations만). |
| symbols_required / too_many_symbols | 프레임 | 채널이나 플랜에 지정 목록이 필요하거나, 목록이 허용 길이를 넘습니다. |
| subscription_limit / snapshot_limit | 프레임 | 연결이 플랜의 구독 수를 모두 사용 중이거나, 계정이 플랜의 스냅샷 대상 수를 모두 사용 중입니다. |
| replay_not_in_plan / replay_window | 프레임 | since는 Business 이상이 필요하며, 리플레이를 쓸 수 없었습니다. |
| bad_json / bad_op / bad_filter / unknown_channel / unknown_subscription | 프레임 | 프레임을 해석할 수 없거나 알 수 없는 대상을 참조했습니다. |
| slow_consumer(종료 1008) | 연결 | 클라이언트가 읽기를 멈췄습니다. 재연결하고 구독을 줄이십시오. |
| key_revoked / plan_expired(종료 1008) | 연결 | 활성 연결은 5분마다 키와 플랜을 다시 확인합니다. 취소된 키나 stream이 없는 플랜은 종료됩니다. |
| plan_changed(reconnect, 종료 1008) | 연결 | 키의 플랜이 바뀌었습니다. 재연결하면 새 한도가 적용됩니다. |
| reconnect(종료 1012) | 연결 | 서버가 재시작 중입니다. retry_in_ms 후 since와 함께 돌아오십시오. |
라이선스와 출처 표기 규칙은 REST API와 같습니다. 원시 체결과 오더북은 전송하지 않습니다. 거래소가 무료로 제공하며, 당사의 가치는 거래소 간 이벤트와 모델 결과에 있습니다.
차트 주소 키
SuperChart의 모든 화면은 URL입니다. 아래 키가 심볼, 주기, 패널, 레이어, 지표를 정하므로 링크는 본 그대로 열리고, 에이전트는 답변에 맞는 차트를 독자에게 건넬 수 있습니다 (MCP와 API 출처 정보가 chart_url로 담습니다). /api/og/chart의 공유 카드도 같은 키를 읽습니다.
| 키 | 정하는 것 | 예 |
|---|---|---|
| s | 심볼, USDT 무기한 티커. 없으면 BTCUSDT | s=ETHUSDT |
| p | 봉 주기, 1m부터 1M까지 (열여섯 값, API의 SERIES_PERIODS) | p=4h |
| panes | 가격 아래의 기록 패널, 쉼표 목록: oi, funding, funding_agg, cvd_perp, cvd_spot, liquidations, long_short, top_traders, rsi, premium, etf_flow, whale_net, borrow | panes=oi,funding,liquidations |
| ta | 내장 지표: MA, EMA, BOLL, SAR, VOL, RSI, MACD, KDJ | ta=VOL,MA |
| v | 미결제약정과 펀딩 패널의 거래소 (10분 거래소 기록기) | v=bybit |
| r | 보이는 구간, unix 초의 시작과 끝. 없으면 실시간 오른쪽 끝 | r=1759000000..1759100000 |
| lv, lvx, lvv | 옵션 레벨 켜기 (BTC와 ETH), 만기 코드, 거래소 (all 또는 deribit, bybit, binance, okx, delta 중 하나) | lv=1&lvx=31OCT26&lvv=deribit |
| ev | 거시 이벤트 표시 | ev=1 |
| heat, pr | 캔들 뒤 청산 히트맵과 캔들 위 실제 체결. 0은 숨김 | heat=1&pr=0 |
| pmin, pside | 체결 USD 하한과 방향: l 롱 청산, s 숏 청산 | pmin=100000&pside=l |
| hw, rv | Hyperliquid 고래 포지션 표시, 기록된 이벤트 표시 (급증과 100만 달러 이상 체결) | hw=1&rv=1 |
| vp, log, npoc | 보이는 범위 거래량 프로파일, 로그 가격 축, 네이키드 POC | vp=1&log=1&npoc=1 |
| aw | 앵커 VWAP 기준, 캔들의 unix 초 | aw=1759000000 |
| cmp | 비교 패널 심볼, 최대 두 개, 차트 심볼 옆에 변동률로 표시 | cmp=ETHUSDT,SOLUSDT |
https://bykaranteli.com/chart?s=ETHUSDT&p=4h&panes=oi,funding&ta=VOL&heat=1&pr=1&lv=1&vp=1&aw=1759000000
공유 카드: /api/og/chart?s=ETHUSDT&p=4h&heat=1&pr=1&log=1&aw=1759000000&vp=1&lv=1 은 그 화면을 PNG 카드로 돌려줍니다 (캔들, 히트맵, 체결, VWAP, 프로파일, 레벨). 한 시간 캐시.
MCP 서버 · AI 어시스턴트에서 이 데이터를 사용할 수 있습니다.
bykaranteli-mcp 은 Claude, Cursor 및 기타 MCP 지원 어시스턴트 안에서 이 API를 68개 도구로 제공하는 공식 MCP(Model Context Protocol) 서버입니다. 시장 지수, 펀딩비 히트맵 및 차익거래, 압력 점수, 상위 움직임, 종목 보드, 일간 청산 및 캐스케이드, ETF 흐름, COT 포지셔닝, 옵션 스냅샷 및 테이프, Coinbase 프리미엄, 플로우 독성, 슬리피지 래더, FOMC 영향, 미결제약정, 고래 테이프, 선도-후행, 상관관계, IV 서피스, 거시 유동성, 네트워크 상태, 신규 상장, 거래소 시장, 퀀텀 익스포저, LiqMap 청산 클러스터 등을 제공합니다. 무료 계정 키(BYKARANTELI_API_KEY), Node 18+. 보드 외에도 get_series는 지표, 심볼, 주기별로 기록된 시계열을 반환하고, parse_alert_text는 "BTC funding above 0.05%" 같은 문장을 알림으로 바꾸며, 계정 도구는 같은 키로 본인의 알림과 관심 목록을 조회하고 변경합니다(변경하는 도구는 쓰기로 표시되고, 요금제 사용량에 포함되며, 계정에 기록됩니다). 모든 시장 데이터 응답에는 provenance 블록이 붙습니다: 수치 뒤의 거래소, 전체 또는 샘플 커버리지, 데이터 신선도, 증명 페이지.
https://mcp.bykaranteli.com을 사용자 지정 커넥터로 붙여넣으십시오(claude.ai: Settings > Connectors > Add custom connector). 동일한 68개 도구, 설치 없음. Authentication에서 "No sign-in"을 선택하십시오(claude.ai가 자동으로 감지합니다). 서버는 OAuth 자격 증명을 받지 않으므로 OAuth 클라이언트 ID와 클라이언트 시크릿 필드는 비워 두십시오. 모든 도구 호출에는 계정 키가 필요합니다. 요청 헤더 x-api-key: bk_...를 추가하거나(claude.ai 사용자 지정 커넥터, 다른 클라이언트에서는 Authorization: Bearer bk_...), 헤더를 보낼 수 없는 클라이언트(ChatGPT)에서는 주소 https://mcp.bykaranteli.com/?key=bk_...를 사용하고 비밀번호처럼 보관하십시오. 무료 계정은 월 15,000회 호출을 제공하며 API와 MCP가 하나의 카운터를 공유합니다. Builder 이상은 더 높은 속도와 회원 깊이를 제공합니다. 키: https://bykaranteli.com/dashboard/api. 처음이십니까? 단계별 안내: https://bykaranteli.com/guide/connect
claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_... -- npx -y bykaranteli-mcp
{
"mcpServers": {
"bykaranteli": { "command": "npx", "args": ["-y", "bykaranteli-mcp"] }
}
}소스 및 문서: github.com/bykarantelicom/bykaranteli-mcp · npmjs.com/package/bykaranteli-mcp
에이전트용 호출당 과금 엔드포인트(x402)
이 엔드포인트는 더 깊은 데이터에 접근하며, x402 프로토콜을 통해 각 호출을 USDC로 과금하므로 자율 에이전트가 계정, API 키, 구독 없이 답변 하나를 구매할 수 있습니다. 결제는 요청당 온체인으로 정산되며 양쪽 모두 가입할 것이 없습니다. 결제한 호출은 경로별 행 상한으로 전체 아카이브를 읽으며 호출당 $0.10입니다. Builder 이상 키는 같은 경로를 플랜 안에서 결제 없이 호출합니다. Builder는 월 1,000회 카탈로그 호출, 최근 90일, 호출당 최대 5,000행, 요약 시리즈만 제공합니다. Business는 월 10,000회, 최근 365일, 호출당 최대 20,000행이며 원시 기록을 포함합니다. Scale과 Enterprise는 상한 없이 전체 아카이브를 읽습니다. 기간은 첫날 00:00 UTC부터 계산하며, 포함된 호출 1회는 플랜의 월 공정 사용에서도 10회 요청으로 계산됩니다. 원시 기록(개별 청산 이벤트와 최대 체결 순위, 고래 체결, Hyperliquid 포지션 이벤트와 시간별 포지션 기록, 호가창 스냅샷, 분봉, 거래소별 시장 스냅샷: liquidations-raw, liquidation-leaderboard-history, hl-whale-events, hl-positions-history, orderbook-history, spot-microstructure, venue-markets-history, whale-trades-raw)은 Business부터 포함됩니다. 경로의 history_since는 그 경로의 첫 기록이며, 포함된 호출은 플랜 기간의 시작점부터 읽습니다(x-history-window-days). 상한을 넘거나(x402_allowance_used, HTTP 402), 기간 이전을 요청하거나(history_window, HTTP 403), Business 미만 플랜에서 원시 기록 경로를 호출하면(raw_tier_required, HTTP 403) 그 호출은 호출당 결제입니다. 계정 키는 Authorization: Bearer 헤더로, 선불 키는 x-api-key에 넣어 보내거나, 계정 키 없이 보내 402를 지갑으로 결제하십시오. 대량 내보내기는 Business 이상에서 제공되며 상한에 들어가지 않고, 플랜 기간과 겹치는 월 파일만 목록에 나옵니다.
Solana mainnet 또는 Base mainnet의 USDC · 호출당 표시 가격 · 네트워크 수수료는 facilitator가 부담
/api/x402/liqmap-levels$0.100다중 거래소 청산 맵 전체: 모델링된 레버리지 클러스터, 실제 forceOrder 수준, 주요 자석, 펀딩 및 호가창 컨텍스트.
/api/x402/options-flow$0.100기록된 Deribit 및 OKX 테이프: 일별 프리미엄 플로우 이력, strike, expiry 및 implied volatility가 포함된 전체 대형 체결 목록, 1시간, 4시간, 24시간 매수, 매도 및 순프리미엄, 만기, 행사가, 거래소별 분해, 최근 다중 레그 구조.
/api/x402/flow-vpin$0.100VPIN 주문 흐름 독성 이력: 90일 일별 추적과 최근 500개 볼륨 버킷.
/api/x402/cot-history$0.100암호화폐 선물에 대한 CFTC Commitments of Traders 주간 이력, 수집 및 정규화 완료.
/api/x402/liquidations-raw$0.100Binance, Bybit, OKX, Gate, HTX, dYdX, Aster, Lighter, Kraken Futures 및 GMX의 당사 소켓에서 수집한 개별 청산 이벤트(Deribit는 지연), 밀리초 타임스탬프 포함.
/api/x402/liquidation-leaderboard-history$0.100마감된 UTC 일자별 최대 단일 청산 전체 순위입니다. 심볼, 거래소, 방향(SELL은 롱 청산), 가격, 수량, 명목가치, 밀리초 이벤트 시각을 담으며 심볼과 거래소로 필터링할 수 있습니다.
/api/x402/networks-history$0.100기록 중인 모든 거래소의 자산 및 네트워크 행 전체 버전 이력입니다. 입금 및 출금 플래그, 출금 수수료와 최소 금액을 valid_from, valid_to와 함께 제공해 출금 중단 시점과 기간을 확인할 수 있습니다. 무료 엔드포인트는 현재 표만 제공합니다.
/api/x402/leverage-tiers-history$0.100레버리지 단계를 읽는 모든 거래소의 무기한 계약별 레버리지 단계 전체 버전 이력입니다. 단계, 명목가치 하한과 상한, 최대 레버리지, 유지 증거금을 valid_from, valid_to와 함께 제공해 레버리지 축소 시점을 확인할 수 있습니다. 무료 엔드포인트는 현재 단계만 제공합니다.
/api/x402/oi-history$0.100주요 무기한 계약의 5분 미결제약정 이력, 한 번의 쿼리에서 심볼 전반 정규화.
/api/x402/tradfi-oi-history$0.100Binance TradFi 무기한 계약(미국, 홍콩, 한국, 중국 주식, 원자재, 지수)의 5분 단위 미결제약정 이력으로, 기초 단위와 USD로 제공하며 2026-09-02부터 자체 기록합니다. 무료 /api/public/tradfi 보드는 실시간 값만 제공합니다.
/api/x402/tradfi-funding-history$0.100저희 보드에 있는 모든 Binance TradFi 무기한 계약(주식, 지수, 원자재)의 정산 펀딩비 이력으로, 2026-05-31 또는 상장일부터 정산마다 한 행을 기록하고 매시간 갱신합니다. 무료 보드는 마지막 정산 펀딩비만 제공합니다.
/api/x402/indicators-events$0.1002012년 이후 비트코인 사이클 지표가 기준 구간을 넘은 모든 날(Pi Cycle, Mayer Multiple, Puell Multiple, 200주 이동평균, 2년 이동평균 x5, 황금비 배수, 수익 일수 비율)과 당일 BTC 종가, 이후 7, 30, 90, 180, 365일 수익률입니다. 무료 엔드포인트는 이벤트 기록과 이후 수익률 없이 수준만 제공합니다.
/api/x402/rsi-history$0.100거래량 상위 400개 crypto 무기한 계약과 모든 TradFi 무기한 계약의 RSI(14) 시간별 행으로, 8개 구간으로 구성된 /rsi 보드입니다.
/api/x402/hl-whale-events$0.100Hyperliquid 상위 1000개 계정의 모든 기록된 포지션 변화: 오픈, 청산, 증가, 축소, 전환, 변경 전후 크기, 진입가 및 청산가 포함.
/api/x402/hl-positions-history$0.100Hyperliquid 상위 1000개 계정의 모든 미결제 포지션을 1시간마다 기록하며 2026-09-30부터 제공합니다: 주소, 코인, 부호 있는 크기, 명목, 진입가와 청산가, 레버리지, 계정 순자산이며 코인, 주소, 시간으로 거릅니다.
/api/x402/positioning-history$0.100Binance, Bybit, OKX, Gate, HTX, Bitget 및 Kraken Futures의 30개 무기한 계약에 대한 시간별 롱/숏 비율, 상위 트레이더 비율 및 taker 플로우, 그리고 Bitfinex 현물 마진 롱·숏 포지션 규모, GMX 및 Jupiter Perps 롱·숏 미결제약정, 당사 측 기록.
/api/x402/bulk-liquidations$15기록한 모든 청산 이벤트(거래소, 심볼, 방향, 가격, 수량, quote_qty, 이벤트 시각)의 월별 gzip CSV 파일이며 2026-08-02부터 제공합니다. 유료 호출 한 번으로 마감된 모든 월과 이번 달 현재까지 파일의 1시간 유효 서명 다운로드 링크를 받습니다.
/api/x402/bulk-derivatives$10파생상품 테이블의 월별 gzip CSV 파일입니다. 심볼별 Binance 5분 미결제약정(oi-5m), 해당 월의 모든 Binance USDT-M 무기한 계약 펀딩 정산(funding-settlements), 10분 단위 다중 거래소 시장 스냅샷(venue-snapshots)을 담습니다. 유료 호출 한 번으로 마감된 모든 월과 이번 달 현재까지의 1시간 유효 서명 링크를 받습니다.
/api/x402/bulk-flow$10플로 테이블의 월별 gzip CSV 파일입니다. 자체 trade sockets의 $1M+ 공격적 체결(whale-trades), Hyperliquid 대형 계정 포지션 변경 이벤트(hl-whale-events), 시간별 롱/숏 및 taker 통계(positioning-hourly), 여러 구간의 시간별 RSI(rsi-hourly)를 담습니다. 유료 호출 한 번으로 마감된 모든 월과 이번 달 현재까지의 1시간 유효 서명 링크를 받습니다.
/api/x402/jupiter-history$0.100Jupiter Perps의 시장(SOL, ETH, BTC)과 지표별 시간 단위 이력입니다. 온체인 커스터디 상태에서 읽은 정확한 롱/숏 미결제약정, 롱/숏 풀 사용률, 시간당 차입 수수료, 커스터디 AUM, 가격, 24시간 거래량, JLP 풀 AUM, 가격, APR을 담으며 2026-09-02부터 기록합니다. 무료 /api/public/jupiter는 실시간 보드와 시간별 OI 이력을 제공합니다.
/api/x402/market-profile-history$0.100Daily Market Profile per perpetual from our own minute bars: 30-minute TPO periods over price buckets a fixed fraction of the day's open, the point of control, the 70% value area (VAH, VAL), the initial balance (first hour UTC), the volume point of control and the per-bucket profile. One symbol per call, newest first; BTC from 2024, other symbols from their recorder's start. The free /api/public/market-profile serves 30 days without the profile column.
/api/x402/venue-share-history$0.100Hourly recorded liquidations per counted venue (Binance, Bybit, OKX, Gate, HTX, dYdX, Aster, Lighter, Kraken Futures, GMX and Deribit): long and short USD, events, largest single print, symbols, the hour's total over the counted venues and the venue's share of it; a venue's hours start on its first counted day. Newest first, recorded since 2026-08-29. The free /api/public/venue-share serves 24h, 7d, 30d and 30 daily rows.
/api/x402/solana-perps-history$0.100보드에서 Jupiter를 제외한 모든 Solana 무기한 거래소의 시장 및 지표별 시간 단위 이력입니다. USD 기준 단방향 미결제약정(풀 방식 거래소는 양방향), 24시간 거래량, 포지션 규모 대비 시간당 펀딩 비율, 마크 가격, Phoenix 원시 펀딩 누적값을 담으며 2026-09-25부터 기록합니다. 무료 API는 실시간 보드와 한 시장의 최근 이력을 제공합니다.
/api/x402/turkey-premium-history$0.100튀르키예 프리미엄 지수의 분 단위 이력(2026-09-17부터)입니다. 튀르키예 현물 거래소의 TRY 및 USDT 기준 가격(적격 오더북 중간가의 중앙값), 적격 및 관측 거래소 수, 상태, Binance 글로벌 USDT 가격, ECB USD/TRY 고시 환율, bp 단위 프리미엄과 Turkey Premium Index를 담습니다. 거래소별 오더북 행은 exchange=<venue>로 조회합니다. 무료 /api/public/turkey-premium은 실시간 보드와 15분 단위 포인트를 제공합니다.
/api/x402/desk-notes-history$0.1002026-10-12부터의 데스크 노트 아카이브: 각 노트의 발행 시각, 데이터 시각, 뉴스 가치, 보드, 코인, 영어 본문과 X 본문, 중국어, 러시아어, 한국어 번역; 코인, 카드 유형, 시간 필터.
/api/x402/insurance-fund-history$0.100Binance, Bybit, OKX, Gate, MEXC, Bitfinex, Crypto.com, Delta Exchange, dYdX 및 Paradex의 풀별 시간당 보험 기금 읽기: 잔고, USD 가치, 담당 계약 수, 거래소 및 자산 필터 포함.
/api/x402/tokenized-stocks-history$0.100xStocks, Robinhood Stock Tokens, Coinbase Tokenized Stocks, Binance bStocks, Ondo Stocks, Backpack Securities, Reality (Bitget), Superstate Opening Bell, Figure, Dinari dShares 및 Securitize (Exodus)의 토큰화 주식 래퍼별 시간 단위 값: 가격, 기준 가격, 프리미엄, 유동성, 24시간 거래량, 호출당 래퍼 하나와 체인, 발행사, 일수 필터.
/api/x402/prepaid-key$10선불 API 키: 한 번 결제하면 $10 크레딧이 충전된 bk_live 키가 발급됩니다. 아래의 어떤 경로에든 x-api-key 헤더로 보내면 각 호출에서 표시된 가격이 차감되므로, 스크립트와 에이전트가 한 번의 정산 후에도 수백 번 호출할 수 있습니다. ?key=는 기존 키를 충전하며, /api/x402/prepaid-key/balance는 무료입니다.
/api/x402/orderbook-history$0.100거래소별 5분 현물 호가창 깊이 스냅샷(Binance, Coinbase, Kraken, Bybit, OKX, Gate, MEXC, HTX, Bitget, Bitstamp, Gemini, Bitfinex, BingX, Crypto.com, Backpack, Binance US, Poloniex, LBank, Bitrue, XT, HashKey, DigiFinex, Bullish, WEEX, Deribit, Aster, Bitvavo, Independent Reserve, BtcTurk), 10개 코인 대상: 중간가 기준 20% 이내의 0.1% 구간, 양쪽 2% 깊이, book reach, 행별 in_aggregate, 2026-09-15부터 기록된 모든 행.
/api/x402/funding-history$0.100모든 Binance USDT-M 무기한 계약(암호화폐와 TradFi)의 정산 펀딩비 이력으로 정산마다 한 행이며, 2026-05-31부터 모든 정산을 기록하고 매시간 갱신합니다. 캐리와 베이시스 분석의 기반이 되는 시계열입니다.
/api/x402/options-oi-history$0.100Deribit, Bybit, Binance, OKX 및 Delta Exchange의 행사가와 만기별 일별 옵션 미결제약정, mark implied volatility, 거래소가 공개하는 거래 명목가치, 거래소 필터 포함.
/api/x402/options-chain-history$0.100Deribit, Bybit, Binance, OKX 및 Delta Exchange의 상품별 시간별 옵션 체인 행, 2026-09-30부터 기록: 미결제약정, mark implied volatility, 기초자산 가격과 24시간 거래대금, Deribit mark, bid, ask; 통화, 거래소, 만기, 기간 필터.
/api/x402/spot-microstructure$0.100taker buy와 총 quote 분해가 포함된 분봉 데이터로, 거래소 간 사전 결합되어 있으며 Binance 데이터는 2024-09-28부터 기록되었습니다.
/api/x402/venue-markets-history$0.100저희가 조회하는 모든 무기한, 현물, TradFi 무기한 피드의 가격, 거래량, 미결제약정, 펀딩 10분 단위 거래소 스냅샷입니다. 2026-08-25부터 기록된 모든 행을 제공합니다.
/api/x402/whale-trades-raw$0.100당사 trade sockets에서 수집한 $1M+ 공격적 체결 전부, side, 가격, 수량 및 명목가치 포함, 2026-08-13부터 기록된 모든 행.
# 1. 결제 없이 요청: 엔드포인트가 기계 판독 가능한 약관과 함께 402를 응답합니다 curl -i https://bykaranteli.com/api/x402/flow-vpin # 2. 모든 x402 클라이언트는 결제 후 자동으로 재시도합니다 npm i @x402/fetch @x402/core @x402/svm # wrapFetchWithPayment(fetch, client) -> 200 + data, USDC로 정산
가격은 성공한 응답당 적용됩니다. 실패한 요청은 정산되지 않습니다. 비용이 발생하는 것은 depth와 history이며, 접근은 아닙니다: 위의 모든 실시간 스냅샷은 계정 키로 플랜 한도 안에서 계속 무료입니다.
예시 전에: API 키
아래의 모든 예시는 환경 변수 BYKARANTELI_API_KEY에서 계정 키를 읽어 Authorization: Bearer로 보냅니다. 인증된 계정이면 누구나 무료 키를 받을 수 있습니다. API 페이지에서 만드십시오. 키는 서버나 스크립트에만 두고 브라우저 코드에는 절대 넣지 마십시오. 페이지를 여는 누구나 읽을 수 있습니다. Proof API에는 계정 키가 필요 없습니다. /api/x402 아래의 호출당 결제 경로도 키 없이 쓸 수 있습니다. 에이전트는 호출마다 USDC로 결제하며, Builder 이상 키는 플랜 안에서 결제 없이 호출합니다. Builder는 월 1,000회 카탈로그 호출(최근 90일, 요약 시리즈), Business는 월 10,000회(최근 365일, 원시 기록 포함), Scale 이상은 상한 없이 전체 아카이브입니다. 포함된 호출 1회는 월 공정 사용에서도 10회 요청으로 계산됩니다.
export BYKARANTELI_API_KEY=bk_...
필터에 맞는 엔드포인트가 없습니다.
/api/public/symbols종목 보드: 추적 중인 모든 Binance USDT-M 무기한 계약의 기록된 24시간 티커, 펀딩비, 미결제약정 변화, 파생상품 압력 점수.
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| sort | volume | change | funding | oi | pressure | 아니오 | 보드 정렬. 기본값 volume. |
| top | 1-1000 | 아니오 | 반환할 행 수. 기본값 200. |
| format | csv | 아니오 | JSON 대신 CSV로 보드를 반환합니다. |
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/symbols?sort=change&top=20' | jq '.symbols[:5]'
{
"generatedAt": "2026-09-05T09:00:00.000Z",
"sort": "volume",
"totalSymbols": 512,
"symbols": [
{
"symbol": "BTCUSDT", "lastPrice": 109412.5, "change24hPct": 1.84,
"quoteVolume24h": 21874112034.1, "fundingRatePct": 0.0081,
"openInterestUsd": 12041233810.4, "oi24hPct": 2.1,
"pressureScore": 61, "pressureDirection": "LONG",
"pressureUpdatedAt": "2026-09-05T08:45:12.000Z"
}
]
}/api/public/market-profile당사가 직접 기록한 1분 봉으로 만든 Binance USDT-M 무기한 계약 하나의 Market Profile이며, 마감된 UTC 일마다 한 행을 최신순으로 제공합니다: poc(TPO 표시가 가장 많은 가격 구간), val과 vah(70% 가치 영역), ib_low와 ib_high(UTC 첫 한 시간), vpoc(거래대금이 가장 많은 구간), open, high, low, close, tpo_total, periods. naked_pocs는 최근 기록된 60일의 POC 중 이후 마감된 어느 날도 거치지 않은 가격을 나열하고, profile_latest는 최신 일의 구간별 [price, tpo, volume_usd]를 제공합니다. TPO 구간은 30분, 가격 구간 폭은 당일 시가의 0.05%입니다. 모든 키로 30일을 받을 수 있으며, 최대 400일은 회원 깊이입니다(Terminal 세션 또는 Builder 이상 키). 1분 봉을 기록하지 않는 심볼은 404 no_profile을 반환합니다. 매일의 가격 수준은 market-profile-daily 데이터셋에, 각 일의 전체 프로파일은 유료 경로 /api/x402/market-profile-history에 있습니다.
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| symbol | BTC | BTCUSDT | 아니오 | 무기한 계약, USDT 포함 또는 제외. 기본값 BTCUSDT. |
| days | 1-400 | 아니오 | 마감된 UTC 일 수, 최신순. 기본값 30; 30일 초과는 회원 깊이가 필요합니다. |
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/market-profile?symbol=BTC&days=5' | jq '{symbol, recorded_since, latest: .days[0], naked_pocs}'/api/public/tradfi-gaps주식, 지수, 원자재 무기한 계약의 주말과 야간 갭을 저희가 기록한 미국 정규장 종가와 비교합니다. 기준은 뉴욕 16:00 전 마지막 10분 스냅샷의 거래소 가격 중앙값입니다. window=weekend(기본값, 최근 주말 12개: sat_12, sun_12, sun_20, pre_open, open) 또는 night(월요일부터 목요일 종가 이후 최근 야간 20개: utc_04, pre_open, open)이며, open은 뉴욕 09:30 이후 첫 스냅샷입니다. 각 시점에는 price(거래소 중앙값), venues, spread_pct(최고와 최저 거래소 차이를 중앙값으로 나눈 값), gap_pct, 기준 대비 lo_pct와 hi_pct가 있습니다. symbol이 없으면 kpis, 종목별 summary(기준 시점과 개장 시 절대 갭 중앙값, 두 값을 가진 구간이 5개 이상일 때의 same_direction_pct, 차이 중앙값), 모든 종목이 담긴 최근 구간 latest를 반환하고, symbol=TSLA이면 해당 종목의 요약과 모든 구간을 반환합니다. 2026-08-25부터 기록하며 휴장일 달력은 없습니다. 모든 구간과 시점은 tradfi-gaps 데이터셋에 있고, 원본 10분 거래소 스냅샷은 유료 경로 /api/x402/venue-markets-history에 있습니다.
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| window | weekend | night | 아니오 | weekend(기본값) 또는 night입니다. |
| symbol | TSLA | TSLAUSDT | 아니오 | TSLA, NVDA, XAU 같은 종목이며 USDT 접미사는 제거합니다. 없으면 요약과 최근 구간을 반환합니다. |
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/tradfi-gaps?window=weekend&symbol=TSLA' | jq '.summary, .windows[0].symbols[0].points'
/api/public/pressure추적 중인 모든 Binance USDT-M 무기한 계약에 대한 종합 0-100 파생상품 압력 점수입니다. OI 변동 1h/4h/24h + 펀딩비 + 베이시스 기준입니다. 방향 인식 레짐입니다.
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| limit | 1-200 | 아니오 | 최대 행 수입니다. 기본값 60입니다. |
| side | 롱 | 숏 | 아니오 | 방향 편향으로 필터링합니다. |
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/pressure?limit=20&side=long' | jq '.items[:5]'
{
"generatedAt": "2026-04-23T20:47:28.616Z",
"count": 60,
"items": [
{
"symbol": "BARDUSDT",
"score": 45, "direction": "SHORT", "regime": "SHORT_RAMP",
"regimeLabel": "Net short bias building",
"components": { "oi24hPct": -8.7, "oi4hPct": 1.5, "oi1hPct": 0.1, "fundingRatePct": -0.037, "basisPct": -0.19 },
"explainer": [ "Open interest down 8.7% over 24h", "Funding rate -0.037% per interval" ]
},
…
]
}/api/public/pressure/[symbol]캐시가 오래되면 실시간으로 갱신되는 심볼별 압력 스냅샷입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/pressure/BTCUSDT
/api/public/funding-arb33개 거래소(Binance, OKX, Bybit, Gate.io, HTX, BingX, Bitget, MEXC, Kraken Futures, Hyperliquid, Aster, dYdX, ApeX, Backpack, Bitfinex, Bitmart, BloFin, BTSE, Crypto.com, Delta Exchange, Deribit, DigiFinex, Extended, HashKey, KuCoin, Lighter, Paradex, Phemex, Toobit, WEEX, WhiteBIT, WOO X 및 XT) 전반의 상위 심볼에 대한 교차 거래소 펀딩비 스프레드와 순비용 기준 연환산 APR입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/funding-arb | jq '.rows[:5]'
/api/liqmap/public공개 LiqMap 스냅샷(24H)입니다. 201개 주요 무기한 계약(Binance, Bybit, OKX, Gate, HTX 및 Hyperliquid)의 다중 거래소 청산 레벨 추정치이며 실제 청산을 오버레이합니다. ?symbol=BTC..OP.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/liqmap/public?symbol=BTC' | jq '.real_levels.totals'
/api/public/heatmap고정된 대형 Binance USDT-M 무기한 계약 묶음의 펀딩비 스냅샷입니다. 종목별 현재 펀딩비, 24시간 미결제약정 변화, 24시간 가격 변화를 제공하며, ?format=csv는 같은 행을 CSV로 반환합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/heatmap | jq '.rows[:5]'
/api/public/top-movers압력 보드의 상위 변동 종목입니다. 24시간 미결제약정 절대 변화가 가장 큰 종목(biggestOi24h), 펀딩비가 가장 극단적인 종목(extremeFunding), 베이시스가 가장 넓은 종목(widestBasis), 압력 점수가 가장 높은 종목(highestStress)을 방향과 함께 제공합니다. ?format=csv는 네 목록을 하나의 CSV로 반환합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/top-movers | jq '.biggestOi24h[:5]'
/api/public/altseason알트코인 시즌 지수입니다. 실시간 수치, 가장 강한 대형 알트와 가장 약한 대형 알트, 기록된 일간 이력을 제공합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/altseason | jq '.value'
/api/public/themesAI, RWA, DePIN, meme, L1, L2, DeFi, quantum의 8개 동일가중 내러티브 지수입니다. 고정 바스켓과 2025-01-01 이후의 일별 포인트를 포함합니다. 스코어보드만 보려면 ?points=0을 추가합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/themes | jq '.themes[] | {key, last, ret_30d_pct}'/api/public/factors팩터 보드입니다. 기록된 모든 지표를 역사적 밴드 내에 표시하고, 그 뒤에 나타난 BTC 7일 중앙값 변동을 기준율과 비교합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/factors | jq '.rows[:5]'
/api/public/borrow-rates마진 차입 금리입니다. 거래소와 자산별 최신 연율 금리(차입 이력을 읽을 수 있는 모든 거래소의 USDT, USDC, BTC, ETH 및 주요 알트), 스테이블코인과 메이저의 30일 시간별 시리즈, 거래소별 펀딩에서 차입 금리를 뺀 캐리를 제공합니다. 매시간 기록합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/borrow-rates' | jq '.latest[:5], .carry[:3]'
/api/public/fees거래 수수료표입니다. 거래소와 시장 유형별 기본 등급 메이커 및 테이커 수수료(거래쌍마다 가격을 정하는 거래소는 거래쌍 중앙값)를 각 거래소의 자체 수수료 엔드포인트에서 매일 읽으며, 수수료 변경 로그를 함께 제공합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/fees' | jq '.median_taker_perp, .rows[:5]'
/api/public/settlements만기 캘린더와 정산 가격입니다. 53개 거래소의 시장 목록에서 향후 60일간의 기한부 선물과 옵션 만기를 날짜, 거래소, 기초자산별로 묶고, 기한부 선물이 인도될 때 기록한 정산 가격을 함께 제공합니다. recorded_venues는 정산 가격이 기록된 거래소 수입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/settlements' | jq '.next_7d, .upcoming[:5], .recorded[:3]'
/api/public/venues/profile거래소 하나에 대해 저희가 기록하는 모든 정보입니다. 유형별 등록 계약, 10분 venue 기록기의 바스켓 미결제약정과 평균 펀딩, 레버리지 단계 요약, 입출금 네트워크 수, 기본 수수료표, 상태 가동률, 최근 이벤트 로그를 제공합니다. ?venue=bybit를 사용하며, venue가 없으면 기록된 거래소 id 목록을 반환합니다. /venues/<venue> 페이지의 JSON입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/venues/profile?venue=bybit' | jq '.instruments, .status, .events[:3]'
/api/public/withdrawals저희가 기록하는 모든 거래소의 입금 및 출금 네트워크를 매일 천천히 변하는 행으로 기록합니다. 자산과 네트워크별 입금 가능 여부, 출금 가능 여부, 출금 수수료와 최소 금액, 중단 및 재개 로그를 제공합니다. 필터가 없으면 지금 출금이 중단된 항목을 자산 중요도 순으로 보여줍니다. ?asset=USDT는 해당 자산의 모든 거래소와 네트워크를 반환하고, ?venue=kucoin은 범위를 좁힙니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/withdrawals?asset=USDT' | jq '.rows[:5]'
/api/public/leverage-tiers레버리지 단계를 읽을 수 있는 모든 거래소의 무기한 계약별 레버리지 단계를 매일 천천히 변하는 행으로 기록합니다. 단계, 명목 하한과 상한, 최대 레버리지, 유지 증거금률, 레버리지 인하 및 인상 변경 로그를 제공합니다. ?symbol=BTC는 기초자산 하나로, ?venue=okx는 거래소 하나로 좁히며, 필터가 없으면 거래소 간 개요를 반환합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/leverage-tiers?symbol=SOL' | jq '.rows[:5]'
/api/public/venues/marketsVenue 레이어는 저희가 조회하는 모든 무기한 및 현물 피드를 집계합니다(목록은 coverage 필드). 총 perp OI, DEX 비중, 펀딩 범위, 현물 괴리, 스테이블코인 페그를 포함합니다. 한 코인의 행은 ?symbol=BTC를 사용합니다. oi_excluded_venues의 거래소(WhiteBIT, BitMart)는 목록에 표시되지만 OI 합계와 DEX 비중에서는 제외됩니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/venues/markets | jq '.symbols[:3]'
/api/public/venues/lead-lag누가 먼저 움직이는지: 거래소 쌍과 UTC 일자별 1분 수익률 교차상관과 선행 비대칭입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/venues/lead-lag | jq '.pairs[] | {id, summary}'/api/public/options/surface만기 및 moneyness별 IV 표면, 각 만기별 ATM / 25-delta put 및 call IV, skew와 butterfly, 고정 30일 이력입니다. ?currency=BTC|ETH.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/options/surface?currency=BTC' | jq '{atm_30d, skew25_30d_pp}'/api/public/optionsDeribit, Bybit, Binance, OKX 및 Delta Exchange의 옵션 스냅샷: OI 벽, 딜러 감마 익스포저, 제로 감마 레벨, 기간 구조, venues_included의 거래소별 비중. DVOL은 Deribit 지수입니다.
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| venue | all | deribit | bybit | binance | okx | delta | 아니오 | 한 거래소의 체인 또는 all(기본값): 만기, 행사가, 유형별로 미결제약정을 합산하고 mark IV를 미결제약정으로 가중합니다. 그 외 값은 400을 반환합니다. |
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" "https://bykaranteli.com/api/public/options?venue=all" | jq '.assets.BTC | {venues_included, call_wall, put_wall}'/api/public/options/chainDeribit, Bybit, Binance, OKX 및 Delta Exchange의 시간별 옵션 체인이며 2026-09-30부터 기록합니다: 만기별 미결제약정(코인 및 USD)과 1시간 및 24시간 변화, ATM IV와 24시간 변화, max pain; 계약별 미결제약정과 그 변화, mark IV와 24시간 변화, 코인 단위 Deribit mark, bid, ask; 그리고 한 만기의 최근 24시간 시간별 ATM IV 경로를 제공합니다. 변화는 두 시간 모두에 있는 거래소만 합산합니다. 모든 키는 미결제약정이 가장 큰 40개 계약을 받으며, strikes=all은 회원 깊이(Terminal 세션 또는 Builder 이상 키)로 모든 계약을 반환합니다.
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| currency | BTC | ETH | 아니오 | 기초자산, 기본값 BTC. 그 외 값은 400을 반환합니다. |
| venue | all | deribit | bybit | binance | okx | delta | 아니오 | 한 거래소의 체인 또는 all(기본값): 만기, 행사가, 유형별로 합산합니다. 그 외 값은 400을 반환합니다. |
| expiry | DDMONYY | 아니오 | 상장된 만기 하나(예: 30OCT26): 계약과 ATM IV 경로를 좁힙니다. 형식이 틀리거나 상장되지 않은 만기는 400을 반환합니다. |
| strikes | top | all | 아니오 | top(기본값) 또는 전체 계약; all은 회원 깊이가 필요합니다. |
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/options/chain?currency=BTC&venue=all' | jq '{hour, spot, front_expiry, expiries: .expiries[:3], strikes: .strikes[:3]}'/api/public/options-flowDeribit 및 OKX 옵션 테이프, 15분마다 기록: 프리미엄, 행사가, 풋/콜, 블록 트레이드, 체결별 거래소; windows(옵션 유형별 1시간, 4시간, 24시간 매수, 매도 및 부호 있는 순프리미엄), by_expiry, by_strike, by_venue, 최근 다중 레그 구조와 각 레그 및 구조 라벨.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/options-flow | jq '.assets.BTC | {prints_24h, call_premium_bought_24h_usd, put_premium_bought_24h_usd, block_share_24h}'/api/public/etf미국 현물 BTC, ETH, SOL 및 XRP ETF 자금 유입·유출: 오늘의 잠정 집계와 펀드별 표, 최근 30개 확정 거래일, 그리고 IBIT 발행사 검증, BlackRock 발행 주식 수 x NAV 대비 기록.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/etf | jq '{btc: .assets.BTC.latest_finalized, issuer: .issuer_check}'/api/public/flow테이커 방향 분봉으로 계산한 주요 무기한 계약의 주문흐름 독성(VPIN)입니다. 현재 수치, 최근 90일 기준 백분위와 90번째 백분위 임계값, 24시간 평균, 버킷 크기를 제공합니다. 일별 이력은 유료 경로 /api/x402/flow-vpin에 있습니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/flow | jq '.symbols.BTCUSDT | {vpin, percentile_90d, avg_24h}'/api/public/cotBitcoin 선물에 대한 CFTC Commitments of Traders, 주간, 2018년까지 소급.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/cot | jq '.assets.BTC | {report_date, hedge_funds_net_contracts, institutions_net_contracts}'/api/public/eventsFOMC 성명(최상위 필드)과 CPI 및 고용보고서 발표(cpi, nfp)에 대한 BTC의 5, 30, 60분 측정 반응과 각각의 다음 예정일, 그리고 events의 날짜별 거시 일정.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/events | jq '{fomc: .recent_reactions[:3], cpi_next: .cpi.next_release, nfp_next: .nfp.next_release}'/api/public/slippage실시간 체결 슬리피지 사다리, 주문 크기별로 실제 오더북에서 산출, 매시간 기록.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/slippage | jq '.ladders[:3]'
/api/public/whales고래 테이프: 자체 소켓에서 수집한 $1M+ 공격적 시장 체결, 24h 집계와 매수 비중.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/whales | jq '.window_24h'
/api/public/indicatorsBitcoin 사이클 지표, 2012년부터의 1차 종가 기록을 바탕으로 매일 재계산합니다: Pi Cycle Top(교차 날짜 포함), Mayer Multiple, 200주 및 2년 MA, 골든 레이쇼 멀티플, 수익성 일수, stock-to-flow, 자체 노드의 Puell Multiple, Bitfinex 마진 포지셔닝. ?days= 윈도, ?points=0은 최신만.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/indicators?points=0' | jq '.latest, .pi_cycle_crosses'
/api/public/rsiRSI 히트맵: 8개 구간(15m to 1M)에서 Wilder RSI(14), 거래량 기준 crypto 상위 400개 Binance USDT 무기한 계약과 모든 TradFi perp, 구간별 과매수 및 과매도 수 포함. ?symbol=, ?kind=crypto|tradfi 및 ?sort=<interval>로 필터와 정렬.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/rsi?sort=4h' | jq '.summary, .rows[:5]'
/api/public/venues/oi-history멀티 거래소 OI 이력: 레지스트리의 모든 거래소에서 시간 중 가장 완전한 10분 스냅샷 기준으로 perp 미결제약정 총합의 시간별 집계(whitebit 및 bitmart 제외), DEX 비중(온체인 거래소는 dex_venues 필드에 표시)과 현재 OI 가중 펀딩. ?days=1..90, 기본 30; 2026-08-21부터 기록.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/venues/oi-history?days=7' | jq '.oi_weighted_funding_pct, .points[-1]'
/api/public/coverage커버리지 레지스트리, 실시간 산출: 거래소별 청산 피드와 kind(full, sampled, delayed, shadow, none), 시작일, 24h 이벤트 및 마지막 레코드, 거래소 및 시장별 10분 스냅샷 피드와 심볼 수 및 마지막 버킷, 펀딩 차익거래 레그, 포지셔닝 소스, 고래 테이프, 스팟 분 단위, 그리고 최신성 포함 Hyperliquid 고래 스캔.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/coverage | jq '.totals, .liquidations[:3]'
/api/seriesSuperChart 뒤의 기록 시계열을 모든 지표에 같은 형식으로 제공합니다. 매개변수: metric(price, volume, cvd_perp, cvd_spot, oi, funding, funding_agg, liquidations, long_short, top_traders, rsi, premium, etf_flow, borrow, whale_net), symbol(BTCUSDT), period(15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M; 회원 깊이는 1m, 3m, 5m, 10m), limit(최대 300개 봉; 회원 깊이는 최대 5,000개), to(ISO). 회원 깊이는 Builder 이상 키 또는 사이트에 로그인한 Terminal 멤버십에 제공됩니다. Free 또는 Terminal 키는 기본 깊이를 받고 1m, 3m, 5m, 10m 요청에는 403을 받습니다. 모든 응답에 출처가 표시됩니다. venue=<id>(bybit, okx, gate, hyperliquid 및 기록기의 모든 거래소)를 추가하면 해당 거래소의 가격, 미결제약정, 펀딩비를 받습니다. 기본값은 Binance입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/series?metric=oi&symbol=BTCUSDT&period=1h&limit=200' | jq '.source, .points[-3:]'
/api/public/orderbookBTC, ETH, SOL, XRP, DOGE, ADA, LINK, AVAX, LTC 및 BNB의 현물 호가창 깊이: Binance, Coinbase, Kraken, Bybit, OKX, Gate, MEXC, HTX, Bitget, Bitstamp, Gemini, Bitfinex, BingX, Crypto.com, Backpack, Binance US, Poloniex, LBank, Bitrue, XT, HashKey, DigiFinex, Bullish, WEEX, Deribit, Aster, Bitvavo, Independent Reserve 및 BtcTurk의 오더북을 중간가 20% 이내의 0.1% 구간으로 분할한 것, (USD 명목, bids 및 asks 배열), 가장 큰 벽과 거래소 분할, 2% 깊이와 거래소별 오더북 도달 범위; ?hours=1..24는 5분 합산 이력을 추가합니다. 각 거래소 행에는 in_aggregate가 있으며, false는 규모가 확인되지 않아 기록은 하지만 합계와 벽에서 제외한 오더북을 뜻합니다. held_out은 해당 거래소 목록이고 aggregate_venues는 합산되는 거래소 수입니다. 거래소별 원시 스냅샷은 유료 경로 /api/x402/orderbook-history.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/orderbook?symbol=BTC&hours=6' | jq '.walls[:5], .venues'
/api/public/positioningBinance USDT perps 상위 30종의 포지셔닝 보드: Binance, Bybit, OKX, Gate, HTX, Bitget 및 Kraken Futures 각 거래소가 직접 공개하는 롱/숏 계정 및 포지션 비율과 테이커 플로우, Bitfinex 현물 마진 장부의 롱·숏 마진 포지션 규모(무기한 계정이 아닌 마진 차입자), GMX 및 Jupiter Perps의 달러 기준 롱·숏 미결제약정(풀 기반 무기한 DEX: 계정 비율이 아닌 방향별 분할), 그리고 BTC, ETH, SOL의 CVD 시계열(24h는 5m, 7d는 1h). 시간별 이력은 유료 경로 /api/x402/positioning-history.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/positioning?symbol=BTCUSDT' | jq '.rows[0]'
/api/public/desk데스크 노트, 최신순: 데스크 작성기(AI 모델)가 ByKaranteli가 직접 기록한 파생상품 데이터로 작성하고 발행 전 데이터와 대조한 짧은 날짜별 관찰이며, 각 노트에 UTC 발행 시각, 카드 데이터 시각, 데스크의 0~10 뉴스 가치, 근거 보드, 언급 코인, 고유 URL이 있습니다. 기본값은 최근 24시간; ?day=YYYY-MM-DD는 UTC 하루, ?since=<iso>는 최대 7일 전까지, ?type=<card>는 카드 유형 하나, ?lang=zh|ru|ko는 번역(번역이 없는 노트는 영어로 반환되며 표시됨), ?limit=1..100. 날짜와 언어를 아우르는 아카이브는 /api/x402/desk-notes-history, 노트별 영어 본문은 무료 데이터셋 desk-notes, RSS는 /desk/feed.xml입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/desk?limit=5' | jq '.notes[] | {published_at, type, headline, url}'/api/v1/proofBYK Data Layer의 Proof API(베타)입니다. 5분마다 저희가 산출한 데이터(합성 펀딩, 합산 미결제약정, 5분 청산, 호가 깊이, 프리미엄, 압력 점수)를 머클 루트로 묶어 서명한 뒤 Solana에 기록하고 하루에 한 번 Base에도 기록합니다. 키가 필요 없습니다. 인덱스는 최근 에포크와 체인 링크를 보여 주며 /genesis, /authorization-log, /epochs/{sequence}, /epochs/{sequence}/records, /proofs/{sequence|latest}/{feed}/{asset}(리프, 감사 경로, 매니페스트, 서명, 앵커), /witness-keys/{kind}/{n}, /documents/{hash}, /catalog는 검증기에 필요한 정확한 바이트를 돌려줍니다. 브라우저 내 검증기가 있는 페이지는 /proof 입니다. /api/public/pressure, /api/public/premium(업비트 김치 프리미엄 행), /api/public/orderbook, /api/public/turkey-premium의 데이터 응답에는 byk_proof가 포함됩니다. 같은 계산의 최신 봉인 레코드(sequence, proof_url, sealed_value)와, 옆의 숫자가 봉인된 값인지 알려 주는 matches_this_value입니다. Solana와 Base만 읽는 단일 파일 독립 검증기: /byk-verify.mjs.
curl -s 'https://bykaranteli.com/api/v1/proof/proofs/latest/BYK.FUNDING.COMPOSITE.B/BTC' | jq '{sequence, result, value: .decoded.value_decimal, unit: .decoded.unit, leaf_index, path: (.audit_path | length), solana: .anchors.solana[0].links.explorer}'/api/public/jupiterJupiter Perps(Solana) 보드: 온체인 수탁 상태에서 산출한 시장별 정확한 롱 및 숏 미결제약정(SOL, ETH, BTC), 풀 활용도와 시간별 차입 금리, JLP AUM과 APR, 24h 거래량, 이번 주 실현 PnL 기준 상위 트레이더. ?base=SOL&days=7은 시간별 OI 이력 추가(최대 30일).
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/jupiter?base=SOL&days=1' | jq '.markets[0], .history.points[-1]'
/api/public/solana-perpsSolana Perps 보드: 당사가 읽는 모든 Solana 무기한 계약 거래소(Jupiter, Pacifica, Phoenix, GM Trade, Velocity, Bullet)를 10분마다 갱신합니다. venues는 거래소별 단방향 미결제약정(oi_usd, 풀 기반 거래소는 oi_long_usd와 oi_short_usd도 제공), 24h 거래량, 시장 수, 시간당 요율 중앙값과 rate_kind(Jupiter: borrow_hourly, 풀의 시간당 차입 수수료; 나머지 거래소: funding_hourly), as_of를 제공하며, 피드 실패로 마지막 정상 판독값을 보여줄 때는 stale: true가 붙습니다. totals는 합계이며, markets는 모든 거래소의 모든 시장을 미결제약정이 큰 순으로 나열합니다(instrument_type, 마크 가격, 24h 변동, 거래소가 공개하는 경우 양측을 포함한 USD 미결제약정, 24h 거래량, 포지션 대비 퍼센트 시간당 요율, 거래소가 공개하지 않는 수치는 null). ?venue=jupiter|pacifica|phoenix|gmtrade|velocity|bullet은 시장을 필터링하고, &symbol=SOL&days=1..30은 Jupiter를 제외한 모든 거래소의 시장 하나에 대한 시간별 이력을 추가합니다(Jupiter 이력은 /api/public/jupiter에 유지). 모든 키로 7일 이력을 받을 수 있으며, 7일 초과는 회원 깊이입니다(Terminal 세션 또는 Builder 이상 키). 전체 시간 단위 세트는 유료 경로 /api/x402/solana-perps-history에, 자정 행은 solana-perps-daily 데이터셋에 있습니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/solana-perps?venue=phoenix&symbol=SOL&days=1' | jq '.totals, .venues, .markets[0], .history.points[-1]'
/api/public/hyperliquid-whalesHyperliquid 고래 추적기: 순자산 기준 상위 1000개 계정을 5분마다 스캔, 코인별 롱 대비 숏 명목과 각 방향의 최대 포지션, 모든 개별 포지션, 그리고 events=1일 때 최근 200개 포지션 변경(개시, 종료, 증가, 감소, 전환), address=0x...는 한 계정만 남깁니다. 전체 이벤트 이력은 유료 /api/x402/hl-whale-events.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/hyperliquid-whales?coin=BTC&events=1' | jq '.by_coin, .events[:5]'
/api/public/hyperliquid-positions코인 하나의 Hyperliquid 청산가 지도입니다. 순자산 기준 상위 1000개 계정의 미결제 포지션을 Hyperliquid가 포지션마다 제공하는 청산가에 배치하고 마크 가격의 0.25% 구간으로 묶습니다. long(마크 아래)과 short(위)은 가까운 구간부터 price, notional_usd, positions, 부호 있는 distance_pct를 나열합니다. totals는 모든 포지션을 세며 without_liq_px는 청산가가 없는 교차 증거금 포지션입니다. largest는 방향별 최대 구간, model_comparison은 LiqMap 모델의 방향별 가장 가까운 클러스터와 가장 가까운 추적 구간을 나란히 둡니다(LiqMap 범위 밖이면 null). coverage는 1000개 계정 중 응답한 수와 시각, history는 2026-09-30부터 기록한 시간별 롱과 숏 명목입니다. 포지션별 행은 /api/x402/hl-positions-history.
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| coin | string | 아니오 | Hyperliquid 코인 이름, 기본값 BTC. kPEPE 같은 이름은 대소문자 구분 없이 맞춥니다. 그 외 값은 400을 반환합니다. |
| hours | integer | 아니오 | 시간별 이력: 기본값이자 모든 호출자에게 24시간, 회원 깊이는 최대 720시간. |
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/hyperliquid-positions?coin=BTC' | jq '{coin, mark, coverage, largest, model_comparison, nearest_long: .long[:3], nearest_short: .short[:3]}'/api/public/tradfiTradFi 무기한 계약 보드: 모든 Binance 주식, 지수 및 원자재 perp의 펀딩, 베이시스, 미결제약정, 24h 거래량 및 청산, 다른 거래소의 상장 여부, 거래 세션 상태. ?market= 및 ?symbol=로 필터.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/tradfi?market=EQUITY' | jq '.rows[:5]'
/api/public/liquidations기록된 24h 청산을 방향별, 심볼별, 거래소별로 보여주며, 각 거래소의 커버리지 종류와 입력값이 포함된 커버리지 조정 시장 추정치입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/liquidations | jq '{recorded, market_estimate, by_exchange}'/api/public/liquidation-leaderboard집계 거래소 전체의 최근 24h, 7d 또는 30d 최대 단일 청산(순위, 심볼, 거래소, 방향, 가격, 수량, 명목가치, 시각)과 30일 세션 히트맵: 요일 x UTC 시간 칸, 시간별과 요일별 합계, 아시아, 유럽, 미국 비중.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/liquidation-leaderboard?window=7d&limit=10' | jq '{window, largest: .largest[:3], sessions: .sessions.sessions}'/api/public/tokenized-stocks토큰화 주식: xStocks, Robinhood Stock Tokens, Coinbase Tokenized Stocks, Binance bStocks, Ondo Stocks, Backpack Securities, Reality (Bitget), Superstate Opening Bell, Figure, Dinari dShares 및 Securitize (Exodus)의 온체인 래퍼를 기초 주식별로(발행사, 체인, 가격, 실제 주가 대비 프리미엄, DEX 유동성과 24시간 거래량, 공급량, 보유자, 상태), 거래소 토큰화 현물 페어, 기준 가격과 세션, 무기한 선물 비교와 보드 합계를 10분마다 갱신합니다. 래퍼는 발행사 출처에서만 가져옵니다: Backed 공개 API(xStocks), Robinhood 자산 API, Coinbase 토큰화 주식 API, Binance 코인 목록과 컨트랙트 지문(bStocks), Ondo 주소 CSV와 컨트랙트 지문, Jupiter 검증 토큰 목록(Backpack), Gate 현물 마켓 목록(gStocks, 거래소 전용), Reality API와 신원 확인, Superstate API, Provenance 제한 주식 마커(Figure), Dinari 팩토리 소속 확인(dShares) 및 Algorand 자산 기록(Exodus 주식 토큰, 명의개서 대리인 Securitize). 래퍼마다 price_source가 공급량 달러 값을 매긴 가격을 알려 주며(reference: 주식 기준 가격, issuer_oracle: 발행사가 토큰에 제시한 가격, wrapper: 자체 풀 또는 거래소 가격, null: 달러 값 없음), totals.priced_by는 가격 없음을 포함해 단계별 래퍼 수를 셉니다. ?underlying=TSLA, ?issuer=xstocks | robinhood | coinbase | bstocks | ondo | backpack | gstocks | reality | superstate | figure | dinari | securitize, ?chain=solana, ?top=1..200(기본 50). 일별 CSV는 tokenized-stocks-daily, 래퍼별 시간 단위 행은 /api/x402/tokenized-stocks-history.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/tokenized-stocks?top=5' | jq '{supply_usd: .totals.supply_usd, premium_median_pct: .totals.premium_median_pct, rows: [.rows[] | {underlying, supply_usd, wrappers: [.wrappers[] | {issuer, chain, price, premium_pct}]}]}'/api/public/insurance-fundsBinance, Bybit, OKX, Gate, MEXC, Bitfinex, Crypto.com, Delta Exchange, dYdX 및 Paradex의 거래소 보험 기금: 거래소별 최신 시간당 읽기(USD 합계, 자산별, 24시간 및 7일 변화, 거래소 무기한 미결제약정 대비 기금), 모든 풀과 거래소별 일별 종가. ?venue=binance | bybit | okx | gate | mexc | bitfinex | cryptocom | delta | dydx | paradex, ?days=1..366, ?pools=0은 풀 행을 뺍니다. 일별 CSV는 insurance-funds-daily, 시간별 풀 행은 /api/x402/insurance-fund-history. 공개를 멈춘 거래소는 마지막 읽기로 최대 48시간 동안 포함되어 stale_venues에 표시되고, 이후 합계에서 빠져 missing_venues에 표시됩니다. 합계에는 Binance, Bybit, OKX 및 Gate의 읽기가 필요합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/insurance-funds?days=7&pools=0' | jq '{total_usd, change_24h_pct, venues: [.venues[] | {venue, total_usd, coverage_pct}]}'/api/public/incidents자동 감지된 청산 연쇄, 규모, 방향, 코인 및 가격 경로 포함.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/incidents | jq '.incidents[0]'
/api/public/oi주요 무기한 계약 10개의 미결제약정 보드입니다(5분 해상도). 종목별 USD 기준 OI, 미결제약정과 가격의 24시간 변화, 국면 판독(longs_building, shorts_building, deleverage_down, deleverage_up, quiet)을 제공하며, last_bar_utc는 최신 바 시각입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/oi | jq '.symbols[:5]'
/api/public/correlations상위 무기한 계약의 일간 수익률에 대한 30일 롤링 Pearson 상관행렬.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/correlations | jq '.symbols'
/api/public/chargePsiCharge 유동성 상태 모델: 점수, 상태 및 연도별 공개 스코어카드.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/charge | jq '{score, state}'/api/public/quantum자체 노드에서 일 단위로 측정한 양자 노출 Bitcoin 공급량, 출처 해시 포함.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/quantum | jq '.latest | {exposed_btc, base_height}'/api/public/macroFRED를 통한 공식 거시 시계열: 정책금리, 인플레이션과 고용, 중앙은행 대차대조표, 미 국채 곡선과 Fed 광의 달러지수, 그리고 자체 글로벌 유동성 종합지표(공식은 composite)와 스테이블코인 공급, latest, series, groups, definitions(이름, 단위, 주기, 출처), ?days=365.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/macro?days=30' | jq '{composite: .composite.formula, liquidity: .latest.global_liquidity_busd, cpi: .latest.fred_cpi_yoy_pct, groups: [.groups[] | .key]}'/api/public/network자체 노드 기준 Bitcoin 네트워크 건전성: 해시레이트, 난이도, 수수료, mempool, ?days=365.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/network | jq '.latest'
/api/public/listings6개 거래소의 신규 및 상장폐지 무기한 계약, 시간별 스캔, ?days=30.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/listings | jq '.listed[:5]'
/api/public/context기록된 모든 지표에 대한 밴드 조건 문맥: 오늘의 위치와 이후 전개, ?metric=coinbase_premium_pct.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/context?metric=coinbase_premium_pct' | jq '{metric, today_value, interpretation}'/api/public/smart-money/[symbol]기록된 포지셔닝에서 단일 symbol에 대한 Smart-money 해석.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/smart-money/BTCUSDT | jq '.'
/api/v1/public/datasets/[name]CSV 또는 JSON 형식의 43개 데이터셋: market history, symbol board, listings, liquidations, ETF flows (total + by fund), COT, premium, DVOL, options chain + flow, metrics, quantum, theme indices, venue markets, whale trades, stablecoin pegs, basis, slippage. 전체 목록은 /data에서 확인 가능합니다. 일간 CSV 미러: github.com/bykarantelicom/crypto-datasets
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/v1/public/datasets/daily-market.csv | head -5
/api/v1/usage호출한 키의 계정이 플랜 대비 사용한 양이며, x-quota 헤더와 같은 수치입니다: plan(tier, label), rate.per_minute, monthly(limit, used, remaining, reset, state: ok, slow_lane, refused_until_reset 또는 unlimited), today(계정의 모든 키 호출 수), keys(active, limit), x402(included_calls_per_month, included_used_this_month, applies, requests_per_call, history_days(null이면 전체 아카이브), rows_per_call, raw_records_included; applies가 false이면 requests_per_call, history_days, rows_per_call은 null이고 raw_records_included는 false). 계정 키가 필요하며, 키 없이 호출하면 401 key_required로 응답합니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/v1/usage | jq '{plan, monthly, today}'/api/public/indices모든 market indices를 하나의 payload로 제공합니다: Retail Euphoria Index (proprietary) + Fear & Greed (alternative.me) + CoinGecko global + DeFiLlama stablecoin flow + Altcoin Season Index (top-50 alts vs BTC, 90d).
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/indices | jq '.euphoria.score, .fearGreed.today.valueRaw'
/api/public/euphoriaRetail Euphoria Index 단독 제공. F&G + trending memes + BTC dominance + top-30 crowd positioning의 복합 지표입니다.
curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/euphoria | jq '{score, regime, explainer}'/embed/pressure/[symbol]symbol의 현재 pressure score를 보여주는 임베드형 HTML 위젯입니다. iframe에서 사용합니다. 다크 테마, 추적 없음.
<iframe src="https://bykaranteli.com/embed/pressure/BTCUSDT" width="340" height="200" style="border:0"></iframe>
/embed/liquidations임베드형 24h 청산 위젯: 롱/숏 총계, 이벤트 수, 상위 symbol, 최대 체결. 갤러리와 약관은 /widgets에서 확인 가능합니다.
<iframe src="https://bykaranteli.com/embed/liquidations" width="100%" height="300" style="border:0"></iframe>
/embed/orderbook/[symbol]추적 중인 10개 코인 중 하나에 대한 임베드형 현물 호가창 깊이 위젯입니다: 2% depth, 불균형, walls, mirrored bin strip.
<iframe src="https://bykaranteli.com/embed/orderbook/BTC" width="100%" height="380" style="border:0"></iframe>
/embed/positioning/[symbol]하나의 무기한 계약에 대한 임베드형 long/short 포지셔닝 위젯입니다, Binance, Bybit, OKX 비율 및 taker flow 포함.
<iframe src="https://bykaranteli.com/embed/positioning/BTC" width="100%" height="200" style="border:0"></iframe>
/embed/whales임베드 가능한 Hyperliquid 고래 위젯, 코인별 상위 1000개 계정의 롱 대비 숏 명목가치입니다.
<iframe src="https://bykaranteli.com/embed/whales" width="100%" height="330" style="border:0"></iframe>
/embed/rsi임베드 가능한 RSI(14) breadth 위젯, 구간별 과매수/과매도 개수와 ?interval의 극단값입니다.
<iframe src="https://bykaranteli.com/embed/rsi?interval=4h" width="100%" height="340" style="border:0"></iframe>
임베드 예시
이 코드를 아무 HTML 페이지에 넣으십시오. 위젯은 키가 필요 없고, 페이지를 열 때마다 최신 값을 보여 주며, 출처 링크가 프레임 안에 있습니다. 모든 위젯은 /widgets에 있습니다. 직접 레이아웃을 만들려면 서버에서 키로 API를 호출하고 그곳에서 수치를 렌더링하십시오. 브라우저 코드에서 호출하면 모든 방문자가 키를 볼 수 있으므로 호출하지 마십시오.
<iframe src="https://bykaranteli.com/embed/liquidations" width="100%" height="300" style="border:0;border-radius:12px;background:#0b0e14" loading="lazy" title="Liquidations 24h"></iframe>
속도 제한 및 할당량 헤더
호출 수를 직접 세지 말고 키를 사용한 모든 응답에서 이 헤더를 읽으십시오. GET /api/v1/usage는 계정 전체의 같은 수치를 한 번에 돌려줍니다.
| 헤더 | 언제 오는가 | 의미 |
|---|---|---|
| x-ratelimit-limit | 키를 사용한 모든 응답, 429 rate_limited | 이 키가 분당 보낼 수 있는 요청 수입니다. 플랜 속도이며, 느린 차선에서는 Free 속도입니다. |
| x-ratelimit-remaining | 키를 사용한 모든 응답 | 현재 1분 창에 남은 요청 수입니다. 429에서는 0입니다. |
| x-quota-limit | 월 한도가 있는 플랜의 키 응답 | 계정의 달력 월 요청 수이며, 모든 키를 합산합니다. |
| x-quota-used | x-quota-limit과 같음 | 계정이 이번 달력 월(UTC)에 보낸 요청 수입니다. |
| x-quota-reset | x-quota-limit과 같음 | 월 집계가 다시 시작되는 ISO 시각, 즉 다음 UTC 월의 첫 순간입니다. |
| x-quota-state | 유료 플랜의 공정 사용 한도를 넘은 뒤에만 | slow: 월이 초기화될 때까지 키가 무료 속도(분당 30회)로 응답하며, 멈추지는 않습니다. |
| retry-after | 모든 429, 503 lookup_unavailable | 다음 시도 전에 기다릴 초입니다. 지켜 주십시오. 더 일찍 재시도하면 거절만 늘어납니다. |
| x-bk-tier | 키 게이트를 거친 모든 응답 | 응답이 제공된 플랜입니다(이 사이트의 브라우저는 free). |
| x-history-window-days | 계정 키로 받은 포함 x402 카탈로그 응답(liqmap-levels, options-flow, flow-vpin 제외) | 플랜 카탈로그 기간이 거슬러 가는 일수이며 00:00 UTC부터 계산합니다. 전체 아카이브이면 all입니다. |
| x-history-row-cap | x-history-window-days와 같음, 대량 내보내기 제외 | 포함된 호출 1회가 플랜에서 반환하는 최대 행 수입니다. |
| x-x402-allowance-limit | 플랜이나 계정에 월 상한이 있을 때의 포함 카탈로그 응답 | 계정의 달력 월 포함 카탈로그 호출 수입니다. |
| x-x402-allowance-used | x-x402-allowance-limit과 같음 | 계정이 이번 달력 월(UTC)에 쓴 포함 카탈로그 호출 수입니다. |
| x-x402-allowance-reset | x402_allowance_used (HTTP 402) | 카탈로그 집계가 다시 시작되는 ISO 시각, 즉 다음 UTC 월의 첫 순간입니다. |
오류
HTTP 상태를 먼저 보고, 그다음 code를 보십시오. 키 게이트의 응답은 { error: '<문장>', code: '<code>' }(401 key_required에는 reason도 붙습니다: none, empty_authorization, empty_x_api_key, malformed_authorization, malformed_x_api_key, non_bearer_scheme), 경로 자체의 응답은 { ok: false, error: '<code>', message } 형태입니다. x402 플랜 응답(x402_allowance_used, history_window, raw_tier_required, tier_required, payment_required_for_credit)은 { error, code, tier, price_usd, docs }를 담고 payment_required_for_credit을 제외하면 upgrade도 담으며, 그 호출을 호출당 결제할 수 있다는 뜻입니다.
| HTTP | 코드 | 언제 | 조치 |
|---|---|---|---|
| 401 | key_required | 프로그램이 키가 필요한 경로를 호출하면서 계정 키를 보내지 않았거나, 키 헤더를 비워서 보냈거나, 전체 키가 아닌 값(bk_... 자리 표시자, 키 목록의 접두사, 설정되지 않은 변수)을 보냈거나, Bearer 방식을 쓰지 않았습니다. 응답 본문의 reason이 어느 경우인지 알려 줍니다. | /dashboard/api에서 무료 키를 만들어 Authorization: Bearer로 보내십시오. |
| 401 | invalid_key | 알 수 없거나 취소된 키이거나, 계정이 비활성 상태입니다. | /dashboard/api에서 키를 확인하고, 취소되었다면 새로 만드십시오. |
| 401 | wrong_key_type | 선불 bk_live 키를 계정 경로로 보냈습니다. | 선불 키는 /api/x402/*에서 호출당 결제에 씁니다. 여기에는 계정 키를 보내십시오. |
| 403 | email_unverified | 키를 소유한 계정이 이메일을 인증하지 않았습니다. | 이메일을 인증한 뒤 같은 키로 다시 시도하십시오. |
| 429 | rate_limited | 키가 분당 요청 수를 넘었습니다. | retry-after 초만큼 기다리십시오. 호출을 분산하거나 상위 플랜으로 옮기십시오. |
| 429 | monthly_quota_exceeded | Free 또는 Terminal 계정이 월 요청 수를 모두 썼습니다. | x-quota-reset까지 기다리거나 상위 플랜으로 옮기십시오. |
| 429 | fair_use_slow_lane | 공정 사용 한도를 넘은 유료 계정이 무료 속도도 넘었습니다. | retry-after 초만큼 기다리십시오. 월이 초기화되면 전체 속도가 돌아옵니다. |
| 503 | lookup_unavailable | 당사 쪽에서 키 확인이 실패했습니다. | retry-after 초 후 다시 시도하십시오. 이 호출은 집계되지 않았습니다. |
| 400 | unknown_venue, unknown_currency, unknown_metric, invalid_symbol | 쿼리 매개변수가 허용 값을 벗어났습니다. | 이 페이지의 해당 경로 설명에 맞춰 매개변수를 고치십시오. |
| 404 | not_available | 이 심볼에 대한 값이 경로에 없거나, 심볼이 폐지되었습니다. | 심볼을 확인하십시오. 폐지된 심볼은 응답에 후속 심볼이 나옵니다. |
| 503 | unavailable, temporarily_unavailable | 경로의 데이터를 지금 읽을 수 없습니다. | 1분 후 다시 시도하십시오. |
| 402 | (x402 결제 조건) | /api/x402/* 경로를 결제도 계정 키도 없이 호출했습니다. | x402 클라이언트로 결제하거나, x-api-key에 선불 bk_live 키를 보내거나, Builder 이상 키를 쓰십시오. |
| 402 | x402_allowance_used | 계정 키가 플랜의 월 카탈로그 상한(또는 ByKaranteli가 계정에 설정한 수치)을 넘었습니다. 응답 본문에 limit, used, reset이 있습니다. | 호출당 결제하십시오. 계정 키는 Authorization: Bearer 헤더로, 선불 키는 x-api-key에 넣어 보내거나, 계정 키 없이 보내 지갑으로 결제하십시오. 또는 상위 플랜으로 옮기십시오. |
| 402 | payment_required_for_credit | 계정 키로 /api/x402/prepaid-key를 호출했습니다. | 선불 크레딧은 구매 대상입니다. 지갑이나 기존 선불 키로 결제하십시오. |
| 403 | tier_required | 키의 플랜에 x402 카탈로그(Free, Terminal) 또는 대량 내보내기(Business 미만)가 포함되지 않습니다. | 호출당 결제하거나(계정 키는 Authorization: Bearer, 선불 키는 x-api-key, 또는 계정 키 없이 지갑) 상위 플랜으로 옮기십시오. |
| 403 | history_window | 계정 키가 플랜 이력 기간보다 이전의 행을 요청했습니다(from, to, days가 x-history-window-days보다 이전). 응답 본문에 history_days와 window_start가 있습니다. | window_start부터 요청하거나, 전체 아카이브는 호출당 결제하거나(계정 키는 Authorization: Bearer, 선불 키는 x-api-key, 또는 계정 키 없이 지갑), 상위 플랜으로 옮기십시오. |
| 403 | raw_tier_required | Business 미만 플랜의 키가 원시 기록 경로(liquidations-raw, liquidation-leaderboard-history, hl-whale-events, hl-positions-history, orderbook-history, spot-microstructure, venue-markets-history, whale-trades-raw)를 호출했습니다. | 호출당 결제하거나(계정 키는 Authorization: Bearer, 선불 키는 x-api-key, 또는 계정 키 없이 지갑) Business로 옮기십시오. |
API 변경은 변경 기록에 API 분류와 '호환성 변경' 표시로 남습니다.
공정 사용
- 속도 제한은 Free API 플랜에서 키당 분당 30개 요청입니다(Terminal은 60, Builder, Business, Scale은 300, 1,200, 3,000). 또한 무료 키는 달력 월마다 15,000회, Terminal 키는 150,000회까지 요청할 수 있습니다(2026-09-25부터 초과 시 429 monthly_quota_exceeded). Builder, Business, Scale의 공정 사용 한도는 월 1,000,000, 3,000,000, 10,000,000회이며, 이를 넘어도 유료 키는 멈추지 않고 월이 초기화될 때까지 무료 속도(분당 30회)로 응답합니다. 월 한도가 있는 플랜에서 키를 사용한 모든 응답에는 x-quota-limit, x-quota-used, x-quota-reset 헤더가 붙고, x-quota-state: slow는 느린 차선의 응답임을 표시합니다. 포함된 x402 카탈로그 호출 1회는 여기서 10회 요청으로 계산되며, 플랜의 카탈로그 상한에도 들어갑니다(Builder 월 1,000회, Business 10,000회, Scale 이상은 상한 없음). 사이트의 브라우저는 IP별로 제한됩니다. 한도를 넘으면 retry-after와 함께 429를 받습니다.
- 데이터는 읽기 전용입니다. PII나 거래 실행 기능은 제공하지 않습니다.
- 출처 표기, 다음으로의 보이는 링크를 권장합니다 bykaranteli.com 또는 소스 페이지, 예:
/symbols)을 임베드 시 표기해 주시면 감사하겠습니다. - 출처를 표기한 개인 및 연구 용도는 무료입니다. 당사가 계산한 데이터의 상업적 이용은 Business 플랜, 파생 데이터 재배포는 Scale 플랜이 필요하며, 원시 기록과 그 밖의 제3자 데이터는 모든 플랜에서 귀하 자신의 이용을 위한 것입니다. 당사 수치를 귀사의 자체 백테스트인 것처럼 재브랜딩하는 것은 어떤 경우에도 허용되지 않습니다.
- 내부 경로 스크래핑(
/dashboard/*,/api/admin/*,/api/member/*)은 차단 및 모니터링됩니다. 다음 항목만 사용하십시오/api/public/*.
투자 조언이 아닙니다. 반환되는 수치는 기록된 시장 데이터와 파생 지표이며 거래 권고가 아닙니다. 시장 데이터는 과거를 설명하며 미래 가격을 예측하지 않습니다.