公开更新

使用账户密钥时，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 本位永续合约的结算记录。此前其 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 起算，每次包含的调用仍按 10 次请求计入方案的每月公平使用。原始记录指单笔强平事件与最大成交排行、巨鲸成交、Hyperliquid 仓位事件与每小时仓位记录、订单簿快照、分钟 K 线以及各交易所市场快照。新增两种响应，均可按次付费：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 页面自身的数据读取接口。没有会员会话且不是来自浏览器的请求（没有 Fetch Metadata，例如 curl 或脚本）现在会收到与 /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"}；可打开全部数据流频道的方案均可打开它。频道表见 /zh/developers。

Builder 与 Business 密钥过去有每月包含调用次数的上限，超出后返回 402。该上限已取消：Builder 及以上密钥可在方案内调用 /api/x402 下的每个路由，每次成功的目录调用按 10 次请求计入方案的每月公平使用，与 x-quota 响应头和 /api/v1/usage 显示的数字一致。超出公平使用后，密钥降至 Free 速率，不会被停止。Free 与 Terminal 密钥、钱包和预付密钥仍按次付费。方案、API 文档。

/api/public/macro 提供全部宏观序列，含分组、合成指标的公式与输入，以及每个序列的标签、单位、频率、变换、来源与起始日期；latest 始终是每个序列的最新一行，与时间窗口无关。/api/public/events 在 FOMC 之外新增 cpi 与 nfp 板块：测得的反应、相对正常半小时的幅度、上涨占比与下一次预定发布，以及图表标记读取的带日期事件行。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 额度。速率与配额响应头以及错误表见 /zh/developers。

/zh/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 下的每个付费接口现在每次调用收取 0.10 美元 USDC（Solana 或 Base），此前为 0.002 到 0.01 美元。预付费密钥仍为 10 美元，现在可用于 100 次调用。目录、/openapi.json、.well-known/x402 文档与开发者文档从同一处读取价格，因此同步调整。

wss://bykaranteli.com/ws/v1，握手时使用同一把账户密钥。事件频道实时推送九家交易所的强平成交、100 万美元以上鲸鱼成交、Hyperliquid 鲸鱼仓位事件与你自己的告警触发，每条带可续传的 seq；快照频道仅在载荷变化时推送压力分、持仓量、资金费率与 LiqMap，结构与 REST 路由相同。仅限付费方案：Builder 获得 1 个连接与 3 个指定交易对的强平，Business 打开全部 9 个频道、5 个连接与 15 分钟回放，Scale 与 Enterprise 提升所有限制。协议、示例与错误码见 /zh/developers；连接、帧与时长用量见 /zh/dashboard/api。

/pricing 现在清楚说明售卖的是什么：面向个人的 Terminal（每月 29 美元，1 到 12 个月期限）与面向程序的 API 方案（免费密钥、Builder 49、Business 149、Scale 399 美元），并用一张表并排列出每项功能。免费与 Terminal 密钥每个自然月（UTC）有 15,000 次请求的配额：每个带密钥的响应通过 x-quota-limit、x-quota-used 与 x-quota-reset 报告配额状态，自 2026-10-01 起超出配额的密钥返回 429 直到月度重置；Builder 及以上没有月度上限。两项执行修正：发送浏览器请求头但在 User-Agent 中自报名称的程序按程序处理，需要密钥；对已登录账户而言，SuperChart 的 5 分钟 K 线与 5,000 根历史重新成为 Terminal 功能（免费账户看到公开深度）。托管 MCP 端点对无密钥客户端限制为每天 600 次工具调用，携带密钥即可解除。/dashboard/api 显示本月调用量与配额。

公开 JSON API 现在向程序要求账户密钥：任何已验证账户都可获得免费密钥（/dashboard/api，每分钟 30 次），自 2026-09-10 起脚本、机器人与代理必须携带；网站页面无需密钥仍可正常使用。/pricing 新增面向代码的方案：Builder 每月 $49、Business $149、Scale $399，购买速率、API 上的会员深度（LiqMap 7 个周期、5 分钟序列），Business 起包含商业许可与批量导出；每个付费 API 方案都包含 Terminal 会员，今日有效的会员在其付费期内保留 Builder 权限。本站提供的数据集改为 ByKaranteli 数据许可（个人与研究用途，须注明来源，见 /data）；此前发布在 GitHub、Kaggle、Hugging Face 与 Zenodo 镜像上的文件保持 CC0 并停止更新。MCP 包 0.26.0 读取 BYKARANTELI_API_KEY。

基于规则的信号引擎及其回执、策略页面与业绩 API 已移除。原有的中心页面重定向到它们所依赖的数据（/data、/symbols、/methodology），单条回执 URL 返回 410 Gone。交易对页面现在展示记录的价格、资金费率、持仓量与衍生品压力评分；MCP 服务器提供 45 个数据工具。采集网络本身没有任何变化。

13 个数据集路由已列入 Coinbase Bazaar 目录并接入 CDP 实时结算。AI 代理可用 USDC 按次付费；免费快照保持免费。详见 /developers。