ArbTide API
ArbTide API 以 JSON 返回 35 家交易所标准化的资金费率、资金费历史、实时价格、扣除手续费后的套利路线和期现套利,数据直接从交易所 API 采集。每次请求都需要 API 密钥并按额度计算:用免费密钥试用每天 100,用 Pro 支持你自己的工具和机器人每月 5,000,000。
快速开始
curl -H "x-api-key: $ARBTIDE_KEY" https://arbtide.com/api/v1/funding-rates/btcHTTP/2 200
x-credits-cost: 1
x-credits-remaining: 99
x-credits-reset: 2026-11-19T00:00:00.000Z
{
"data": {
"coin": "BTC",
"averageApr": 0.04156994580336466,
"spreadApr": 0.358503,
"long": { "exchange": "deepcoin", "rate": -0.0001624, "intervalHours": 8, "apr": -0.17782799999999999 },
"short": { "exchange": "xt", "rate": 0.000165, "intervalHours": 8, "apr": 0.180675 },
"rates": [
{ "exchange": "xt", "symbol": "BTC/USDT:USDT", "rate": 0.000165, "intervalHours": 8, "apr": 0.180675 },
{ "exchange": "extended", "symbol": "BTC/USDC:USDC", "rate": 0.000013, "intervalHours": 1, "apr": 0.11388, "markPrice": 64656.27777825 }
]
},
"meta": { "updatedAt": "2026-11-18T07:22:13.556Z" }
}示例
复制一个,设置 ARBTIDE_KEY 后运行。每个响应的请求头都会告诉你这次调用消耗了多少额度。
Python:扣除手续费后最好的价格路线
import os
import requests
API = "https://arbtide.com/api/v1"
headers = {"x-api-key": os.environ["ARBTIDE_KEY"]}
# Price routes with a positive spread after fees, widest first (5 credits)
reply = requests.get(f"{API}/arbitrage", params={"type": "perp", "limit": 10}, headers=headers)
for route in reply.json()["data"]:
print(route["coin"], route["buy"]["exchange"], "->", route["sell"]["exchange"], f'{route["netSpread"]:.2%} net')
print("credits left:", reply.headers["x-credits-remaining"])JavaScript:资金费差距最大的币种
// Node 18+ or any browser-less runtime with fetch
const reply = await fetch("https://arbtide.com/api/v1/funding-rates?limit=10", {
headers: { "x-api-key": process.env.ARBTIDE_KEY },
})
const { data } = await reply.json()
for (const coin of data) {
console.log(coin.coin, `${(coin.spreadApr * 100).toFixed(1)}% APR`, "long", coin.long.exchange, "short", coin.short.exchange)
}
console.log("credits left:", reply.headers.get("x-credits-remaining"))Python:轮询并推送到 Discord 的提醒
import os, time, requests
API = "https://arbtide.com/api/v1"
HEADERS = {"x-api-key": os.environ["ARBTIDE_KEY"]}
DISCORD = os.environ["DISCORD_WEBHOOK_URL"]
def get(path, **params):
while True:
reply = requests.get(f"{API}{path}", params=params, headers=HEADERS)
if reply.status_code == 429 and reply.json()["error"]["code"] == "rate_limited":
time.sleep(int(reply.headers.get("Retry-After", 1))) # the speed limit refills every second
continue
reply.raise_for_status()
return reply.json()["data"]
seen = set()
while True:
# A list costs 5 credits: every 15 minutes is 480 a day, so run this on Pro. Free has 100 a day.
for route in get("/arbitrage", type="perp", minNetSpread=0.005, limit=5):
key = (route["coin"], route["buy"]["exchange"], route["sell"]["exchange"])
if key not in seen:
seen.add(key)
requests.post(DISCORD, json={"content": f'{route["coin"]}: {route["netSpread"]:.2%} net, buy {key[1]}, sell {key[2]}'})
time.sleep(15 * 60)Google Sheets:单个币种的资金费率(Apps Script)
// Google Sheets: Extensions > Apps Script. Save the key under Project Settings > Script properties as ARBTIDE_KEY.
// In a cell: =ARBTIDE_FUNDING("BTC")
function ARBTIDE_FUNDING(coin) {
const key = PropertiesService.getScriptProperties().getProperty("ARBTIDE_KEY")
const reply = UrlFetchApp.fetch("https://arbtide.com/api/v1/funding-rates/" + String(coin).toLowerCase(), { headers: { "x-api-key": key } })
return JSON.parse(reply.getContentText()).data.rates.map((rate) => [rate.exchange, rate.rate, rate.apr])
}方案
升级 ProFree 用于试用 API。Pro 用于在上面运行你自己的工具和机器人。
Free
- 额度
- 每天 100
- 速度限制
- 每秒 1
- API 密钥
- 1
- 密钥有效期
- 最长 30 天
- 限定 IP 地址的密钥
- —
- 读取你的提醒和关注列表
- —
- 每次请求的资金费历史
- 7 天
Pro
- 额度
- 每月 5,000,000
- 速度限制
- 每秒 50
- API 密钥
- 10
- 密钥有效期
- 30 天到永久
- 限定 IP 地址的密钥
- 包含
- 读取你的提醒和关注列表
- 包含
- 每次请求的资金费历史
- 90 天
额度
每次请求按返回的数据量消耗额度:一个币种或一家交易所 1,完整列表 5,资金费历史按返回的天数每天 1。配额和速度限制都以额度计算,所以较重的请求只是多用一些额度。
- GET5额度
- 路径
- /api/v1/exchanges/{exchange}/funding-rates
- 说明
- Every linear perpetual funding rate on one exchange
- GET5额度
- 路径
- /api/v1/funding-rates
- 说明
- Funding summary for every coin listed on at least two exchanges
- GET5额度
- 路径
- /api/v1/arbitrage
- 说明
- Price arbitrage routes with a positive net spread
- GET5额度
- 路径
- /api/v1/strategies/cash-and-carry
- 说明
- Cash-and-carry trades: buy spot, short the perpetual, earn funding
- GET1额度
- 路径
- /api/v1/exchanges
- 说明
- List exchanges with market counts and volume
- GET1额度
- 路径
- /api/v1/funding-rates/{coin}
- 说明
- Funding rates for one coin on every exchange
- GET每天 1额度
- 路径
- /api/v1/funding-rates/{coin}/history
- 说明
- Hourly funding history for one coin. One credit per day asked for; Free up to 7 days, Pro up to 90
- GET1额度
- 路径
- /api/v1/arbitrage/{coin}
- 说明
- Best spot and perpetual route for one coin, including unprofitable ones
- GET1额度
- 路径
- /api/v1/prices/{coin}
- 说明
- Live bid and ask for one coin on every exchange and market type
- GET1额度
- 路径
- /api/v1/status
- 说明
- Data collection status of every exchange and stream
| GET | /api/v1/exchanges/{exchange}/funding-rates | Every linear perpetual funding rate on one exchange | 5 |
| GET | /api/v1/funding-rates | Funding summary for every coin listed on at least two exchanges | 5 |
| GET | /api/v1/arbitrage | Price arbitrage routes with a positive net spread | 5 |
| GET | /api/v1/strategies/cash-and-carry | Cash-and-carry trades: buy spot, short the perpetual, earn funding | 5 |
| GET | /api/v1/exchanges | List exchanges with market counts and volume | 1 |
| GET | /api/v1/funding-rates/{coin} | Funding rates for one coin on every exchange | 1 |
| GET | /api/v1/funding-rates/{coin}/history | Hourly funding history for one coin. One credit per day asked for; Free up to 7 days, Pro up to 90 | 每天 1 |
| GET | /api/v1/arbitrage/{coin} | Best spot and perpetual route for one coin, including unprofitable ones | 1 |
| GET | /api/v1/prices/{coin} | Live bid and ask for one coin on every exchange and market type | 1 |
| GET | /api/v1/status | Data collection status of every exchange and stream | 1 |
显示 10 / 10 条
使用可读取账户的 Pro 密钥时,/me 接口(提醒、提醒历史、关注列表)每次 1 额度。它们都列在 OpenAPI 规范里。
API 密钥
- 在账户的 API 标签页创建密钥,并以
x-api-key: arb_…或Authorization: Bearer arb_…发送。密钥只在创建时显示一次。 - 每个密钥在你选择的有效期结束后失效。Free 密钥最长 30 天;Pro 密钥可选 90 天、1 年或永久。失效前一周我们会发邮件提醒。
- 更换密钥会得到设置相同的新密钥,旧密钥还能用 24 小时,让你无中断地切换。
- 在 Pro 中,一个密钥可以限定最多 20 个 IP 地址或 IPv4 范围(如 203.0.113.0/24);来自其他地方的请求会被拒绝。
- 所有密钥都能读取市场数据。Pro 密钥还可以允许读取你的账户。
- 撤销密钥会立即停止它。
限制与响应头
Free 额度在每个 UTC 午夜重新开始,Pro 额度在每个 UTC 月初重新开始。速度限制每秒恢复,一次最多可用 5 秒的额度。每个响应都带有以下响应头:
- X-Credits-Cost
- 本次请求消耗的额度。
- X-Credits-Remaining
- 本期剩余额度。
- X-Credits-Limit
- 本期配额。
- X-Credits-Reset
- 配额重新开始的时间(UTC)。
- X-RateLimit-Remaining
- 在速度限制生效前可立即使用的额度。
- Retry-After
- 需要等待的秒数,在速度限制拒绝请求时返回。
HTTP/2 429
{ "error": { "code": "quota_exceeded", "message": "The daily quota of 100 credits is used up; it resets at 2026-11-19T00:00:00.000Z. ..." } }错误
错误以 { error: { code, message } } 返回,代码为以下之一:
- 400
- invalid_request
- 缺少参数或参数无效;消息会说明是哪一个。
- 401
- api_key_required
- 未发送 API 密钥。请在账户的 API 标签页免费创建一个。
- 401
- invalid_api_key
- 密钥错误或已被撤销。
- 401
- key_expired
- 密钥已失效。请更换或新建一个。
- 403
- ip_not_allowed
- 密钥限定了其他 IP 地址。
- 403
- insufficient_scope
- 密钥无权读取此内容,例如你的账户。
- 403
- upgrade_required
- 需要更高的方案。
- 404
- not_found
- 没有这个币种、交易所或路线。
- 429
- rate_limited
- 请求太快。请等待 Retry-After 中的秒数。
- 429
- quota_exceeded
- 本期额度已用完,将在 X-Credits-Reset 时恢复。
约定
- 每个响应都是
{ data, meta }。 - 费率、价差和 APR 都是小数:0.0001 = 0.01%。
常见问题
- 需要 API 密钥吗?
- 需要。每次调用都要带密钥,免费密钥一分钟就能创建:在账户的 API 标签页创建,无需绑卡。密钥只显示一次,你可以随时更换或撤销。
- 免费密钥包含什么?
- 每秒 1 额度、每天 100 额度,一个最长 30 天有效的市场数据密钥,以及每次请求 7 天的资金费历史。它用于试用 API。Pro 提升到每月 5,000,000 额度、10 个密钥、IP 限制和90 天的历史。
- 额度是怎么计算的?
- 按调用返回的数据量:一个币种或一家交易所 1 额度,完整列表 5,资金费历史每天 1 额度。配额和速度限制都按额度计算,每个响应都会告诉你这次消耗和剩余。
- 数据从哪里来?
- 直接来自 35 家交易所的公开 API,在我们自己的服务器上采集,换算成可比较的单位并扣除手续费。ArbTide 不转售聚合商的数据。
- 可以在 API 上做产品吗?
- 任何方案都可以把数据用于个人和内部工具。不得转售原始数据、绕过限制,或以损害服务的方式抓取。细节见服务条款。