bykaranteli

bykaranteli-mcp

用于获取实时加密货币衍生品数据的 MCP（Model Context Protocol）服务：资金费率、跨交易所资金费率套利、未平仓合约压力、强平、期权、ETF 资金流、恐惧与贪婪指数以及 BTC 主导率。

通过 bykaranteli.com 的公共 JSON API 提供 68 个只读工具和账户工具：市场数据工具仅用于读取；提醒和观察列表工具则通过你的密钥操作你自己的账户（账户工具）。自 2026-09-10 起，API 要求程序提供账户密钥：任何已验证账户都可获得免费密钥，访问 https://bykaranteli.com/dashboard/api 即可获取（每分钟 30 次请求，每月 15,000 次请求，可访问公共深度）；Builder、Business 和 Scale 计划可提高速率和每月合理使用额度，并解锁会员深度（七种时间范围的 LiqMap、5 分钟序列），同时可在各计划的历史记录窗口内使用每月一定额度的 x402 目录调用（计划与付费深度）。将其设为 BYKARANTELI_API_KEY。数据涵盖 Binance USDT-M 永续合约；资金费率套利、强平、订单簿深度、期权、持仓和保险基金数据还涵盖 bykaranteli.com/coverage 上各个看板列出的其他交易场所。

托管端点（无需安装）

在任何支持 MCP 的助手中，将 https://mcp.bykaranteli.com 作为自定义连接器粘贴进去。工具完全相同，无需安装。每次工具调用都需要你的账户密钥（可在 https://bykaranteli.com/dashboard/api 免费获取）；连接和列出工具无需密钥。密钥可通过以下三种方式之一传递：

• 请求头 x-api-key: bk_...（claude.ai 自定义连接器、Cursor、 Claude Code）；
• 请求头 Authorization: Bearer bk_...；
• 地址 https://mcp.bykaranteli.com/?key=bk_...，适用于无法发送请求头的客户端（ChatGPT）。请像保护密码一样保护该地址；如果泄露，请撤销密钥。

也可在客户端支持时使用 OAuth 2.1 登录（claude.ai 自定义连接器：Authentication、Sign in；ChatGPT 连接器：OAuth）：客户端通过客户端元数据文档（一个由授权服务器读取的 https 客户端 ID，这是 2026-07-28 MCP 修订版优先采用的方式）标识自身，或自行注册（RFC 7591），并始终使用 PKCE S256；你在 bykaranteli.com 上批准一次后，客户端便会使用你自己账户的密钥运行，连接的应用会列在 Data and API 页面中。发现地址： https://mcp.bykaranteli.com/.well-known/oauth-protected-resource。

免费账户可通过同一个月度计数器使用 API 和托管 MCP； Builder 及更高等级可享受更高的速率和会员深度。

新手分步指南：https://bykaranteli.com/guide/connect

快速开始

Claude Code

claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_... -- npx -y bykaranteli-mcp

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "bykaranteli": {
      "command": "npx",
      "args": ["-y", "bykaranteli-mcp"],
      "env": { "BYKARANTELI_API_KEY": "bk_..." }
    }
  }
}

Cursor / 其他 MCP 客户端

任何 stdio MCP 客户端均可使用：命令 npx、参数 ["-y", "bykaranteli-mcp"]、环境变量 BYKARANTELI_API_KEY。

需要 Node.js 20 或更高版本（1.0.0；0.x 版本使用 Node.js 18）。该服务同时支持 2026-07-28 修订版协议和 2025 年时期的 initialize 握手，因此迄今发布的所有 MCP 客户端都可以直接连接。

工具

工具	可回答的问题
get_market_indices	“今天的恐惧与贪婪指数是多少？”，“现在 BTC 的主导率是多少？”
get_funding_heatmap	“现在的资金费率是多少？”，“SOL 的资金费率是多少？”
get_funding_arbitrage	“有资金费率套利机会吗？”，“做多 / 做空 BTC 获取套息，哪个平台最好？”
get_pressure_scores	“现在有哪些币种杠杆过高 / 交易拥挤？”
get_top_movers	“今天未平仓合约量（OI）飙升最多的是哪些？”，“现在资金费率最极端的是哪些？”
get_liquidations	“今天有多少仓位被清算？”，“这周是多头还是空头遭到清算？”
get_liquidation_leaderboard	“今天最大的一笔清算是多少？”，“清算集中在什么时候，亚洲时段还是美国时段？”
get_insurance_funds	“Binance 的保险基金有多大？”，“这周有交易所的保险基金缩水了吗？”
get_tokenized_stocks	“链上有多少代币化 Tesla？”，“哪种代币化股票的交易价与真实股票价格偏差最大？”，“这个封装代币的供应量是按哪个价格估值的？”（price_source、totals.priced_by）
get_etf_flows	“昨天比特币 ETF 是买入还是卖出？”，“ETH ETF 累计流入是多少？”，“XRP ETF 本周资金流向如何？”
get_cot_positioning	“对冲基金看多还是看空比特币？”，“COT 报告显示了什么？”
get_options_snapshot	“BTC 期权墙在哪里？”，“DVOL / 零伽马水平是多少？”
get_coinbase_premium	“美国投资者在买入比特币吗？”，“基差交易的收益是多少？”
get_flow_toxicity	“有毒订单流正在增加吗？”，“现在 BTC 的 VPIN 是多少？”
get_options_flow	“大型期权交易者在买什么？”，“今天有大宗交易吗？”
get_slippage	“价值 100 万美元的市价单会产生多少滑点？”，“哪个订单簿最薄？”
get_fomc_impact	“美联储会议日 BTC 通常有什么表现？”，“下一次 FOMC 会议是什么时候？”
get_liquidation_cascades	“是什么引发了那次暴跌清算？”，“这周有哪些人被清算？”
get_open_interest	“市场杠杆是在增加吗？”，“XRP 的空头仓位在增加吗？”
get_psi_charge	“市场处于哪种流动性状态？”，“闲置资金正在入场吗？”
get_theme_indices	“哪个加密叙事领跑：AI、RWA、DePIN、迷因币、L2、DeFi？”
get_factor_board	“今天哪些指标处于异常区间？历史上随后发生了什么？”
get_venue_markets	“各交易所的 BTC 未平仓合约总量是多少？”，“永续合约 OI 中 DEX 占比是多少？”，“哪里有 USDT 脱锚？”
get_leverage_tiers	“Bybit 的 SOL 最高允许多少倍杠杆？”，“哪家交易所 DOGE 的最高杠杆倍数最大？”，“这周有平台下调某个币种的杠杆吗？”
get_withdrawal_status	“KuCoin 暂停 USDT 提现了吗？”，“从 Gate 提现 USDT 哪条网络最便宜？”，“现在有哪些交易所暂停了提现？”
get_venue_profile	“你记录了哪些关于 Bybit 的信息？”，“OKX 上架了多少种合约？”，“HTX 运行正常吗？这周那里发生了什么？”
get_settlements	“这周有哪些合约到期？”，“OKX 上下一份 BTC 季度合约什么时候到期？”，“9 月合约按什么价格结算？”
get_borrow_rates	“在 Binance 借入 USDT 的成本是多少？”，“借入 ETH 哪个平台最便宜？”，“稳定币借款利率在飙升吗？”
get_fee_table	“Bitget 的永续合约手续费是多少？”，“哪家交易所的吃单手续费最低？”，“这周有平台调整手续费吗？”
get_lead_lag	“Coinbase 和 Binance 哪家先动？”
get_iv_surface	“BTC 各到期日的隐含波动率是多少？”，“下行保护（偏斜）成本高吗？”
get_whale_tape	“鲸鱼现在是在买入还是卖出？”
get_correlations	“SOL 与 BTC 过去 30 天的相关性有多高？”
get_new_listings	“这周上架了哪些永续合约？最先在哪个平台上架？”
get_macro_liquidity	“美联储资产负债表 / RRP / 稳定币供应量有什么变化？”
get_network_health	“现在比特币的算力、难度、手续费和内存池情况如何？”
get_tradfi_board	“TSLA 永续合约的资金费率是多少？哪些交易所上架了 NVDA 永续合约？股市交易时段开盘了吗？”
get_rsi_heatmap	“哪些币种在日线上处于超卖状态？BTC 在 4 小时和 1 周周期上的 RSI 是多少？”
get_hl_whales	“Hyperliquid 鲸鱼的 BTC 净多仓是多少？最大的账户刚刚有哪些仓位反转？”
get_positioning	“Binance 上 BTC 的多空比是多少？顶级交易者的 ETH 净仓位是做空吗？今天的 CVD 是多少？”
get_coverage	“哪些交易所的数据计入了你的清算总量？数据有多新？”
get_orderbook_depth	“BTC 最大的买单墙在哪里？Coinbase 和 Binance 上 ETH 价格上下 2% 范围内的深度各是多少？”
get_jupiter_perps	“Jupiter 的 SOL 永续合约中，多头与空头 OI 各是多少？本周 Jupiter 上谁的表现最佳？JLP APR 是多少？”
get_solana_perps	“哪个 Solana 永续合约 DEX 的未平仓合约量最大？Pacifica 的 BTC 资金费率和 24 小时成交量是多少？Phoenix 的 SOL 未平仓合约量是多少？GM Trade 与 Jupiter 相比如何？”
get_desk_notes	“交易台今天在衍生品数据中观察到了什么？10 月 14 日发生了什么？给我一句带日期、可引用且包含数值和时间的话。”
get_turkey_premium	“里拉买家购买比特币时比全球价格高出多少？土耳其溢价指数及其当前评分是多少？哪家土耳其交易所价格最高？USDT/TRY 相对官方汇率是多少？”
get_data_proof	“我能否验证 ByKaranteli 的数据之后没有被更改？展示现在 BTC 资金费率的链上证明。哪笔 Solana 交易封存了最新 epoch？”
get_cycle_indicators	“Pi Cycle 是否交叉了？今天的 Mayer Multiple 和 Puell 指标是多少？”
get_altseason	“现在是山寨币季吗？”，“山寨币季指数是多少？”
get_metric_context	“今天的资金费率在历史上算极端吗？”，“这个读数在其分布中的位置如何？”
get_quantum_exposure	“有多少比特币容易受到量子计算攻击？”，“P2PK 的风险敞口是多少？”
get_liqmap	“BTC 的清算集群在哪里？”，“杠杆多头会在哪些位置被清算？”
get_market_profile	“今天 BTC 的控制点在哪里？”，“昨天的价值区间是什么？”，“哪些裸 POC 仍未被测试？”
get_options_chain	“今天 BTC 的未平仓合约量按行权价如何变化？”，“ETH 平值隐含波动率每小时是多少？”，“过去 24 小时哪个到期日的未平仓合约量增长最多？”
get_hl_positions	“Hyperliquid 鲸鱼的 BTC 仓位会在哪些位置被清算？”，“价格下方有多少跟踪名义仓位？”，“模型是否认同这些跟踪仓位？”
get_venue_share	“这周哪家交易所的清算量最大？”，“永续合约未平仓合约量在各平台间如何分布？”
get_tradfi_gaps	“周末 TSLA 永续合约表现如何？”，“NVDA 周一开盘跳空有多大？”，“隔夜各平台的价格差距有多大？”
get_series	“过去一周 BTC 每小时的未平仓合约量是多少？”，“自 9 月 1 日以来 OKX 上 ETH 的资金费率是多少？”，“本月每日 Coinbase 溢价是多少？”（指标列表、单位和最细周期：https://bykaranteli.com/api/series/metrics）
所有市场答案均为 JSON，并包含 generatedAt 时间戳、指向人类可读页面的 source URL，以及一个 provenance 块：source_page、api_path、答案自身的 generated_at、fetched_at，以及答案包含时才会提供的数字背后的 venues、coverage（full、sampled 或 mixed）、stale_venues 和 recorded_since，还有 proof 页面（https://bykaranteli.com/proof）。答案未包含的字段会直接省略，绝不会填入。符号既接受 BTCUSDT，也接受简写 BTC。

答案按模型的上下文容量调整大小：不带参数的调用会返回较短的第一页（例如 30 行，或序列中最新的数据点），绝不会返回整张看板。每个缩短的列表都会在 trimmed 中列出 field、returned、total 和 more，以及用于返回其余内容的参数（如 symbol、coin、asset、limit、days、detail 等）；经过筛选的调用则会保留完整详情。单个答案最多为 100,000 个字符；超过上限时，工具会说明如何缩小调用范围。

十三个大型工具（get_liqmap、get_turkey_premium、get_correlations、get_hl_whales、get_options_flow、get_funding_arbitrage、get_desk_notes、get_positioning、get_coverage、get_new_listings、get_venue_markets、get_tokenized_stocks、get_factor_board）也接受 detail："compact" 返回比默认值更短的页面（行数更少、数字四舍五入到六位有效数字、长篇自由文本会被截断、网格会被省略；所有删减内容都会在 trimmed 中列出），"full" 则返回整个路由的答案。get_liqmap 和 get_coverage 保留其布尔形式，其中 true 表示完整内容。自 1.1.0 起提供。

账户工具（提醒和关注列表）

这些工具使用同一个密钥读取和更改你自己的 ByKaranteli 账户，包括通过 Telegram、电子邮件、推送通知或 webhook 通知你的提醒规则，以及你的关注列表。它们绝不会进行交易、转移资金或操作其他账户。

工具	功能
parse_alert_text	将“BTC funding above 0.05%”或“tell me when ETH drops 5% in a day”转换为精确的规则，并给出置信度以及文本中未明确的内容。基于规则；不会保存任何内容，也绝不会凭空编造阈值。
list_alert_recipes	列出你的提醒规则及其条件、范围、渠道和最近触发时间。
create_alert_recipe	保存提醒规则（写入你的账户）。
delete_alert_recipe	按 id 删除一条提醒规则（写入你的账户）。
list_watchlists	列出你的关注列表及其中的交易品种。
add_watchlist_symbol	将交易品种添加到默认列表或你指定的列表（写入你的账户）。
remove_watchlist_symbol	从列表中移除交易品种（写入你的账户）。
list_tracked_addresses	列出你关注的 Hyperliquid 地址及其最近的仓位（读取你的账户）。
add_tracked_address	关注一个 Hyperliquid 地址，以接收仓位提醒（写入你的账户；适用于 Terminal 及更高版本）。
remove_tracked_address	停止关注某个地址（写入你的账户）。

• 写入工具的 readOnlyHint: false（对于会删除内容的两个工具，还会设置 destructiveHint: true），因此会在更改前征求确认的客户端会提示你确认。
• 账户可保存的规则数量取决于套餐；超过上限后，create_alert_recipe 会返回限制信息，而不会保存规则。
• 每次调用都会像其他请求一样计入密钥套餐；写入操作还会受到每个密钥的速率限制，并会在账户中记录执行写入操作的密钥。
• 规则和关注列表的更改会立即显示在 https://bykaranteli.com/dashboard/alerts 和 https://bykaranteli.com/dashboard/watchlist。
• 如果工具调用返回 401，响应正文中的 error_description 会说明应如何处理，x-byk-mcp-auth 标头会指出原因：key_required（完全没有凭据）、key_unusable（标头或地址未携带可用密钥：使用了 bk_... 占位符、变量未设置、使用了非 Bearer 方案，或 OAuth 令牌格式不符）、key_wrong_type（预付费 bk_live_ 密钥，该密钥按次支付 /api/x402/* 请求费用，不能用于访问 MCP）或 key_unrecognised（密钥输入错误、已过期或已撤销）。支持 OAuth 的客户端会通过 WWW-Authenticate 挑战启动 OAuth 登录。此程序会原样转发 REST 响应正文，因此相同的提示也会通过 stdio 传给模型。

配置

环境变量	默认值	用途
BYKARANTELI_API_KEY	none	账户密钥（bk_...），通过 Authorization: Bearer 发送。可在 https://bykaranteli.com/dashboard/api 免费获取；自 2026-09-10 起，程序必须提供此密钥
BYKARANTELI_BASE_URL	https://bykaranteli.com	覆盖 API 主机（仅用于测试）。密钥会发送到此处指定的任何主机，因此只能将其指向你信任的服务器。

数据说明

• 信号引擎已于 2026 年 9 月停用；此服务仅发布记录的市场数据，不提供交易信号或业绩声明。
• 资金费率、OI 和压力数据每 15 到 30 分钟刷新一次；指数每 30 分钟刷新一次。
• 本服务内容不构成财务建议。请参阅 bykaranteli.com/risk-guide。

开发

npm install
npm run build
node dist/index.js   # speaks MCP over stdio

各版本的发布说明：CHANGELOG.md。

许可证

服务端：MIT。数据：可用于个人和研究用途，但须注明出处“ByKaranteli (bykaranteli.com)”；商业用途需使用 Business 套餐。许可证文本：https://bykaranteli.com/data#license。

方案与付费数据深度

方案	速率	月度额度	数据深度
免费 API	30 / 分钟	15,000	公开页面
Terminal	60 / 分钟	150,000	公开页面
Builder	300 / 分钟	1,000,000 合理使用额度	会员数据深度，x402 目录：每月包含 1,000 次调用，可查询最近 90 天的数据，每次最多 5,000 行；仅提供汇总序列，原始记录路由按次付费
Business	1,200 / 分钟	3,000,000 合理使用额度	会员数据深度，商业许可，x402 目录：每月包含 10,000 次调用，可查询最近 365 天的数据并获取原始记录；同一时间范围内的每月批量导出
Scale	3,000 / 分钟	10,000,000 合理使用额度	会员数据深度，可再分发衍生数据；x402 目录覆盖完整档案，包含原始记录且无月度上限；可导出完整档案的每月批量导出

价格：https://bykaranteli.com/pricing

Free 或 Terminal 密钥超过月度额度后，将收到 429 响应，直至次月重置。付费密钥超过合理使用额度后不会被停用：直至次月重置，速率会降至 Free 方案的水平（每分钟 30 次），并且每次响应都会带有 x-quota-state: slow。

完整表格：https://bykaranteli.com/developers#tiers。如需获取超出实时快照范围的历史记录和原始记录，bykaranteli.com 还为匿名 Agent 提供按次付费的 x402 端点（使用 Solana 或 Base 上的 USDC，按次计费，无需账户）：https://bykaranteli.com/developers#x402 · 机器可读目录：https://bykaranteli.com/api/x402。Builder、Business 和 Scale 密钥可在方案的目录额度内免费调用这些路由（见上表）；每次包含的调用也计为月度合理使用额度中的 10 次请求。若方案不包含某次调用，响应会返回 x402_allowance_used、history_window 或 raw_tier_required；若方案不包含某条路由，响应会返回 tier_required（批量导出需 Business 或更高方案）：当账户密钥保留在 Authorization: Bearer 中时，使用预付费密钥填入 x-api-key 进行支付；也可以不使用账户密钥，直接通过钱包支付。