ArbTide

ArbTide API

ArbTide API 以 JSON 返回 35 家交易所标准化的资金费率、资金费历史、实时价格、扣除手续费后的套利路线和期现套利,数据直接从交易所 API 采集。每次请求都需要 API 密钥并按额度计算:用免费密钥试用每天 100,用 Pro 支持你自己的工具和机器人每月 5,000,000。

获取 API 密钥OpenAPI 3.1 规范

基础 URL https://arbtide.com/api/v1

快速开始

curl -H "x-api-key: $ARBTIDE_KEY" https://arbtide.com/api/v1/funding-rates/btc
HTTP/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])
}

Free 用于试用 API。Pro 用于在上面运行你自己的工具和机器人。

额度

每次请求按返回的数据量消耗额度:一个币种或一家交易所 1,完整列表 5,资金费历史按返回的天数每天 1。配额和速度限制都以额度计算,所以较重的请求只是多用一些额度。

  • GET
    5
    额度
    路径
    /api/v1/exchanges/{exchange}/funding-rates
    说明
    Every linear perpetual funding rate on one exchange

  • GET
    5
    额度
    路径
    /api/v1/funding-rates
    说明
    Funding summary for every coin listed on at least two exchanges

  • GET
    5
    额度
    路径
    /api/v1/arbitrage
    说明
    Price arbitrage routes with a positive net spread

  • GET
    5
    额度
    路径
    /api/v1/strategies/cash-and-carry
    说明
    Cash-and-carry trades: buy spot, short the perpetual, earn funding

  • GET
    1
    额度
    路径
    /api/v1/exchanges
    说明
    List exchanges with market counts and volume

  • GET
    1
    额度
    路径
    /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

  • GET
    1
    额度
    路径
    /api/v1/arbitrage/{coin}
    说明
    Best spot and perpetual route for one coin, including unprofitable ones

  • GET
    1
    额度
    路径
    /api/v1/prices/{coin}
    说明
    Live bid and ask for one coin on every exchange and market type

  • GET
    1
    额度
    路径
    /api/v1/status
    说明
    Data collection status of every exchange and stream

显示 10 / 10 条

使用可读取账户的 Pro 密钥时,/me 接口(提醒、提醒历史、关注列表)每次 1 额度。它们都列在 OpenAPI 规范里。

API 密钥

限制与响应头

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 时恢复。

约定

常见问题

需要 API 密钥吗?
需要。每次调用都要带密钥,免费密钥一分钟就能创建:在账户的 API 标签页创建,无需绑卡。密钥只显示一次,你可以随时更换或撤销。
免费密钥包含什么?
每秒 1 额度、每天 100 额度,一个最长 30 天有效的市场数据密钥,以及每次请求 7 天的资金费历史。它用于试用 API。Pro 提升到每月 5,000,000 额度、10 个密钥、IP 限制和90 天的历史。
额度是怎么计算的?
按调用返回的数据量:一个币种或一家交易所 1 额度,完整列表 5,资金费历史每天 1 额度。配额和速度限制都按额度计算,每个响应都会告诉你这次消耗和剩余。
数据从哪里来?
直接来自 35 家交易所的公开 API,在我们自己的服务器上采集,换算成可比较的单位并扣除手续费。ArbTide 不转售聚合商的数据。
可以在 API 上做产品吗?
任何方案都可以把数据用于个人和内部工具。不得转售原始数据、绕过限制,或以损害服务的方式抓取。细节见服务条款。