ArbTide API
ArbTide API, 35 borsa için normalize fonlama oranlarını, fonlama geçmişini, canlı fiyatları, komisyon sonrası arbitraj rotalarını ve cash-and-carry işlemlerini JSON olarak, doğrudan borsa API'lerinden toplanmış halde döndürür. Her istek bir API anahtarı gerektirir ve kredi ile sayılır: denemek için ücretsiz bir anahtarla günde 100, kendi araçlarınız ve botlarınız için Pro'da ayda 5,000,000.
Hızlı başlangıç
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" }
}Örnekler
Birini kopyalayın, ARBTIDE_KEY'i ayarlayın ve çalıştırın. Her yanıt, çağrının kaç kredi tuttuğunu başlıklarında söyler.
Python: komisyon sonrası en iyi fiyat rotaları
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: en geniş fonlama farkları
// 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'a giden bir uyarı botu
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: tek bir coin için fonlama oranları (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])
}Planlar
Pro'ya geçFree, API'yi denemek içindir. Pro, kendi araçlarınızı ve botlarınızı üzerinde çalıştırmak içindir.
Free
- Kredi
- Günde 100
- Hız sınırı
- Saniyede 1
- API anahtarları
- 1
- Anahtar süresi
- En çok 30 gün
- IP adreslerinize sınırlı anahtarlar
- —
- Uyarılarınıza ve izleme listenize erişim
- —
- İstek başına fonlama geçmişi
- 7 gün
Pro
- Kredi
- Ayda 5.000.000
- Hız sınırı
- Saniyede 50
- API anahtarları
- 10
- Anahtar süresi
- 30 günden süresize
- IP adreslerinize sınırlı anahtarlar
- Dahil
- Uyarılarınıza ve izleme listenize erişim
- Dahil
- İstek başına fonlama geçmişi
- 90 gün
Krediler
Her istek döndürdüğü veri kadar kredi tutar: tek bir coin ya da tek bir borsa 1, tam bir liste 5, fonlama geçmişi döndürdüğü her gün için 1. Hem kotanız hem hız sınırınız kredi ile sayılır, yani ağır bir istek sadece daha fazla kredi kullanır.
- GET5Kredi
- Yol
- /api/v1/exchanges/{exchange}/funding-rates
- Açıklama
- Every linear perpetual funding rate on one exchange
- GET5Kredi
- Yol
- /api/v1/funding-rates
- Açıklama
- Funding summary for every coin listed on at least two exchanges
- GET5Kredi
- Yol
- /api/v1/arbitrage
- Açıklama
- Price arbitrage routes with a positive net spread
- GET5Kredi
- Yol
- /api/v1/strategies/cash-and-carry
- Açıklama
- Cash-and-carry trades: buy spot, short the perpetual, earn funding
- GET1Kredi
- Yol
- /api/v1/exchanges
- Açıklama
- List exchanges with market counts and volume
- GET1Kredi
- Yol
- /api/v1/funding-rates/{coin}
- Açıklama
- Funding rates for one coin on every exchange
- GETGün başına 1Kredi
- Yol
- /api/v1/funding-rates/{coin}/history
- Açıklama
- Hourly funding history for one coin. One credit per day asked for; Free up to 7 days, Pro up to 90
- GET1Kredi
- Yol
- /api/v1/arbitrage/{coin}
- Açıklama
- Best spot and perpetual route for one coin, including unprofitable ones
- GET1Kredi
- Yol
- /api/v1/prices/{coin}
- Açıklama
- Live bid and ask for one coin on every exchange and market type
- GET1Kredi
- Yol
- /api/v1/status
- Açıklama
- 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 | Gün başına 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 |
Hesabınızı okuyabilen bir Pro anahtarıyla /me uç noktaları (uyarılar, uyarı geçmişi, izleme listesi) istek başına 1 kredi tutar. OpenAPI tanımında listelenirler.
API anahtarları
- Anahtarları hesabınızın API sekmesinde oluşturun ve
x-api-key: arb_…ya daAuthorization: Bearer arb_…olarak gönderin. Anahtar yalnızca oluşturulduğunda bir kez gösterilir. - Her anahtar seçtiğiniz sürenin sonunda çalışmayı bırakır. Free anahtarları en çok 30 gün sürer; Pro anahtarları 90 gün, bir yıl sürebilir ya da hiç durmayabilir. Bir anahtar durmadan bir hafta önce size e-posta göndeririz.
- Bir anahtarı yenilemek size aynı ayarlarla yeni bir anahtar verir; eskisi 24 saat daha çalışır, böylece kesinti olmadan geçiş yaparsınız.
- Pro'da bir anahtar en çok 20 IP adresine veya 203.0.113.0/24 gibi IPv4 aralıklarına sınırlanabilir; başka yerden gelen istekler reddedilir.
- Her anahtar piyasa verilerini okur. Bir Pro anahtarına hesabınızı okuma izni de verilebilir.
- Bir anahtarı iptal etmek onu hemen durdurur.
Sınırlar ve başlıklar
Free kredileri her UTC gece yarısında, Pro kredileri her UTC ayının başında yeniden başlar. Hız sınırı her saniye dolar ve bir anda en çok 5 saniyelik krediyi harcamanıza izin verir. Her yanıt şu başlıkları taşır:
- X-Credits-Cost
- Bu isteğin kullandığı kredi.
- X-Credits-Remaining
- Bu dönem kalan kredi.
- X-Credits-Limit
- Dönemlik kotanız.
- X-Credits-Reset
- Kotanın yeniden başladığı an (UTC).
- X-RateLimit-Remaining
- Hız sınırı devreye girmeden hemen harcayabileceğiniz kredi.
- Retry-After
- Beklemeniz gereken saniye; hız sınırı bir isteği reddettiğinde gönderilir.
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. ..." } }Hatalar
Hatalar şu kodlardan biriyle { error: { code, message } } olarak döner:
- 400
- invalid_request
- Bir parametre eksik ya da geçersiz; mesaj hangisi olduğunu söyler.
- 401
- api_key_required
- API anahtarı gönderilmedi. Hesabınızın API sekmesinde ücretsiz bir tane oluşturun.
- 401
- invalid_api_key
- Anahtar yanlış ya da iptal edilmiş.
- 401
- key_expired
- Anahtar çalışmayı bıraktı. Yenileyin ya da yeni bir tane oluşturun.
- 403
- ip_not_allowed
- Anahtar başka IP adreslerine sınırlı.
- 403
- insufficient_scope
- Anahtarın bunu, örneğin hesabınızı, okuma izni yok.
- 403
- upgrade_required
- Bunun için daha yüksek bir plan gerekir.
- 404
- not_found
- Böyle bir coin, borsa ya da rota yok.
- 429
- rate_limited
- Çok hızlı. Retry-After'daki saniye kadar bekleyin.
- 429
- quota_exceeded
- Bu dönemin kredileri bitti. X-Credits-Reset anında geri gelir.
Kurallar
- Her yanıt
{ data, meta }biçimindedir. - Oranlar, farklar ve APR'ler kesirdir: 0.0001 = %0,01.
Sıkça sorulan sorular
- API anahtarı gerekli mi?
- Evet. Her çağrı bir anahtar ister ve ücretsiz bir tane bir dakikada alınır: hesabınızın API sekmesinde oluşturun, kart gerekmez. Anahtar yalnızca bir kez gösterilir; istediğiniz zaman yenileyebilir ya da iptal edebilirsiniz.
- Ücretsiz anahtar neleri içerir?
- Saniyede 1 kredi hızında günde 100 kredi, en çok 30 gün süren bir piyasa verisi anahtarı ve istek başına 7 günlük fonlama geçmişi. API'yi denemek için tasarlandı. Pro bunu ayda 5,000,000 krediye, 10 anahtara, IP sınırlarına ve 90 günlük geçmişe çıkarır.
- Krediler nasıl sayılır?
- Çağrının döndürdüğü veri kadar: tek bir coin ya da borsa 1 kredi, tam bir liste 5 kredi, fonlama geçmişi her gün için 1 kredi. Kotanız ve hız sınırınız kredi ile sayılır; her yanıt ne kadar tuttuğunu ve ne kadar kaldığını söyler.
- Veriler nereden geliyor?
- Doğrudan 35 borsanın herkese açık API'lerinden, kendi sunucularımızda toplanıp karşılaştırılabilir birimlere çevrilerek ve komisyonlar düşülerek. ArbTide, veri toplayıcılardan veri satın alıp yeniden satmaz.
- API üzerine bir ürün geliştirebilir miyim?
- Her planda verileri kişisel ve şirket içi araçlarınızda kullanabilirsiniz. Ham veriyi yeniden satamaz, sınırları aşamaz ve hizmete zarar verecek şekilde tarama yapamazsınız. Ayrıntılar Koşullar'da.