Arbitraj için API verisi: spreadler, emir defterleri, fonlama
Kısaca
- Trader'ın her sorusunun kendi endpoint'i var: fiyat farkı
/arbitrage/*içindekispread_pct, coin transferi yatırma ve çekme bayrakları ilenetworkvecontract, hacminize göre gerçekleşme/orderbooks/*, fonlama senaryosu ise/funding/*. - Satır spread'i son işlemlerden hesaplanır. Örnekte %1,5'lik spread, 2.500 $ için emir defteri taranınca %0,72'ye, iki adet %0,1 taker komisyonundan sonra yaklaşık %0,52'ye, yani yaklaşık 13 $'a düşer.
- Her yanıt kendi zamanını taşır:
meta.updated_atsnapshot'ın oluşturulduğu an,meta.freshness_secplanınızın yenileme adımı,age_secvestaleise emir defterinin yaşıdır. - Bir parite dört noktada kontrol edilir: fiyat farkı, transfer, emir defteri ve tazelik. Herhangi biri başarısız olursa girişten vazgeçilir.
- CEX arbitrajı, fonlama ve açık pozisyon (OI) her Genesis API planında var, zincir üstü bölümler Start'tan başlar, emir defterleri ve DEX verileri ise Pro ve Max ile gelir.
Kripto arbitraj verisi beş soruyu yanıtlar: fiyat farkı var mı, coin'i taşıyabilir misiniz, emir defteri hacminiz için yeterince derin mi, fonlama ödüyor mu ve büyük oyuncular ne yapıyor. Genesis API'de her sorunun kendi endpoint'i ve birkaç yanıt alanı var. İlk istek ile success, data, meta zarfı 2. derste anlatıldı; bu ders hangi alanların hangi sırayla okunacağını anlatır.
Trader sorusu → endpoint → alanlar
| Soru | Endpoint | Alanlar |
|---|---|---|
| Fiyat farkı var mı | /arbitrage/* | spread_pct, price_buy, price_sell |
| Coin'i taşıyabilir misiniz | aynı /arbitrage/spot-spot satırı | withdraw_enabled_buy, deposit_enabled_sell, network, contract |
| Defter yeterince derin mi | /orderbooks/* | order_delta.spread_pct, order_delta.status |
| Fonlama ödüyor mu | /funding/* | spread_pct, interval_1, interval_2, next_payout_1 |
| Büyük oyuncular ne yapıyor | /onchain/*, /market/open-interest | direction, total_usd, oi_change_1h |
Yıldız bir grubu gösterir: /arbitrage/* Spot – Spot'tan hisse senetlerine kadar yedi endpoint içerir, /orderbooks/* ve /funding/* ise altışar endpoint içerir. Aşağıdaki bölümler bir pariteyi kontrol etme sırasını izler.
Fiyat farkı var mı: spread_pct
Spot — Spot dokümantasyonundan bir satır: FUEL, ByBit'ten 0,0007029'dan al, Gate'te 0,0007037'den sat, spread_pct 0,11. Kontrol: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ %0,11. Satır spread'i son işlem fiyatları olan price_buy ve price_sell üzerinden hesaplanır; sitede bu Fiyat sütunudur.
DEX – Spot ve DEX – Futures veri setlerinde işaret önemlidir: artı, token'ın DEX'te daha ucuz olduğu, eksi ise daha pahalı olduğu anlamına gelir. Yedi veri setinin parametreleri ve alanları arbitraj endpoint'leri rehberinde.
spread_pct yalnızca ilk soruyu yanıtlar: içinde komisyon, transfer ve emir defteri yoktur.
Coin'i taşıyabilir misiniz: yatırma, çekme, ağ ve kontrat
Borsalar arası spot parite transfer gerektirir: coin'i bir borsadan alır, çeker ve diğerine yatırırsınız. Bu yüzden satırda okunacak iki bayrak vardır: withdraw_enabled_buy alış borsasında çekimlerin açık olup olmadığını, deposit_enabled_sell ise satış borsasında yatırmaların açık olup olmadığını gösterir. İstekte bunlar için parametre yoktur, satırları kodunuz filtreler.
network ve contract aynı token olup olmadığını söyler. Farklı borsalarda farklı coin'ler aynı ticker altında işlem görebilir; bu yüzden kontrat adresini iki borsanın çekme ve yatırma sayfalarıyla karşılaştırın. Bir coin'in ağlara göre kontratları ve her birini kullanan borsalar, herhangi bir planda /coins/search ile alınır (Coin Search).
DEX veri setlerinde bayraklar CEX tarafına aittir: deposit_enabled ve withdraw_enabled. Cross-chain'de token, buy.chain ve sell.chain ağları arasında bir köprüyle taşınır, bu yüzden borsa bayrakları yoktur.
Emir defteri yeterince derin mi: satır spread'i ve gerçekleşme sonrası spread
Piyasa emri emir defterini tarar: alış en iyi fiyattan başlayarak ask'ları yukarı doğru, satış ise bid'leri aşağı doğru tüketir. Hacim büyüdükçe ortalama fiyat kötüleşir ve satır spread'inden geriye daha az şey kalır. Emir defteri Δ, yani Pro ve Max planlarındaki /orderbooks/spreads/{dataset}, hacminiz için geriye ne kaldığını döndürür (dokümantasyon).
Açıklayıcı örnek: LMN coin'i, OKX'ten 0,4000'den al, Bitget'te 0,4060'tan sat. Satır spread'i: (0,4060 − 0,4000) / 0,4000 × 100 = %1,5. Farklı volume değerleriyle coin=LMN için /orderbooks/spreads/spot-spot isteği:
| Hacim | Alış → satış | Emir defteri Δ | Dolar olarak |
|---|---|---|---|
0 | 0,4002 → 0,4058 | %1,3993 | — |
| 500 $ | 0,4004 → 0,4055 | %1,2737 | 6,37 $ |
| 2.500 $ | 0,4012 → 0,4041 | %0,7228 | 18,07 $ |
| 10.000 $ | — | exhausted | — |
volume=0 en iyi OKX ask'ını ve en iyi Bitget bid'ini kullanır: en iyi emirler son işlemlerden daha kötü durur, bu yüzden en küçük hacimde bile 0,1 puan kaybolur. 2.500 $'da ortalama alış fiyatı 0,4012, ortalama satış fiyatı 0,4041'dir: (0,4041 − 0,4012) / 0,4012 × 100 ≈ %0,7228. 10.000 $'da Bitget bid'leri tükendi ve order_delta.status değeri exhausted olur.
Her borsa taker komisyonu alır; örnekte %0,1 varsayılmıştır (maker ve taker). 2.500 $'da elinizde 0,7228 − 2 × 0,1 = %0,5228 kalır, yani 2.500 × 0,5228 / 100 ≈ 13,07 $. Çekim komisyonları yanıtlarda yoktur: bunlara borsanın çekme sayfasından bakın ve ayrıca düşersiniz.
Trial ve Start planlarında emir defteri endpoint'leri 403 plan_restricted döndürür, bu yüzden defteri borsa terminalinde kontrol edersiniz. Gerçekleşme fiyatı ve slippage Kripto emir defteri API'si yazısında, altı endpoint'in tamamı ise emir defteri endpoint'leri rehberinde anlatılır.
Fonlama ödüyor mu: spread, aralıklar ve ödemeler
Fonlama arbitrajı, fonlama oranının yüksek olduğu yerde short, düşük olduğu yerde long açmaktır: fiyat hareketleri sonucu neredeyse etkilemez, oran farkı birikir. Adaylar herhangi bir planda /funding/spread ile gelir: best içinde en iyi borsa çifti ve onun spread_pct değeri (Funding spread).
Parite spread'i ödemelerin ne zaman ve ne sıklıkla yapıldığını söylemez. interval_1 ve interval_2 iki borsanın fonlama aralıklarıdır, next_payout_1 ve next_payout_2 ise UTC cinsinden sonraki ödeme zamanlarıdır: fonlamayı yalnızca uzlaşma anında açık olan pozisyon alır. Farklı aralıklı oranlar 8 saate normalleştirilerek karşılaştırılır; bu, /funding/rates içindeki funding_8h_pct alanıdır.
Açıklayıcı örnek: 8 saatte %0,03 spread, her bacakta 5.000 $ pozisyon. Bir uzlaşma 5.000 × 0,03 / 100 = 1,5 $ getirir. İki bacağın açılıp kapanması olan dört işlem, %0,1 taker komisyonunda 4 × 5.000 × 0,1 / 100 = 20 $ tutar. Komisyonlar 20 / 1,5 ≈ 13,3 uzlaşmada çıkar: bu 14 sekiz saatlik uzlaşma, yani oranlar korunursa yaklaşık beş gündür.
Farkın sürüp sürmediğini geçmiş gösterir: Pro ve Max'te coin ile /funding/analytics/summary, her borsa için her dönemde sum (biriken fonlama), cov (kapsama) ve flips (işaret değişimleri) döndürür. Ayrıntılar Fonlama oranı API'si yazısında ve fonlama endpoint'leri rehberinde.
Büyük oyuncular ne yapıyor: zincir üstü ve açık pozisyon
Zincir üstü veri ve açık pozisyon (OI), bir paritenin siz işleme almadan önce neden kapanabileceğini açıklar. Satış borsasına giren coin, transferiniz ulaşmadan önce gelen satıcılar demektir. Artan açık pozisyon yeni kaldıraçlı pozisyonlar demektir ve onlara ters yönde sert bir hareket likidasyonları tetikler.
| Ne görüyorsunuz | İstek | Alanlar | Planlar |
|---|---|---|---|
| Borsalara ve borsalardan coin akışı | /onchain/coin-traffic | direction, target, total_usd | Start, Pro, Max |
| Token kilit açılımları | /onchain/unlocks | unlock_value_usd, hours_left | Start, Pro, Max |
| Borsalara göre açık pozisyon | /market/open-interest | oi_usd, oi_change_1h, price_change_1h | Tümü |
Genesis Onchain dokümantasyonundaki örnek yanıt, 5,69 saatte Gate'e 573.796,98 $ değerinde 18 LAB transferini gösterir; direction değeri deposit'tir. O anda LAB için Gate'te satış yapan bir parite varsa, böyle bir akış hacmi küçültmek veya girişi atlamak için bir nedendir. Daha fazlası Zincir üstü veri API'si ve Açık pozisyon API'si yazılarında.
Veri tazeliği ve zaman damgaları
Her yanıt kendi zamanını taşır: meta.updated_at snapshot'ın oluşturulduğu unix zamanıdır, meta.freshness_sec ise planınızın yenileme adımıdır: Trial'da 60 saniye, Start'ta 30, Pro'da 10 ve Max'te 5. Snapshot'ın yaşı, güncel zaman eksi updated_at değeridir (veri tazeliği).
Açıklayıcı örnek: Trial planı, yanıt 1783802455'te geldi ve updated_at 1783802410. Snapshot 1783802455 − 1783802410 = 45 saniyelik: paritelerin fiyatları neredeyse bir dakika eskidir ve bazıları borsalarda artık kalmamış olabilir.
Emir defterlerinin kendi saati vardır: /orderbooks/book ve /orderbooks/coin/{coin} içinde her defterde book_ts, age_sec (saniye cinsinden yaşı) ve 30 saniyeden eskiyse stale: true bulunur. Defterler borsanın 5–20 saniye gerisinde kalır, bu yüzden iki bacağın yaşını da kontrol edin: taze bir defter ile eski bir defter arasındaki fiyat farkı zaman farkı olabilir.
Neden tek alan yetmez: dört noktalı kontrol
Her alan bir soruyu kapatır ve ancak hepsi kapandığında girebilirsiniz. Çekimlerin kapalı olduğu %3'lük bir spread, coin'i alış borsasında takılı bırakır. exhausted ile hacminiz dolmaz. 50 saniyelik bir snapshot'ta parite çoktan kaybolmuş olabilir.
| Nokta | Alanlar | Parite şu durumda elenir |
|---|---|---|
| 1. Fiyat farkı | spread_pct | spread eksi iki komisyon eşiğin altında |
| 2. Transfer | withdraw_enabled_buy, deposit_enabled_sell, contract | çekimler veya yatırmalar kapalı ya da kontrat eşleşmiyor |
| 3. Emir defteri | order_delta.status, order_delta.spread_pct | durum ok değil veya kalan eşiğin altında |
| 4. Tazelik | meta.updated_at, age_sec, stale | snapshot veya bir defter eşikten eski |
Fonksiyon /arbitrage/spot-spot içinden bir data satırını, aynı borsa çifti için order_delta nesnesini (Trial ve Start'ta None) ve yanıtın meta bölümünü alır. Eşikler açıklayıcıdır: komisyonlarınıza ve planınıza göre ayarlayın.
import time
FEE = 0.1 # bacak başına varsayılan taker komisyonu, %
MIN_NET = 0.3 # komisyondan sonra en az %0,3 kalmalı
MAX_AGE = 60 # snapshot en fazla 60 saniyelik olmalı
def check(row, od, meta):
"""Spot – Spot paritesinin elendiği noktalar."""
fails = []
if row["spread_pct"] - 2 * FEE < MIN_NET:
fails.append("1: spread komisyonları karşılamıyor")
if not row["withdraw_enabled_buy"]:
fails.append("2: alış borsasında çekimler kapalı")
if not row["deposit_enabled_sell"]:
fails.append("2: satış borsasında yatırmalar kapalı")
if od is None:
fails.append("3: defter kontrol edilmedi (Trial veya Start)")
elif od["status"] != "ok":
fails.append("3: defter — " + od["status"])
elif od["spread_pct"] - 2 * FEE < MIN_NET:
fails.append("3: defterden sonra çok az kaldı")
if time.time() - meta["updated_at"] > MAX_AGE:
fails.append("4: snapshot MAX_AGE saniyeden eski")
return fails
Boş liste, paritenin dört noktayı da geçtiği anlamına gelir. 2.500 $'lık LMN paritesi geçer: satırda 1,5 − 0,2 = %1,3, defterden sonra 0,7228 − 0,2 = %0,5228 ve 45 saniyelik snapshot. 10.000 $'da fonksiyon "3: defter — exhausted" döndürür. Kod kontratı doğrulayamaz: adresi borsaların çekme ve yatırma sayfalarında siz kontrol edersiniz; iki bacağın defter yaşı ise /orderbooks/book içinden gelir.
Aynı kontrolün kodsuz, sitedeki tablo üzerindeki hali Spread, derinlik, hacim — tabloyu okumak dersinde, API'yi döngüde sorgulama ise 4. derste.
Hangi plan hangi veriyi verir
| Plan | Tazelik | Arbitraj verisi |
|---|---|---|
| Trial, aylık 20 $ | 60 sn | Spot – Spot, Spot – Futures, Futures – Futures, fonlama oranları ve spread, açık pozisyon, Fair – Last, pump'lar, coin araması |
| Start, 50 $ | 30 sn | Trial'ın tamamı artı hisse senetleri, zincir üstü bölümler /onchain/{section}, exact ve dutch modlarında tahmin arbitrajı |
| Pro, 100 $ | 10 sn | Tüm endpoint'ler: emir defterleri ve emir defteri Δ, DEX – Spot, DEX – Futures, Cross-chain, fonlama analitiği |
| Max, 200 $ | 5 sn | Pro ile aynı endpoint'ler, saniyede 15 istek ile |
Planınızın dışındaki bir endpoint 403 plan_restricted döndürür ve bu yanıt kota harcamaz. Çağrı kotaları ve saniyedeki istek limitleri Genesis API fiyatları sayfasında.
Uygulama
Bir parite seçin
Spot — Spot dokümantasyonunda Deneyin formunu açın, anahtarınızı yapıştırın ve spread'i %1 veya daha yüksek bir satır seçin.
1. ve 2. noktaları çalıştırın
spread_pctdeğerinden varsayılan iki adet %0,1 komisyonu çıkarın vewithdraw_enabled_buyiledeposit_enabled_sellalanlarına bakın.contractdeğerini bu coin için/coins/searchyanıtıyla karşılaştırın.3. noktayı çalıştırın
Pro veya Max'te bu coin ve
volume=1000ile/orderbooks/spreads/spot-spotisteği gönderin ve aynı borsa çiftinin satırını bulun. Trial ve Start'ta emir defterini borsa terminalinde açın.4. noktayı çalıştırın
Güncel unix zamanından
meta.updated_atdeğerini çıkarın: terminaldedate +%sbunu yazdırır.Kararı yazın
Parite ilk olarak hangi noktada elenirdi ve 1.000 $'da spread'den ne kadar kalırdı.
Sorular ve cevaplar
Kripto arbitrajı için hangi veriler gerekir?
Coin'in farklı borsalardaki fiyatları ve aralarındaki spread, ağ ve kontratla birlikte yatırma ve çekme durumu, hacminize göre gerçekleşmeyi hesaplamak için emir defterleri ve snapshot zamanı. Fonlama arbitrajı buna oranları, aralıkları ve ödeme zamanlarını ekler. Genesis API'de bunlar /arbitrage/*, /orderbooks/* ve /funding/* endpoint'leridir.
Genesis API üzerinden işlem açılabilir mi?
Hayır. Genesis API yalnızca veri okur ve emir vermez: işlemleri borsalarda kendiniz açarsınız.