ArbTide

ArbTide API

ArbTide API trả về funding rate đã chuẩn hóa, lịch sử funding, giá trực tiếp, tuyến chênh lệch giá sau phí và giao dịch cash and carry của 35 sàn dưới dạng JSON, thu thập trực tiếp từ API của các sàn. Mỗi lệnh gọi cần một API key và được tính bằng credit: 100 mỗi ngày với key miễn phí để dùng thử, và 5,000,000 mỗi tháng với Pro cho công cụ và bot của riêng bạn.

Lấy API keyĐặc tả OpenAPI 3.1

URL gốc https://arbtide.com/api/v1

Bắt đầu nhanh

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" }
}

Ví dụ

Sao chép một ví dụ, đặt ARBTIDE_KEY rồi chạy. Header của mỗi phản hồi cho biết lệnh gọi đã tốn bao nhiêu credit.

Python: các tuyến giá tốt nhất sau phí

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: chênh lệch funding rộng nhất

// 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: cảnh báo thăm dò gửi tới 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: funding rate của một coin (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 để dùng thử API. Pro để chạy công cụ và bot của riêng bạn trên đó.

Credit

Mỗi lệnh gọi tốn credit theo lượng dữ liệu trả về: một coin hoặc một sàn tốn 1, cả danh sách 5, lịch sử funding 1 cho mỗi ngày trả về. Hạn mức và giới hạn tốc độ đều tính bằng credit, nên lệnh gọi nặng chỉ đơn giản là tốn nhiều hơn.

  • GET
    5
    Credit
    Đường dẫn
    /api/v1/exchanges/{exchange}/funding-rates
    Mô tả
    Every linear perpetual funding rate on one exchange

  • GET
    5
    Credit
    Đường dẫn
    /api/v1/funding-rates
    Mô tả
    Funding summary for every coin listed on at least two exchanges

  • GET
    5
    Credit
    Đường dẫn
    /api/v1/arbitrage
    Mô tả
    Price arbitrage routes with a positive net spread

  • GET
    5
    Credit
    Đường dẫn
    /api/v1/strategies/cash-and-carry
    Mô tả
    Cash-and-carry trades: buy spot, short the perpetual, earn funding

  • GET
    1
    Credit
    Đường dẫn
    /api/v1/exchanges
    Mô tả
    List exchanges with market counts and volume

  • GET
    1
    Credit
    Đường dẫn
    /api/v1/funding-rates/{coin}
    Mô tả
    Funding rates for one coin on every exchange

  • GET
    1 mỗi ngày
    Credit
    Đường dẫn
    /api/v1/funding-rates/{coin}/history
    Mô tả
    Hourly funding history for one coin. One credit per day asked for; Free up to 7 days, Pro up to 90

  • GET
    1
    Credit
    Đường dẫn
    /api/v1/arbitrage/{coin}
    Mô tả
    Best spot and perpetual route for one coin, including unprofitable ones

  • GET
    1
    Credit
    Đường dẫn
    /api/v1/prices/{coin}
    Mô tả
    Live bid and ask for one coin on every exchange and market type

  • GET
    1
    Credit
    Đường dẫn
    /api/v1/status
    Mô tả
    Data collection status of every exchange and stream

Hiển thị 10 trong tổng số 10

Với key Pro được phép đọc tài khoản, các endpoint /me (cảnh báo, lịch sử cảnh báo, danh sách theo dõi) tốn 1 credit mỗi lệnh. Chúng có trong đặc tả OpenAPI.

API key

Giới hạn và header

Credit Free bắt đầu lại vào mỗi nửa đêm UTC, credit Pro vào đầu mỗi tháng UTC. Giới hạn tốc độ được nạp lại mỗi giây và cho phép dùng tối đa 5 giây credit một lúc. Mỗi phản hồi có các header sau:

X-Credits-Cost
Số credit lệnh gọi này đã dùng.
X-Credits-Remaining
Số credit còn lại trong kỳ.
X-Credits-Limit
Hạn mức của bạn trong kỳ.
X-Credits-Reset
Thời điểm hạn mức bắt đầu lại (UTC).
X-RateLimit-Remaining
Số credit bạn có thể dùng ngay trước khi giới hạn tốc độ áp dụng.
Retry-After
Số giây cần chờ, gửi khi giới hạn tốc độ từ chối một lệnh gọi.
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. ..." } }

Lỗi

Lỗi được trả về dạng { error: { code, message } } với một trong các mã sau:

400
invalid_request
Thiếu tham số hoặc tham số không hợp lệ; thông báo cho biết tham số nào.
401
api_key_required
Chưa gửi API key. Hãy tạo key miễn phí trong thẻ API của tài khoản.
401
invalid_api_key
Key sai hoặc đã bị thu hồi.
401
key_expired
Key đã hết hạn. Hãy thay hoặc tạo key mới.
403
ip_not_allowed
Key bị giới hạn ở địa chỉ IP khác.
403
insufficient_scope
Key không được phép đọc mục này, ví dụ tài khoản của bạn.
403
upgrade_required
Cần gói cao hơn.
404
not_found
Không có coin, sàn hoặc tuyến này.
429
rate_limited
Quá nhanh. Hãy chờ số giây trong Retry-After.
429
quota_exceeded
Đã hết credit của kỳ này. Credit quay lại vào X-Credits-Reset.

Quy ước

Câu hỏi thường gặp

Tôi có cần API key không?
Có. Mỗi lệnh gọi đều cần key, và key miễn phí tạo trong một phút: ở thẻ API của tài khoản, không cần thẻ. Key chỉ hiện một lần, và bạn có thể thay hoặc thu hồi bất cứ lúc nào.
Key miễn phí gồm những gì?
100 credit mỗi ngày với tốc độ 1 credit mỗi giây, một key dữ liệu thị trường dùng được tối đa 30 ngày và lịch sử funding 7 ngày mỗi lệnh gọi. Nó để dùng thử API. Pro nâng lên 5,000,000 credit mỗi tháng, 10 key, giới hạn IP và lịch sử 90 ngày.
Credit được tính thế nào?
Theo lượng dữ liệu trả về: một coin hoặc một sàn tốn 1 credit, cả danh sách 5, lịch sử funding 1 credit mỗi ngày. Hạn mức và giới hạn tốc độ đều tính bằng credit, và mỗi phản hồi cho biết đã tốn bao nhiêu và còn lại bao nhiêu.
Dữ liệu đến từ đâu?
Trực tiếp từ API công khai của 35 sàn, được thu thập trên máy chủ của chúng tôi và chuẩn hóa về đơn vị so sánh được, đã trừ phí. ArbTide không bán lại dữ liệu từ các nhà tổng hợp.
Tôi có thể xây sản phẩm trên API này không?
Bạn có thể dùng dữ liệu cho công cụ cá nhân và nội bộ ở mọi gói. Bạn không được bán lại dữ liệu thô, né giới hạn hay cào dữ liệu gây hại cho dịch vụ. Chi tiết nằm trong Điều khoản.