API endpoint
Endpoint, belirli bir API işlevinin URL'sidir: program tek tür veri almak için onu çağırır; örneğin Spot – Spot spread'leri veya fonlama oranları. Dokümantasyon bir endpoint'i HTTP yöntemiyle birlikte listeler: GET /arbitrage/spot-spot.
URL'nin dökümü
https://api.genesisarbitrage.com/v1/arbitrage/spot-spot?min_spread=0.5 URL'si bir curl isteğinde:
BASE="https://api.genesisarbitrage.com/v1"
curl "$BASE/arbitrage/spot-spot?min_spread=0.5" \
-H "X-API-Key: $GENESIS_API_KEY"
| Bölüm | Değer |
|---|---|
| Temel URL | https://api.genesisarbitrage.com/v1: sunucu ve API sürümü |
| Yol | /arbitrage/spot-spot: Spot — Spot veri seti |
| Sorgu parametresi | min_spread=0.5: %0,5 veya daha yüksek spread |
İstek, spread'i %0,5 veya daha yüksek olan fırsatları döndürür: coin (coin), alış ve satış borsaları (exchange_buy, exchange_sell), fiyatlar, spread_pct ile para yatırma ve çekme bayrakları. Endpoint'in diğer parametreleri coin, exchange ve min_volume, Spot — Spot bölümünde listelenmiştir.
Yol parametreleri ve sorgu parametreleri
Yol parametresi URL'nin kendisinin bir parçasıdır; dokümantasyonda süslü parantezle gösterilir. /orderbooks/coin/{coin} içinde {coin} yerine bir ticker yazarsınız: /orderbooks/coin/BTC, BTC'nin her borsa ve piyasadaki emir defterlerini döndürür (Coin emir defterleri).
Sorgu parametreleri ? işaretinden sonra ad=değer çiftleri olarak gelir ve & ile ayrılır. Bir URL iki türü de taşıyabilir: /orderbooks/spreads/spot-futures?coin=BTC&volume=5000 içinde spot-futures veri seti yolda, coin ve 5.000 $ hacim sorgu parametrelerindedir (Emir defteri Δ).
Çağrıdaki hatalar
| Yanıt | Neden |
|---|---|
404 not_found | Böyle bir endpoint veya kaynak yok |
400 bad_request | Geçersiz parametreler, ayrıntı message içinde |
403 plan_restricted | Endpoint planınızda yok |
410 gone | Endpoint kullanımdan kaldırıldı, yerine geçeni message içinde |
35'ten fazla endpoint'in tam listesi dokümantasyonda ve makine tarafından okunabilir OpenAPI şemasında yer alır.
Ayrıca bakın: REST API, JSON, arbitraj endpoint'leri, emir defteri endpoint'leri.
Sorular ve cevaplar
Endpoint, API'den nasıl farklıdır?
API, bir servisin tüm işlevlerinin bütünüdür; endpoint ise kendi URL'si olan tek bir işlevdir. Genesis API'de bunlardan 35'ten fazlası vardır: arbitraj, emir defterleri, fonlama, piyasa, zincir üstü, tahmin piyasaları, AI sinyalleri ve coin arama.