공개 업데이트

사용할 수 있는 키 없이 키가 필요한 경로를 호출한 프로그램은 이제 게이트가 무엇을 보았는지 알 수 있습니다. 401 key_required 응답 본문에 reason 필드(none, empty_authorization, empty_x_api_key, malformed_authorization, malformed_x_api_key, non_bearer_scheme)와 이를 설명하는 문장이 담깁니다. 비어 있는 헤더, bk_... 같은 자리 표시자, 키 목록에서 복사한 접두사, 펼쳐지지 않은 셸 변수, 템플릿이 undefined로 바꾼 Bearer 값은 호출자 종류와 관계없이 어떤 조회보다 먼저 거부됩니다. 다른 헤더에 있는 키는 그대로 인정됩니다. 개발자 오류 표, 연결 안내, 공개 매니페스트가 이 필드를 설명합니다. 개발자 페이지, 대시보드, Playground, 연결 안내, 에이전트 카드의 모든 예시는 같은 BYKARANTELI_API_KEY 변수에서 키를 읽으며, 새 키 패널은 export 줄과 바로 실행할 수 있는 첫 호출을 보여 줍니다.

계정 키를 쓰면 tier_required도 다른 거절과 같이 호출당 결제하는 두 가지 방법(계정 키는 Authorization: Bearer, 선불 키는 x-api-key, 또는 계정 키 없이 지갑)과 플랜 링크를 알려 줍니다. ByKaranteli가 카탈로그를 끈 계정은 모든 경로에서 자체 문장을 유지합니다. /api/x402 항목에는 raw_records 옆에 included_from(builder, business, 또는 항상 구매하는 선불 키 상점은 null)이 있고, openapi.json은 경로 유형별 응답(400이 있는 경로의 400, 402, 403, 200 응답 헤더)과 x-raw-records, x-included-from을 나열합니다. networks-history와 leverage-tiers-history는 플랜 기간을 유효 기간에 적용하여, 기간 이전에 시작해 아직 유효하거나 기간 안에서 끝난 버전을 반환합니다. x-quota-used는 이제 응답하는 호출을 포함해 세며, 느린 차선에서도 그렇고 포함된 카탈로그 호출은 전체 가중치로 세므로 /api/v1/usage와 같습니다.

/api/x402/funding-history가 읽는 테이블에는 Binance USDT-M 무기한 계약의 정산 기록만 있습니다. 지금까지 exchange 필터가 값을 내부 소스 이름과 비교해 exchange=binance가 빈 결과를 반환했습니다. 이제 exchange=binance(대소문자 무관)는 모든 행을 읽고, 다른 거래소는 조회 전에 400으로 응답하며 과금되지 않습니다. 파라미터 없이 보낸 호출은 이전과 같습니다. 이 경로와 bulk-derivatives 파일은 이제 담긴 범위를 그대로 밝힙니다. TradFi 무기한 계약과 저희 페이지가 매일 읽는 심볼은 빠짐없이 기록되며, 드물게 읽히는 계약에는 공백이 있을 수 있습니다. 플랜 페이지: 대량 내보내기는 플랜의 이력 기간을 따르며 Business는 최근 365일, Scale은 전체 아카이브를 월별 파일로 제공하고 이번 달 파일은 매일 갱신됩니다. Scale 항목에서는 플랜에 없던 일간 원시 내보내기 문구를 뺐습니다.

계정 키는 플랜 안에서 월 상한, 이력 기간, 호출당 행 상한에 따라 /api/x402 카탈로그를 읽습니다. Builder: 월 1,000회 카탈로그 호출 포함, 최근 90일, 호출당 최대 5,000행, 요약 시리즈만 제공합니다(원시 기록 경로는 호출당 결제). Business: 월 10,000회, 최근 365일, 호출당 최대 20,000행, 원시 기록 포함. Scale과 Enterprise: 상한 없음, 전체 아카이브, 원시 기록 포함. 기간은 00:00 UTC부터 계산하며, 포함된 호출 1회는 계속 플랜의 월 공정 사용에서 10회 요청으로 계산됩니다. 원시 기록은 개별 청산 이벤트와 최대 체결 순위, 고래 체결, Hyperliquid 포지션 이벤트와 시간별 포지션 기록, 호가창 스냅샷, 분봉, 거래소별 시장 스냅샷입니다. 새 응답 두 가지는 모두 호출당 결제로 이어집니다: 403 history_window(from, to, days가 플랜 기간보다 이전)와 403 raw_tier_required(Business 미만 플랜에서 원시 기록 경로 호출). x402_allowance_used(HTTP 402)는 다시 플랜 상한을 뜻합니다. 요청에 계정 키가 있을 때 호출당 결제하려면 계정 키는 Authorization: Bearer 헤더로, 선불 키는 x-api-key에 넣어 보내거나, 계정 키 없이 보내 지갑으로 결제하십시오. 포함된 응답에는 x-history-window-days와 x-history-row-cap(liqmap-levels, options-flow, flow-vpin에는 둘 다 없고 대량 내보내기에는 후자가 없음)이, 상한이 있으면 x-x402-allowance-limit과 x-x402-allowance-used가 붙습니다. /api/v1/usage에는 history_days, rows_per_call, raw_records_included가 추가됩니다. 지갑과 선불 호출은 그대로입니다: 경로별 행 상한으로 전체 아카이브를 읽으며 호출당 $0.10입니다. 플랜, API 문서.

/api/liqmap/v3는 LiqMap 페이지 자체의 데이터 읽기입니다. 회원 세션이 없고 브라우저에서 오지 않은 요청(curl이나 스크립트처럼 Fetch Metadata가 없는 요청)은 이제 /api/liqmap/public과 같은 401 key_required 응답을 Cache-Control: no-store와 함께 받습니다. 페이지 자체와 다른 브라우저는 이전과 같이 읽으며, 계정 키가 있는 요청은 다른 키 호출과 똑같이 처리되고 집계됩니다. 프로그램은 무료 계정 키로 GET /api/liqmap/public 또는 GET /api/public/liqmap을 사용하십시오.

GET /api/public/liqmap과 모든 LiqMap 페이로드는 이제 meta.inputs_present(ticker, orderbook, long_short, open_interest, funding, liquidity_snapshots, 입력이 모델에 도달하면 true)와 meta.degraded(시장 입력인 티커, 호가창, 롱숏 비율, 미결제약정, 펀딩 중 하나가 없어 중립 기본값이 대신 쓰이면 true)를 담습니다. liquidity_snapshots는 참고용이며 심도 수집기는 유니버스의 일부를 다룹니다. 얇은 지도는 이제 완전한 지도로 보이는 대신 얇은 지도로 읽힙니다.

wss://bykaranteli.com/ws/v1 스트림에 새 스냅샷 채널 tokenized가 추가되었습니다: GET /api/public/tokenized-stocks와 같은 페이로드의 토큰화 주식 보드(래퍼별 발행사, 체인 또는 거래소, 가격, 기준가, 프리미엄, 공급량과 as_of)로, 변경 시 전송됩니다. 구독은 {"op":"subscribe","channel":"tokenized"}이며, 모든 스트림 채널을 여는 플랜이면 이 채널도 열립니다. 채널 표는 /ko/developers에 있습니다.

Builder와 Business 키에는 월 포함 카탈로그 호출 상한이 있었고 이를 넘으면 402를 받았습니다. 상한이 사라졌습니다. Builder 이상 키는 /api/x402의 모든 경로를 플랜 안에서 호출하며, 성공한 카탈로그 호출 1회는 플랜의 월 공정 사용에서 10회 요청으로 계산됩니다. x-quota 헤더와 /api/v1/usage가 보여주는 숫자와 같습니다. 공정 사용을 넘으면 키는 Free 속도로 느려질 뿐 멈추지 않습니다. Free와 Terminal 키, 지갑, 선불 키는 이전처럼 호출당 결제합니다. 플랜, API 문서.

/api/public/macro는 모든 매크로 시리즈를 그룹, 합성 지표의 공식과 입력, 시리즈별 라벨, 단위, 주기, 변환, 출처, 첫 날짜와 함께 제공하며, latest는 기간과 무관하게 시리즈별 최신 행입니다. /api/public/events는 FOMC 옆에 cpi와 nfp 블록을 더합니다. 측정된 반응, 평소 30분 대비 크기, 상승 비율, 다음 예정 발표, 그리고 차트 표시가 읽는 날짜 있는 이벤트 행입니다. API 문서.

GET /api/public/hyperliquid-positions?coin=BTC는 청산 가격 지도와 시간별 아카이브(모두에게 24시간, 회원 깊이로 720시간)를 돌려줍니다. ?address=로 /api/public/hyperliquid-whales와 /api/x402/hl-whale-events를 거를 수 있고, 유료 /api/x402/hl-positions-history는 시간별 아카이브 행을, 무료 hl-position-levels 데이터셋은 현재 구간을 제공합니다. 회원 경로 /api/member/hl-addresses는 세션이나 계정 키를 받습니다. MCP: get_hl_positions, list_tracked_addresses, add_tracked_address, remove_tracked_address. API 문서.

GET /api/public/options/chain?currency=BTC는 만기와 행사가별 미결제약정과 IV, 지난 1시간과 24시간의 변화, 최근월 만기의 시간별 ATM IV를 제공합니다(모두에게 가장 큰 행사가, 회원 깊이는 ?strikes=all로 전체 행사가). /api/public/options-flow와 유료 /api/x402/options-flow에는 옵션 유형별 부호 있는 1h, 4h, 24h 매수, 매도, 순 프리미엄, 만기, 행사가, 거래소 분해, 다리로 이름 붙인 최신 다중 레그 구조가 추가됩니다. 데이터셋 options-chain-hourly, 유료 /api/x402/options-chain-history. MCP: get_options_chain. API 문서.

/api/public/tradfi-gaps(window, symbol)와 /api/public/venue-share(days), 데이터셋 tradfi-gaps와 venue-share-daily, 집계 거래소별 시간 행과 시간 합계, 점유율을 담은 유료 /api/x402/venue-share-history. MCP: get_tradfi_gaps, get_venue_share. API 문서.

키를 붙여 /api/v1/usage에 GET 요청을 보내면 호출한 키의 플랜, 속도 제한, 이번 달 사용한 할당량과 초기화 시각, 오늘의 호출 수, 계정의 키 목록, x402 허용량을 반환합니다. 속도 및 할당량 응답 헤더와 오류 표는 /ko/developers에 정리되어 있습니다.

/ko/developers의 모든 REST 예제에 계정 키 헤더가 들어 있으며 적힌 그대로 실행됩니다. 매니페스트와 OpenAPI 문서의 개수는 코드에서 읽으므로 API가 실제로 제공하는 것과 일치하고, ru와 ko 판도 모든 엔드포인트를 나열합니다.

플랜: Terminal에는 취미용 API 한도(분당 60회, 월 150,000회)가 있습니다. Builder, Business, Scale의 공정 사용 한도는 월 100만, 300만, 1,000만 회 호출이며, 이를 넘으면 무료 속도로 느려질 뿐 멈추지 않습니다. x402 카탈로그는 Builder에서 월 1,000회, Business에서 월 10,000회 호출까지 포함되며 Scale은 무제한입니다. 가격은 그대로입니다.

/api/x402 아래 모든 유료 경로는 이제 호출당 USDC $0.10입니다(Solana 또는 Base). 이전에는 $0.002에서 $0.01이었습니다. 선불 키는 $10 그대로이며 이제 100회 호출에 사용할 수 있습니다. 카탈로그, /openapi.json, .well-known/x402 문서와 개발자 문서가 한 곳에서 가격을 읽으므로 함께 바뀌었습니다.

wss://bykaranteli.com/ws/v1 with the same account key on the handshake. Event channels push liquidation prints from nine venues, $1M+ whale prints, Hyperliquid whale position events and your own alert firings as they happen, each with a seq you can resume from; snapshot channels push pressure, open interest, funding and LiqMap only when the payload changes, in the same shape as the REST routes. Paid plans only: Builder gets one connection with liquidations for three named symbols, Business opens all nine channels with five connections and 15 minutes of replay, Scale and Enterprise raise every limit. Protocol, examples and error codes on /developers; connection, frame and time usage on /dashboard/api.

/pricing now says plainly what it sells: Terminal for people ($29 a month, 1 to 12 month terms) and the API plans for programs (free key, Builder $49, Business $149, Scale $399), with one table that lists every feature side by side. Free and Terminal keys carry a quota of 15,000 requests per calendar month (UTC): every keyed response reports it in x-quota-limit, x-quota-used and x-quota-reset, and from 2026-10-01 a key over the quota answers 429 until the month resets; Builder and above have no monthly cap. Two enforcement fixes: a program that sends browser headers but names itself in the User-Agent is treated as a program and needs a key, and 5-minute SuperChart bars with 5,000 bars of history are a Terminal feature again for signed-in accounts (a free account sees the public depth). The hosted MCP endpoint caps keyless clients at 600 tool calls a day per client; a key lifts that. /dashboard/api shows the month's calls against the quota.

The public JSON API now takes an account key from programs: a free key comes with any verified account (/dashboard/api, 30 requests a minute) and is required for scripts, bots and agents from 2026-09-10; pages on the site keep working without one. New plans for code on /pricing: Builder $49, Business $149 and Scale $399 a month buy rate, member depth on the API (LiqMap on seven timeframes, 5-minute series) and, from Business, a commercial licence and bulk exports; every paid API plan includes the Terminal membership, and members active today keep Builder rights for the rest of their period. Datasets served from this site are now under the ByKaranteli Data Licence (personal and research use with attribution, see /data); files published earlier on the GitHub, Kaggle, Hugging Face and Zenodo mirrors stay CC0 and stop updating. The MCP package 0.26.0 reads BYKARANTELI_API_KEY.

The rule-based signal engine, its receipts, strategy pages and performance APIs were removed. The former hub pages redirect to the data they were built on (/data, /symbols, /methodology) and individual receipt URLs answer 410 Gone. The symbol pages now show recorded price, funding, open interest and the derivatives pressure score; the MCP server serves 45 data tools. Nothing about the recording network changed.

13 dataset routes are listed in the Coinbase Bazaar directory with live CDP settlement. Agents can pay per call with USDC; the free snapshots stay free. Details at /developers.