开发者参考

在握手时通过 Authorization: Bearer bk_... 发送账户密钥（与 REST API 同一把）。查询字符串中的密钥会被拒绝。免费与 Terminal 密钥返回 403 plan_required。

bykaranteli-mcp 是一个官方 MCP（模型上下文协议）服务器，将本 API 以 68 个工具的形式暴露给 Claude、Cursor 以及任何其他支持 MCP 的助手：市场指数、资金费率热力图、资金费率套利、压力评分、涨跌幅榜、交易对看板、每日强平数据、美国现货 ETF 资金流、CFTC COT 持仓、期权快照、Coinbase 溢价、订单流毒性、期权大单流、滑点阶梯、FOMC 影响、强平级联、持仓量，以及稳定币充能状态。免费账户密钥（BYKARANTELI_API_KEY），Node 18+。看板之外：get_series 按指标、交易对和周期返回任意已记录序列，parse_alert_text 把 "BTC funding above 0.05%" 这样的一句话转换为提醒，账户工具使用同一密钥列出和修改您自己的提醒与自选列表（会修改内容的工具标注为写入操作，计入您的套餐用量，并记录在您的账户中）。每个市场数据回答都带有 provenance 数据块：数字背后的交易所、完整或抽样覆盖、数据新鲜度以及证明页面。

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 协议按次以 USDC 计价，自主代理无需账号、API 密钥或订阅即可购买单次结果。每次请求在链上结算，双方都无需注册。按次付费的调用以每次 $0.10 读取全部历史，行数上限为各路由自身的上限。Builder 及以上密钥无需付费即可在方案内调用同样的路由：Builder 每月 1,000 次目录调用，覆盖最近 90 天，每次最多 5,000 行，仅汇总序列；Business 每月 10,000 次，覆盖最近 365 天，每次最多 20,000 行，含原始记录；Scale 与 Enterprise 不设上限，覆盖全部历史。时间窗口从其第一天的 00:00 UTC 起算，每次包含的调用还按 10 次请求计入方案的每月公平使用。原始记录（单笔强平事件与最大成交排行、巨鲸成交、Hyperliquid 仓位事件与每小时仓位记录、订单簿快照、分钟 K 线以及各交易所市场快照：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 及以上，不计入上限，仅列出与方案时间窗口有交集的月份。

# 1. Ask without payment: the endpoint answers 402 with machine-readable terms
curl -i https://bykaranteli.com/api/x402/flow-vpin

# 2. Any x402 client pays and retries automatically
npm i @x402/fetch @x402/core @x402/svm
# wrapFetchWithPayment(fetch, client) -> 200 + data, settled in USDC

价格按成功响应计费：失败的请求不结算任何费用。付费购买的是深度与历史，而非访问权限：上述所有实时快照凭账户密钥在方案限额内始终免费。

交易对看板：每个追踪的 Binance USDT-M 永续合约的记录 24 小时行情、资金费率、持仓量变化与衍生品压力评分。

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"
    }
  ]
}

单个 Binance USDT 永续合约的 Market Profile（市场轮廓），基于我们自己记录的 1 分钟 K 线，每个已收盘 UTC 日一行，最新在前：poc（TPO 标记最多的价格档位）、val 与 vah（70% 价值区域）、ib_low 与 ib_high（UTC 第一个小时）、vpoc（成交额最大的档位）、open、high、low、close、tpo_total 与 periods。naked_pocs 列出最近 60 个记录日中尚未被之后任何已收盘交易日触及的控制点；profile_latest 给出最新一日各档位的 [price, tpo, volume_usd]。TPO 时段 30 分钟，档位为当日开盘价的 0.05%。任何密钥可取 30 天；最多 400 天为会员深度（Terminal 会话或 Builder 及以上密钥）。未记录 1 分钟 K 线的币种返回 404 no_profile。每日关键价位见 market-profile-daily 数据集；每日完整轮廓见付费接口 /api/x402/market-profile-history。

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}'

股票、指数与大宗商品永续相对我们自己记录的美股现货收盘价的周末与隔夜跳空：基准为纽约时间 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。

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'

每个计入强平交易所（Binance、Bybit、OKX、Gate、HTX、dYdX、Aster、Lighter、Kraken Futures、GMX 与 Deribit）在 days=1（默认）、7 或 30 天记录总额中的占比：usd、long_usd、short_usd、events、share_pct、long_share_pct、since（交易所首个计入日落在窗口内时给出）以及 trend_pp（最近 7 天占比减去此前 7 天占比；若该交易所在较早区间内未全程计入则为 null）。daily 为最近 30 个 UTC 日按交易所的每日占比表（今日未完结）；oi 给出各交易所在最近一小时与 7 天内的永续持仓量占比。影子交易所与没有公开数据流的交易所不在总额中。每日行即 venue-share-daily 数据集；按交易所的小时行及每小时总额在付费接口 /api/x402/venue-share-history。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/venue-share?days=7' | jq '{total_usd, venues: [.venues[] | {exchange, share_pct, trend_pp}]}'

为每个被追踪的 Binance USDT-M 永续合约计算的 0-100 综合衍生品压力评分（OI 增量 1h/4h/24h + 资金费率 + 基差）。区分方向的市场状态。

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" ]
    },
    …
  ]
}

单个交易对的压力快照，若缓存过期则实时刷新。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/pressure/BTCUSDT

33 家交易所（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]'

公开 LiqMap 快照（24H）：聚合 Binance、Bybit、OKX、Gate、HTX 与 Hyperliquid 的 201 个主流永续合约强平价位估算，并叠加实际强平。?symbol=BTC..OP。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/liqmap/public?symbol=BTC' | jq '.real_levels.totals'

资金费率快照，覆盖一组固定的大型 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]'

压力榜的异动榜：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]'

山寨季指数：实时读数、最强与最弱的大市值山寨币、每日记录的历史。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/altseason | jq '.value'

八个等权叙事指数（AI、RWA、DePIN、meme、L1、L2、DeFi、量子），固定篮子与自 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}'

因子面板：每个记录指标所在历史区间，及其后 7 天 BTC 中位数变动与基准率的对比。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/factors | jq '.rows[:5]'

杠杆借贷利率：各交易所各资产最新年化利率（我们能读取借贷历史的每家交易所的 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]'

交易手续费表：各交易所各市场类型的基础档挂单与吃单（按交易对定价时取各对中位数），每日从各交易所自己的费率接口读取，附费率变更日志。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/fees' | jq '.median_taker_perp, .rows[:5]'

到期日历与结算价格：来自 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]'

单个交易所及我们记录的全部内容：按类型的在档合约、来自 10 分钟记录器的篮子未平仓合约与平均资金费率、杠杆阶梯摘要、充提网络数量、基础费率表、状态可用率和近期事件日志。?venue=bybit；不带参数返回已记录交易所 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]'

我们记录的每个交易所的充提网络，每日以缓慢变化的行记录：按资产和网络的充值标志、提现标志、提现费用和最低额，以及暂停和恢复日志。不带参数：当前暂停提现的组合，按重要性排序。?asset=USDT：该资产在每个交易所和网络上的情况；?venue=kucoin 缩小范围。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/withdrawals?asset=USDT' | jq '.rows[:5]'

我们能读取其杠杆阶梯的每个交易所上每个永续合约的杠杆阶梯，每日以缓慢变化的行记录：档位、名义下限与上限、最大杠杆、维持保证金率，以及杠杆上调和下调的变更日志。?symbol=BTC 缩小到一个币种，?venue=okx 缩小到一个交易所；不带参数返回跨交易所概览。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/leverage-tiers?symbol=SOL' | jq '.rows[:5]'

场所层聚合，覆盖我们轮询的每个永续与现货行情源（见 coverage 字段）：永续总持仓、DEX 占比、资金费率区间、现货价差、稳定币锚定；?symbol=BTC 取单币行。oi_excluded_venues 中的交易所（WhiteBIT、BitMart）会列出，但不计入持仓合计与 DEX 占比。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/venues/markets | jq '.symbols[:3]'

谁先动：按场所配对与 UTC 日的一分钟收益互相关及领先不对称度。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/venues/lead-lag | jq '.pairs[] | {id, summary}'

按到期与价值状态的 IV 曲面、各到期的平值/25-delta 看跌看涨 IV、偏斜与蝶式、固定 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}'

Deribit、Bybit、Binance、OKX 与 Delta Exchange 的期权快照：持仓墙、做市商 gamma 暴露、零 gamma 价位、期限结构，以及 venues_included 中各交易所的占比。DVOL 为 Deribit 指数。

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}'

Deribit、Bybit、Binance、OKX 与 Delta Exchange 的每小时期权链，自 2026-09-30 起记录：每个到期日的未平仓合约（币数与美元）及其 1 小时与 24 小时变化、ATM IV 及其 24 小时变化与最大痛点；每个合约的未平仓合约及其变化、标记 IV 及其 24 小时变化，以及 Deribit 以币计的标记价、买价与卖价；另附某一到期日最近 24 小时的每小时 ATM IV 路径。变化只计入两个小时都有数据的交易所。任何密钥可获取未平仓合约最大的 40 个合约；strikes=all 返回全部合约，需会员深度（Terminal 会话或 Builder 及以上密钥）。

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]}'

每 15 分钟记录的 Deribit 与 OKX 期权成交带：权利金、行权价、看跌/看涨比、大宗交易、每笔成交的交易所；另含 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}'

美国现货 BTC、ETH、SOL 与 XRP ETF 资金流：当日暂计合计与各基金表、最近 30 个已结算交易日，以及 IBIT 发行商核对（BlackRock 流通份额 × 净值与成交带对照）。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/etf | jq '{btc: .assets.BTC.latest_finalized, issuer: .issuer_check}'

由主动方向分钟 K 线计算的主要永续合约订单流毒性（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}'

Coinbase 相对 Binance 的溢价与现货套利基差，每日历史回溯至 2017 年；泡菜溢价（Upbit、Bithumb、Coinone）与土耳其溢价（BtcTurk）自 2026-08-21 起。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/premium | jq '.assets.BTC | {date, premium_pct, avg7_pct}'

CFTC 比特币期货持仓报告，每周，回填至 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}'

FOMC 声明（顶层字段）以及 CPI 与就业报告发布（cpi、nfp）后测得的 5、30、60 分钟 BTC 反应，各含下一次预定日期，另在 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}'

来自真实订单簿的实时成交滑点阶梯，按下单规模，每小时记录。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/slippage | jq '.ladders[:3]'

巨鲸成交带：来自自有连接的 100 万美元以上主动成交，附 24 小时汇总与买入占比。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/whales | jq '.window_24h'

基于 2012 年以来自有收盘记录每晚重算的比特币周期指标：Pi Cycle 顶部（含交叉日期）、Mayer 倍数、200 周与 2 年均线、黄金比例倍数、盈利天数、存量流量比、来自自有节点的 Puell 倍数、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'

RSI 热力图：成交量前 400 的 Binance USDT 加密永续与全部 TradFi 永续在八个周期（15m 至 1M）上的 Wilder RSI(14)，附每个周期的超买与超卖数量。支持 ?symbol=、?kind=crypto|tradfi 与 ?sort=<周期>。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/rsi?sort=4h' | jq '.summary, .rows[:5]'

多交易所持仓量历史：我们登记的每家交易所在每小时最完整的 10 分钟快照的永续持仓量合计（不含 WhiteBIT 与 BitMart）、DEX 份额（链上交易所见 dex_venues 字段）以及当前持仓加权资金费率。?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]'

实时派生的覆盖登记：各交易所强平数据源及类型（完整、抽样、延迟、影子、无）、起始日期、24 小时事件数与最新记录；各交易所与市场的 10 分钟快照数据源、交易对数量与最新快照；资金费率套利腿、持仓倾向来源、巨鲸成交流、现货分钟数据与 Hyperliquid 巨鲸扫描的新鲜度。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/coverage | jq '.totals, .liquidations[:3]'

SuperChart 背后的记录时间序列，所有指标共用一种格式。参数：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:]'

BTC、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% 区间分箱（美元名义，买卖数组）、最大挂单墙及交易所拆分、各交易所 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'

成交量前 30 的 Binance USDT 永续的持仓倾向看板：Binance、Bybit、OKX、Gate、HTX、Bitget 与 Kraken Futures 各自公布的多空账户比、持仓比与主动成交流，另含 Bitfinex 现货保证金账本上的多空保证金持仓规模（保证金借款人，而非永续账户）、GMX 与 Jupiter Perps 以美元计的多空未平仓量（资金池型永续 DEX：按方向拆分，而非账户比），以及 BTC、ETH、SOL 的 CVD 序列（24 小时 5 分钟粒度，7 天 1 小时粒度）。每小时历史见付费接口 /api/x402/positioning-history。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/positioning?symbol=BTCUSDT' | jq '.rows[0]'

交易台笔记，最新在前：交易台撰写器（一个 AI 模型）依据 ByKaranteli 自有记录的衍生品数据撰写并在发布前与数据核对的简短带日期观察，每条带有 UTC 发布时间、卡片数据时间、交易台的 0 到 10 新闻价值、所依据的面板、提及的币种和永久链接。默认最近 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}'

土耳其溢价看板：由土耳其现货交易所每分钟构建的五个 TRY 与 USDT 参考价（合格订单簿中间价的中位数）、各交易所的订单簿状态、点差与深度，以及以基点计的溢价（TRY 交易对经 USDT/TRY 对比 Binance 全球价；USDT/TRY 对比 ECB 定盘价）。?pair=BTC-TRY&days=1..30 增加 15 分钟历史；免费日 CSV 在 /api/v1/public/datasets/turkey-premium-daily.csv；分钟数据在 /api/x402/turkey-premium-history。index 区块为土耳其溢价指数：BTC-TRY 相对 ECB USD/TRY 定价的总溢价（bps）及其美元腿与加密腿、0 到 100 评分（50 为全球价格）、状态、24 小时与 7 天均值及同号连续天数；每个交易对带 index_bps，每家交易所带 implied_index_bps。index.reference_state 表示本分钟的 USD/TRY 参考是否为实时：fresh（盘中报价不超过 30 分钟且外汇市场开市）、carried（外汇市场在 UTC 周五 22:00 至周日 22:00 休市，或实时来源中断不足 24 个交易小时；沿用最后一笔报价）或 stale（超过 24 个交易小时）；非 fresh 时 score 与 regime 为 null，并附 score_paused_reason，日数据行带 minutes_fresh、minutes_carried、minutes_stale 与 index_live_close（当日最后一个 fresh 分钟相对实时报价的指数）；日 CSV 在末尾追加 minutes_fresh 与 index_live_close 两列。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/turkey-premium?pair=BTC-TRY&days=1' | jq '{index: (.index | {value_bps, score, regime, dollar_leg_bps, crypto_leg_bps}), btc_try: (.pairs["BTC-TRY"] | {price, status, eligible})}'

BYK Data Layer 的证明 API（测试版）：我们每五分钟把自己推导的数据（合成资金费率、聚合未平仓合约、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（Upbit 泡菜溢价行）、/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}'

Jupiter 永续（Solana）看板：来自链上托管账户状态的各市场（SOL、ETH、BTC）精确多空持仓、池利用率与每小时借贷利率、JLP AUM 与 APR、24 小时成交量、本周按已实现盈亏排名的顶级交易者。?base=SOL&days=7 附加每小时持仓历史（最多 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]'

Solana 永续看板：我们读取的所有 Solana 永续合约场所（Jupiter、Pacifica、Phoenix、GM Trade、Velocity、Bullet），每 10 分钟刷新。venues 给出各场所的单边未平仓合约（oi_usd，资金池场所另有 oi_long_usd 与 oi_short_usd）、24 小时成交量、市场数量、每小时费率中位数及 rate_kind（Jupiter 为 borrow_hourly，即资金池每小时借贷费；其他场所为 funding_hourly）与 as_of，数据源失败而显示最近一次有效读数时带 stale: true；totals 为合计；markets 按未平仓合约从大到小列出所有场所的所有市场（instrument_type、标记价格、24 小时涨跌、以 USD 计的未平仓合约及场所公布的两侧、24 小时成交量、以仓位百分比计的每小时费率；场所未公布的数值为 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]'

Hyperliquid 巨鲸追踪：按权益前 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]'

单个币种的 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。

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]}'

TradFi 永续看板：Binance 全部股票、指数与大宗商品永续的资金费率、基差、持仓量、24 小时成交量与强平、其他交易所上市情况以及交易时段状态。支持 ?market= 与 ?symbol= 筛选。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/tradfi?market=EQUITY' | jq '.rows[:5]'

24 小时记录到的强平：按方向、交易对与交易所拆分，每家交易所的覆盖类型，以及附带输入参数的覆盖调整市场估算。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/liquidations | jq '{recorded, market_estimate, by_exchange}'

已计入交易所最近 24 小时、7 天或 30 天的最大单笔强平（排名、交易对、交易所、方向、价格、数量、名义金额、时间），以及 30 天时段热力图：星期乘 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}'

代币化股票：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}]}]}'

Binance、Bybit、OKX、Gate、MEXC、Bitfinex、Crypto.com、Delta Exchange、dYdX 与 Paradex 的交易所保险基金：各交易所最新的每小时读数（美元总额、各资产、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}]}'

自动检测的强平连环事件：规模、方向、币种与价格路径。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/incidents | jq '.incidents[0]'

10 个主要永续合约的持仓量榜（5 分钟精度）：每个币种的美元持仓量、持仓量与价格的 24 小时变化，以及状态判读（longs_building、shorts_building、deleverage_down、deleverage_up、quiet）；last_bar_utc 为最新 K 线时间。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/oi | jq '.symbols[:5]'

主要永续合约日收益的 30 天滚动皮尔逊相关矩阵。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/correlations | jq '.symbols'

PsiCharge 流动性状态模型：分数、状态与公开的逐年记分卡。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/charge | jq '{score, state}'

由自有节点每日测量的量子暴露比特币供应，附溯源哈希。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/quantum | jq '.latest | {exposed_btc, base_height}'

经 FRED 获取的官方宏观序列：政策利率、通胀与就业、央行资产负债表、美债曲线与美联储广义美元指数，另含我们的全球流动性综合指标（公式见 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]}'

自有节点的比特币网络健康：算力、难度、手续费、内存池；?days=365。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/network | jq '.latest'

六家交易所新上线与下架的永续合约，每小时扫描；?days=30。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/listings | jq '.listed[:5]'

任意记录指标的区间条件背景：今天处于何处、之后发生了什么；?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}'

基于记录持仓的单币种聪明钱解读。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/smart-money/BTCUSDT | jq '.'

43 个数据集，支持 CSV 或 JSON：市场历史、交易对面板、上市事件、强平、ETF 资金流（总量 + 按基金）、COT、溢价、DVOL、期权链与大单流、指标、量子、主题指数、交易所行情、鲸鱼成交、稳定币锚定、基差、滑点。完整目录见 /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

调用密钥所属账户相对其套餐的用量，与 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}'

一个响应包含所有市场指数：散户狂热指数（自有）+ 恐惧与贪婪指数（alternative.me）+ CoinGecko 全球数据 + DeFiLlama 稳定币流量。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/indices | jq '.euphoria.score, .fearGreed.today.valueRaw'

散户狂热指数（独立）。由恐惧与贪婪指数 + 热门 meme 币 + 比特币市值占比 + 前 30 名群体持仓构成。

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/euphoria | jq '{score, regime, explainer}'

可嵌入的 HTML 组件，显示某个交易对当前的压力评分。用于 iframe。深色主题，无追踪。

<iframe src="https://bykaranteli.com/embed/pressure/BTCUSDT" width="340" height="200" style="border:0"></iframe>

可嵌入的 24 小时强平组件：多空总额、事件数、头部交易对、最大单笔。组件库与条款见 /widgets。

<iframe src="https://bykaranteli.com/embed/liquidations" width="100%" height="300" style="border:0"></iframe>

可嵌入的现货订单簿深度组件，覆盖十个跟踪币种之一：2% 深度、失衡度、墙、镜像分箱条。

<iframe src="https://bykaranteli.com/embed/orderbook/BTC" width="100%" height="380" style="border:0"></iframe>

可嵌入的单个永续多空比组件（Binance、Bybit、OKX 比率与主动买卖）。

<iframe src="https://bykaranteli.com/embed/positioning/BTC" width="100%" height="200" style="border:0"></iframe>

可嵌入的 Hyperliquid 巨鲸组件：前 1000 大账户各币种的多头与空头名义额。

<iframe src="https://bykaranteli.com/embed/whales" width="100%" height="330" style="border:0"></iframe>

可嵌入的 RSI(14) 广度组件：各周期超买/超卖数量，以及 ?interval 上的极值。

<iframe src="https://bykaranteli.com/embed/rsi?interval=4h" width="100%" height="340" style="border:0"></iframe>

<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>

• 速率限制为 Free API 方案下每把密钥每分钟 30 个请求（Terminal 为 60，Builder、Business、Scale 分别为 300、1,200、3,000），另外 Free 密钥每个自然月有 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 目录调用在此按 10 次请求计算，同时计入方案的目录上限（Builder 每月 1,000 次，Business 10,000 次，Scale 及以上不设上限）。网站上的浏览器按 IP 限制。超出后返回 429 并带 retry-after。
• 数据为只读。不暴露任何个人身份信息（PII）或交易操作。
• 署名：嵌入时，若能保留一个指向 bykaranteli.com 或来源页面（例如 /symbols）的可见链接，我们将不胜感激。
• 个人与研究用途免费，须注明来源。对我们计算得出的数据进行商业使用需要 Business 方案；派生数据再分发需要 Scale；在所有方案中，原始记录及其他第三方数据均仅供你自用。把我们的数据冒充成你自己的内部回测在任何情况下都不允许。
• 抓取内部路由（/dashboard/*, /api/admin/*, /api/member/*）会被拦截并受到监控。请仅使用 /api/public/*。