加密货币资金费率、价格与动态，以 JSON 提供。无需密钥与注册

能取到什么

这是一个只读的 JSON API，提供 Binance、Bybit、OKX、Hyperliquid 等 49 家交易所的加密货币永续合约资金费率与价格，覆盖 BTC、ETH、SOL 及所有上市合约。可用于监控或回测资金费率套利，或作为机器人的数据源。数值约每分钟一次从各交易所自有的公开 API 读取，原样返回。无需密钥，无需注册。

资金费率本身的说明见数值的读法。

curl -s https://www.carryroom.com/api/v1/latest

这一行即可返回所有交易所、所有合约的最新值。

接口

/api/v1/history（历史费率）将在下一版本提供。在此之前它返回 501 以及可用的 URL，不会返回空列表。

数据种类

机器可读版本是 /openapi.json（OpenAPI 3.1，含每个字段的类型、是否必有及单位）；全站目录是 /llms.txt。

筛选

取回一次列表后在本地筛选。查看某一家交易所各合约的费率与结算周期：

curl -s https://www.carryroom.com/api/v1/latest \
  | jq '[.rows[] | select(.venue == "hyperliquid")
         | {symbol, funding_rate_8h, funding_interval_h}]'

• symbol 是各交易所自己的写法（1000BONK 与 BONK 是同一资产）；跨交易所连接请用 canonical。
• 不带参数时返回与页面相同的范围；默认隐去的交易所在点名（如 ?venues=dydx,btcc）后会包含进来。
• 费率接口唯一的参数是 venues。无法识别的名称会写入 unreadable_venue_tokens，且筛选不生效，因此会返回全部。（动态接口的参数见下一节。）

动态与通知

与 动态 相同的列表（交易所公告、稳定币锚定变动、交易所/资金池/预言机定价场所之间的价差），按时间倒序返回，范围为最近 14 天。

curl -s 'https://www.carryroom.com/api/v1/events?kind=pool_gap,oracle_gap'

• kind 可传入种类（announcement、peg_move、dislocation、options_daily）或价差类型（price_gap、funding_gap、pool_gap、fxstable_gap、oracle_gap、lst_move、wrapper_gap），以逗号分隔。since_ms 与 limit（最多 500）也可使用。
• 每行都有 id，同一事件的 id 始终相同。请按 id 去重：较晚发现的公告，时间可能早于你已有的行。

如需新事件主动推送而非轮询，请保持以下连接（Server-Sent Events）：

curl -N https://www.carryroom.com/api/v1/events/stream

• 首先收到 event: ready，之后每个新事件一条：id: 为其 id，event: 为种类，data: 与列表中的一行相同。每 20 秒会收到一行 :ping，以免中间代理断开连接。
• 断开后带上 Last-Event-ID 头（或 ?last_event_id=）重新连接，即可收到期间错过的事件。event: gap 表示该 id 已不再记录——请用列表补齐。
• 每个客户端最多同时打开 4 个事件流。

推送不会让事件更早：延迟取决于监测方式。资金池每 30 秒检查一次，预言机定价场所每分钟一次，交易所之间的价差比市场晚 2–3 分钟，稳定币锚定每 30 分钟一次，交易所公告每 15 分钟一次。事件被记录后，列表与推送会在 5 秒内拾取。

从 Claude Code、Codex、Gemini CLI 使用

本站分发面向智能体的技能文件（SKILL.md）。放好这一个文件，智能体即可读到单位与结算周期的处理方式。

mkdir -p ~/.claude/skills/carryroom
curl -fsSL https://www.carryroom.com/skills/carryroom/SKILL.md \
  -o ~/.claude/skills/carryroom/SKILL.md

Codex CLI 与 Gemini CLI 也都会读取 ~/.agents/skills，放在这一处即可同时供两者使用。放好之后请重新开一个会话。

• /skills/carryroom/SKILL.md
• /skills/carryroom.json

第二个是清单：正在分发的文件，以及由内容得出的版本。

另有只读的 MCP 服务器（Streamable HTTP，无需密钥）。每次调用工具与 API 计入同一调用上限。添加到 Claude Code：

claude mcp add --transport http carryroom https://www.carryroom.com/mcp

• list_venues
• get_funding_rates
• get_contract
• get_carry_pairs
• get_events

返回的是观测值，不是建议。

单位，以及容易读错的地方

每个字段的单位都在响应的 meta.units 与 /openapi.json 中。以下三个读错会改变结果：

• funding_rate_8h — 已换算为每 8 小时的比例。0.0001 是 0.01%，不是 1%。交易所之间用此字段比较，不要再除以 funding_interval_h。
• carry_model = directional — 没有 funding_rate_8h，而是 funding_return_8h_long 与 funding_return_8h_short。两侧可能同时为负，反转符号得不到另一侧。
• mark_price_scaled — 按合约单位表示；除以 contract_scale 得到一枚的价格（1000PEPE → 1000）。费率不受影响。

覆盖范围

资金费率与价格，来自 49 家交易所的资金费率与价格。每次响应的实际家数见 meta.coverage。盘口厚度、成交额与历史费率不返回。

curl -s https://www.carryroom.com/api/v1/venues

调用上限

上限为每秒 1 次调用，且每 5 分钟 60 次。按 API 密钥计数；没有密钥时按 IP 地址计数。

超过后返回 429 与 Retry-After。等待相应秒数后重复同一请求即可；被拒绝的调用不计数。逐个抓取合约即使在上限内也会被拒绝——请用 /api/v1/latest 一次取回列表。

费用

免费。本站没有可购买的商品，不标示价格，也不收取款项。

常见问题