开发者参考

bykaranteli-mcp 是一个官方 MCP（模型上下文协议）服务器，将本 API 以 34 个工具的形式暴露给 Claude、Cursor 以及任何其他支持 MCP 的助手：市场指数、资金费率热力图、资金费率套利、压力评分、涨跌幅榜、近期信号、按交易对的表现、策略排行榜、每日强平数据、美国现货 ETF 资金流、CFTC COT 持仓、期权快照、Coinbase 溢价、订单流毒性、期权大单流、滑点阶梯、FOMC 影响、强平级联、持仓量，以及稳定币充能状态。免费，无需 API 密钥，Node 18+。

claude mcp add bykaranteli -- 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 密钥或订阅即可购买单次结果。每次请求在链上结算，双方都无需注册。

# 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

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

跨 30 / 90 / 180 天窗口的实盘表现聚合快照：净盈亏、PF、Sharpe、DD、多空分解、每日净值曲线。

curl -s https://bykaranteli.com/api/public/performance | jq '.windows."90d"'

{
  "generatedAt": "2026-04-21T06:47:00.000Z",
  "firstSignalAt": "2026-03-21T07:41:27.285Z",
  "lastSignalAt": "2026-04-21T06:45:12.507Z",
  "totalTrades": 104397,
  "windows": {
    "30d": {
      "trades": 90876, "wins": 45470, "losses": 45406, "ties": 0,
      "winRatePct": 50.04,
      "profitFactorGross": 1.5406, "profitFactorNet": 1.339,
      "avgNetBps": 35.94, "medianNetBps": 1.04,
      "avgWinBps": 283.70, "avgLossBps": -212.18,
      "sumNetBps": 3265831.81, "maxDrawdownBps": …,
      "sharpeAnnualized": …, "calmarAnnualized": …,
      "avgDurationMinutes": …
    },
    "90d": { … },
    "180d": { … }
  },
  "sideBreakdown": { "30d": { "LONG": {…}, "SHORT": {…} }, … },
  "equityCurve180d": [ { "day": "2026-03-21", "cumulativeNetBps": 35.94, "tradesToDate": 1 }, … ],
  "disclaimers": { "evalMode": "terminal", "feesIncluded": true, "slippageIncluded": true, "fundingIncluded": true, … }
}

按窗口计算的策略级排名，综合评分 = PF × √(trades/25) × winness。

curl -s 'https://bykaranteli.com/api/public/leaderboard?window=90' | jq '.strategies[:5]'

{
  "generatedAt": "2026-04-21T06:47:00.000Z",
  "windowDays": 90,
  "minTradesQualified": 25,
  "totalStrategies": 14,
  "qualifiedCount": 11,
  "strategies": [
    {
      "strategy": "breakout_v3",
      "trades": 812, "longTrades": 450, "shortTrades": 362,
      "wins": 430, "losses": 382,
      "winRatePct": 52.96,
      "profitFactorNet": 1.42,
      "avgNetBps": 28.1, "sumNetBps": 22817.2,
      "maxDrawdownBps": 14203.5,
      "sharpeAnnualized": 1.18,
      "lastTradeAt": "2026-04-21T06:30:18.201Z",
      "qualified": true,
      "compositeScore": 5.74
    },
    …
  ],
  "disclaimers": { … }
}

按交易对的表现排名（合格 + 低样本）。结构与 /strategies 相同，但以 signals.symbol 为键。

curl -s 'https://bykaranteli.com/api/public/symbols?window=90' | jq '.symbols[:5]'

{
  "generatedAt": "2026-04-21T06:47:00.000Z",
  "windowDays": 90,
  "minTradesQualified": 20,
  "totalSymbols": 48,
  "qualifiedCount": 36,
  "symbols": [
    {
      "symbol": "BTCUSDT",
      "trades": 3120, "longTrades": 1780, "shortTrades": 1340,
      "wins": 1610, "losses": 1480,
      "winRatePct": 52.1, "profitFactorNet": 1.28,
      "avgNetBps": 18.4, "sumNetBps": 57408.0,
      "bestTradeBps": 612.0, "worstTradeBps": -480.3,
      "maxDrawdownBps": 9821.4,
      "lastTradeAt": "2026-04-21T06:38:21.118Z",
      "qualified": true, "compositeScore": 4.82
    },
    …
  ]
}

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

curl -s '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 https://bykaranteli.com/api/public/pressure/BTCUSDT

6 家交易所（Binance、OKX、Bybit、Gate、HTX、BingX）上主要交易对的跨交易所资金费率价差，含扣除成本后的年化 APR。

curl -s https://bykaranteli.com/api/public/funding-arb | jq '.rows[:5]'

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

curl -s 'https://bykaranteli.com/api/liqmap/public?symbol=BTC' | jq '.real_levels.totals'

资金费率热力图快照：每个跟踪的 Binance USDT-M 永续合约的当前费率、下次结算时间和 24 小时历史分桶。

curl -s https://bykaranteli.com/api/public/heatmap | jq '.rows[:5]'

跟踪永续合约中 24 小时涨幅与跌幅榜，含价格、成交量和持仓量变化。

curl -s https://bykaranteli.com/api/public/top-movers | jq '.gainers[:5]'

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

curl -s https://bykaranteli.com/api/public/altseason | jq '.'

八个等权叙事指数（AI、RWA、DePIN、meme、L1、L2、DeFi、量子），固定篮子与自 2025-01-01 起的每日点位；加 ?points=0 仅取记分板。

curl -s https://bykaranteli.com/api/public/themes | jq '.'

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

curl -s https://bykaranteli.com/api/public/factors | jq '.'

43 家交易所 56 路行情源的场所层聚合：永续总持仓、DEX 占比、资金费率区间、现货价差、稳定币锚定；?symbol=BTC 取单币行。

curl -s https://bykaranteli.com/api/public/venues/markets | jq '.'

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

curl -s https://bykaranteli.com/api/public/venues/lead-lag | jq '.'

按到期与价值状态的 IV 曲面、各到期的平值/25-delta 看跌看涨 IV、偏斜与蝶式、固定 30 天历史；?currency=BTC|ETH。

curl -s https://bykaranteli.com/api/public/options/surface?currency=BTC | jq '.'

Deribit 期权快照：持仓墙、做市商 gamma 暴露、零 gamma 价位、DVOL、期限结构。

curl -s https://bykaranteli.com/api/public/options | jq '.'

每 15 分钟记录的 Deribit 与 OKX 期权成交带：权利金、行权价、看跌/看涨比、大宗交易、每笔成交的交易所。

curl -s https://bykaranteli.com/api/public/options-flow | jq '.'

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

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

由主动成交计算的订单流毒性（VPIN），120 天历史。

curl -s https://bykaranteli.com/api/public/flow | jq '.'

Coinbase 相对 Binance 的溢价与现货套利基差，每日历史回溯至 2017 年。

curl -s https://bykaranteli.com/api/public/premium | jq '.'

CFTC 比特币期货持仓报告，每周，回填至 2018 年。

curl -s https://bykaranteli.com/api/public/cot | jq '.'

FOMC 会议及测得的 5、30、60 分钟 BTC 反应（CPI 与就业报告在发布日历接入后加入）。

curl -s https://bykaranteli.com/api/public/events | jq '.'

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

curl -s https://bykaranteli.com/api/public/slippage | jq '.'

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

curl -s https://bykaranteli.com/api/public/whales | jq '.'

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

curl -s https://bykaranteli.com/api/public/incidents | jq '.'

持仓量排行：盘中持仓量增减榜。

curl -s https://bykaranteli.com/api/public/oi | jq '.'

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

curl -s https://bykaranteli.com/api/public/correlations | jq '.'

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

curl -s https://bykaranteli.com/api/public/charge | jq '.'

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

curl -s https://bykaranteli.com/api/public/quantum | jq '.'

宏观流动性序列：联邦基金利率、10 年期收益率、美联储资产负债表、逆回购与稳定币供应；?days=365。

curl -s https://bykaranteli.com/api/public/macro | jq '.'

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

curl -s https://bykaranteli.com/api/public/network | jq '.'

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

curl -s https://bykaranteli.com/api/public/listings | jq '.'

任意记录指标的区间条件背景：今天处于何处、之后发生了什么；?metric=coinbase_premium_pct。

curl -s https://bykaranteli.com/api/public/context | jq '.'

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

curl -s https://bykaranteli.com/api/public/smart-money/BTCUSDT | jq '.'

19 个 CC0 数据集，支持 CSV 或 JSON：市场历史、交易对面板、上市事件、强平、ETF 资金流（总量 + 按基金）、COT、溢价、DVOL、期权链与大单流、指标、量子、主题指数、交易所行情、鲸鱼成交、稳定币锚定、基差、滑点。完整目录见 /data。每日 CSV 镜像：github.com/bykarantelicom/crypto-datasets

curl -s https://bykaranteli.com/api/v1/public/datasets/daily-market.csv | head -5

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

curl -s https://bykaranteli.com/api/public/indices | jq '.euphoria.score, .fearGreed.today.valueRaw'

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

curl -s https://bykaranteli.com/api/public/euphoria | jq '{score, regime, explainer}'

可验证的信号回执：SHA-256 指纹 + 所有决策参数 + 结果。接受 UUID 或十六进制哈希前缀。

curl -s https://bykaranteli.com/api/public/signals/d3fbb0e3-4aef-4a8b-9fa6-2da02401f07e | jq '{hash, shortCode, symbol, side, outcome, netBps}'

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

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

在 H 小时窗口内最近的 N 个已平仓信号。适合行情条、活动信息流和通知。

curl -s 'https://bykaranteli.com/api/public/recent?hours=24&limit=20' | jq '.signals[:5]'

{
  "generatedAt": "2026-04-21T06:47:00.000Z",
  "hours": 24,
  "total24h": 1247, "wins24h": 648, "losses24h": 572, "timeouts24h": 27,
  "net24hBps": 34219.8,
  "signals": [
    {
      "symbol": "ETHUSDT", "side": "LONG", "outcome": "TP1",
      "netBps": 182.4,
      "evaluatedAt": "2026-04-21T06:44:10.009Z",
      "createdAt":   "2026-04-21T05:58:01.301Z"
    },
    …
  ]
}

<div id="bk-perf"></div>
<script>
  (async () => {
    const r = await fetch('https://bykaranteli.com/api/public/performance');
    const j = await r.json();
    const m = j.windows['90d'];
    const pct = (m.sumNetBps / 100).toFixed(2);
    document.getElementById('bk-perf').innerHTML =
      `<strong>ByKaranteli 90d:</strong> ${pct >= 0 ? '+' : ''}${pct}%
       · PF ${m.profitFactorNet?.toFixed(2)}
       · ${m.trades} trades
       · <a href="https://bykaranteli.com/performance">source</a>`;
  })();
  setInterval(() => location.reload(), 300000);
</script>

• 速率限制为 每个 IP 每分钟 20 个请求。请遵守，否则会被返回 429。
• 数据为只读。不暴露任何个人身份信息（PII）或交易操作。
• 署名：嵌入时，若能保留一个指向 bykaranteli.com 或来源页面（例如 /performance）的可见链接，我们将不胜感激。
• 允许商业使用。但把我们的数据冒充成你自己的内部回测则不允许。
• 抓取内部路由（/dashboard/*, /api/admin/*, /api/terminal/*）会被拦截并受到监控。请仅使用 /api/public/*。