API
API (uygulama programlama arayüzü), bir programın başka bir programdan veri veya işlem istemesinde kullandığı kurallar bütünüdür: hangi URL'nin çağrılacağı, ne gönderileceği ve yanıtın hangi formatta geleceği. Trader'ın API'ye ihtiyacı, fiyatların, emir defterlerinin ve fonlama oranlarının bir program tarafından okunması gerektiğinde doğar: bot, tablo veya panel.
İstek örneği
Varsayımsal örnek: bir program, Coin Search endpoint'i üzerinden Genesis API'den IRYS coin profilini ister. İstek bir HTTP GET'tir, anahtar başlıkta gönderilir:
curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
-H "X-API-Key: $GENESIS_API_KEY"
Yanıt JSON olarak gelir, bazı alanlar çıkarılmıştır:
{
"coin": "IRYS",
"contracts": [
{
"address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
"network": "BNB Smart Chain(BEP20)",
"exchanges": ["MEXC", "Ourbit"]
}
],
"exchanges": {
"MEXC": {
"spot_price": 0.01329,
"futures_price": 0.0133,
"deposit": true,
"withdraw": true
}
}
}
Bir insan bu bilgiyi borsa sayfalarından ve blok gezgininden bir araya getirirdi; program ise tek yanıtta alır ve MEXC vadeli fiyatının spotun (0,0133 − 0,01329) / 0,01329 × 100 ≈ %0,075 üzerinde olduğunu hemen hesaplayabilir.
Herkese açık ve özel borsa API'leri
Borsa API'sinin iki bölümü vardır. Herkese açık bölüm, piyasa verisini (fiyatlar, emir defterleri, işlemler) anahtarsız sunar. Özel bölüm hesabınızla çalışır (bakiyeler, emirler, işlem geçmişi) ve bir API anahtarı ile istek imzası gerektirir. Binance'te herkese açık endpoint'lerin güvenlik türü NONE'dır; diğerleri anahtar ve signature parametresi ister.
Veri iki yolla gelir. REST API her isteği ayrı yanıtlar: ihtiyacınız olan filtrelerle verinin anlık görüntüsünü bu şekilde alırsınız. WebSocket bağlantıyı açık tutar ve sunucu güncellemeleri kendisi gönderir: Binance işlemleri ve emir defteri değişikliklerini gerçek zamanlı bu şekilde akıtır.
Veri API'leri: tek yanıtta birçok platform
Borsa API'si yalnızca kendi platformunu bilir. Bir coin'in fiyatını 20 borsada karşılaştırmak için programın 20 bağlantıya ihtiyacı vardır ve her borsanın kendi yanıt formatı ile limitleri bulunur. Veri API'si platformları önceden birleştirir.
| API türü | Ne döndürür | Erişim |
|---|---|---|
| Herkese açık borsa API'si | Tek bir borsanın fiyatları, emir defterleri ve işlemleri | Anahtarsız |
| Özel borsa API'si | Bakiyeler, emirler, çekimler | Anahtar ve imza |
| Genesis API | Spread'ler, emir defterleri, fonlama, DEX, zincir üstü, tahmin piyasaları | Anahtar, salt okunur |
Genesis API /arbitrage/spot-spot endpoint'ine tek istek, 20'den fazla CEX borsasının spot piyasaları arasındaki hesaplanmış spread'leri, para yatırma ve çekme bayraklarıyla birlikte döndürür. Her istek bir HTTP GET'tir, her yanıt JSON'dur; her endpoint'in parametreleri ve alanları dokümantasyonda yer alır.
Ayrıca bakın: kripto API'leri: türler ve seçim, dokümantasyonda hızlı başlangıç, rate limit, ders: kripto API nedir.
Sorular ve cevaplar
API ile çalışmak için SDK gerekir mi?
API HTTP konuşuyorsa her HTTP istemcisi yeterlidir. Genesis API için curl, Python'daki requests veya JavaScript'in yerleşik fetch'i yeter.
Genesis API üzerinden işlem yapabilir miyim?
Hayır. Genesis API yalnızca veri sunar. Emirler borsada elle ya da borsanın kendi API'si ve anahtarıyla, kendi sorumluluğunuzda verilir.