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.
Bắt đầu nhanh
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" }
}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])
}Gói
Nâng cấp ProFree để dùng thử API. Pro để chạy công cụ và bot của riêng bạn trên đó.
Free
- Credit
- 100 mỗi ngày
- Giới hạn tốc độ
- 1 mỗi giây
- API key
- 1
- Thời hạn key
- Tối đa 30 ngày
- Key chỉ dùng từ địa chỉ IP của bạn
- —
- Quyền đọc cảnh báo và danh sách theo dõi
- —
- Lịch sử funding mỗi lệnh gọi
- 7 ngày
Pro
- Credit
- 5.000.000 mỗi tháng
- Giới hạn tốc độ
- 50 mỗi giây
- API key
- 10
- Thời hạn key
- Từ 30 ngày đến vô thời hạn
- Key chỉ dùng từ địa chỉ IP của bạn
- Có
- Quyền đọc cảnh báo và danh sách theo dõi
- Có
- Lịch sử funding mỗi lệnh gọi
- 90 ngày
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.
- GET5Credit
- Đường dẫn
- /api/v1/exchanges/{exchange}/funding-rates
- Mô tả
- Every linear perpetual funding rate on one exchange
- GET5Credit
- Đường dẫn
- /api/v1/funding-rates
- Mô tả
- Funding summary for every coin listed on at least two exchanges
- GET5Credit
- Đường dẫn
- /api/v1/arbitrage
- Mô tả
- Price arbitrage routes with a positive net spread
- GET5Credit
- Đường dẫn
- /api/v1/strategies/cash-and-carry
- Mô tả
- Cash-and-carry trades: buy spot, short the perpetual, earn funding
- GET1Credit
- Đường dẫn
- /api/v1/exchanges
- Mô tả
- List exchanges with market counts and volume
- GET1Credit
- Đường dẫn
- /api/v1/funding-rates/{coin}
- Mô tả
- Funding rates for one coin on every exchange
- GET1 mỗi ngàyCredit
- Đườ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
- GET1Credit
- Đường dẫn
- /api/v1/arbitrage/{coin}
- Mô tả
- Best spot and perpetual route for one coin, including unprofitable ones
- GET1Credit
- Đường dẫn
- /api/v1/prices/{coin}
- Mô tả
- Live bid and ask for one coin on every exchange and market type
- GET1Credit
- Đường dẫn
- /api/v1/status
- Mô tả
- 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 mỗi ngày |
| 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 |
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
- Tạo key trong thẻ API của tài khoản rồi gửi dưới dạng
x-api-key: arb_…hoặcAuthorization: Bearer arb_…. Key chỉ hiện một lần, lúc tạo. - Mỗi key ngừng hoạt động khi hết thời hạn bạn chọn. Key Free dùng tối đa 30 ngày; key Pro có thể dùng 90 ngày, một năm hoặc vô thời hạn. Chúng tôi gửi email một tuần trước đó.
- Thay key sẽ cho bạn key mới với cùng cài đặt, còn key cũ vẫn dùng được 24 giờ để bạn chuyển đổi không gián đoạn.
- Với Pro, một key có thể giới hạn tối đa 20 địa chỉ IP hoặc dải IPv4 như 203.0.113.0/24; lệnh gọi từ nơi khác bị từ chối.
- Mọi key đều đọc được dữ liệu thị trường. Key Pro còn có thể được phép đọc tài khoản của bạn.
- Thu hồi key sẽ dừng key ngay lập tức.
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
- Mọi phản hồi đều có dạng
{ data, meta }. - Tỷ lệ, chênh lệch và APR là số thập phân: 0.0001 = 0,01%.
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.