Genesis API arbitraj endpoint'leri: CEX, DEX, zincirler arası ve hisseler
Kısaca
- Yedi endpoint sitedeki tabloların pariteleri döndürür: üç CEX veri seti her planda, hisseler Start'tan itibaren, DEX – Spot, DEX – Futures ve Cross-chain ise Pro ve Max'te.
- CEX satırı iki borsanın fiyatlarını ve en iyi tekliflerini, ağı, kontratı, yatırma ve çekim durumunu ve hacimleri taşır — gerçekten işleme alabileceğiniz pariteleri seçmek için kullanacağınız alanlar.
- Yanıttaki spread, anlık görüntü anındaki fiyat farkıdır: komisyonlar, transferler ve kayma bundan düşülmez.
Genesis API arbitraj endpoint'leri, Genesis Arbitrage tablolarındaki pariteleri döndürür: CEX spot ve vadeli piyasaları arasındaki, DEX ile CEX arasındaki, ağlar arasındaki ve tokenize hisselerdeki spreadler. Her data öğesi tek bir paritedir: nereden alınacak, nereye satılacak, spread — yüzde olarak fiyat farkı — ve bunu doğrulamak için gereken alanlar: yatırma ve çekim durumu, hacimler, likidite, bağlantılar. Yedi endpoint'in tamamı GET isteğidir ve anahtar X-API-Key başlığında gönderilir.
Yedi endpoint ve planlar
| Endpoint | Ne döndürür | Planlar |
|---|---|---|
/arbitrage/spot-spot | CEX spot piyasaları arasındaki spreadler | Trial, Start, Pro, Max |
/arbitrage/spot-futures | CEX'te spot ve vadeli karşılaştırması | Trial, Start, Pro, Max |
/arbitrage/futures-futures | CEX borsaları arasında vadeli işlemler | Trial, Start, Pro, Max |
/arbitrage/dex-spot | DEX fiyatı ve CEX spot | Pro, Max |
/arbitrage/dex-futures | DEX fiyatı ve CEX vadeli | Pro, Max |
/arbitrage/crosschain | Bir token, ağlar arasında DEX'te | Pro, Max |
/arbitrage/stocks | CEX'te tokenize hisseler, metaller, endeksler ve emtialar | Start, Pro, Max |
Planınızın dışındaki bir endpoint 403 plan_restricted döndürür; hata kodları Genesis API yanıtları ve hataları sayfasında, fiyatlar ise Genesis API fiyatları sayfasındadır.
CEX: Spot – Spot, Spot – Futures, Futures – Futures
Üç CEX endpoint'i aynı parametreleri alır ve aynı biçimde satır döndürür. market_buy ve market_sell alanları her tarafın piyasasını gösterir: spot ve spot, spot ve futures ya da futures ve futures.
| Parametre | Tür | Ne yapar | Örnek |
|---|---|---|---|
coin | string | Coin sembolüne göre filtreler | coin=BTC |
exchange | string | Borsaya göre filtreler; birden fazlası virgülle ayrılır | exchange=Binance,OKX |
min_spread | number | Minimum spread, % | min_spread=1 |
min_volume | number | Her iki tarafta minimum 24 saatlik hacim, USD | min_volume=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot" \
-d min_spread=1 -d min_volume=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/spot-futures" \
-d coin=BTC -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/futures-futures" \
-d exchange=Binance,OKX -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Spot — Spot dokümantasyonundan kısaltılmış bir yanıt satırı:
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"market_buy": "spot",
"market_sell": "spot",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"ask_buy": 0.0007029,
"bid_sell": 0.0007021,
"spread_pct": 0.11,
"network": "ETH",
"contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c",
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
"volume_24h_buy": 17652.64,
"volume_24h_sell": 12512.51,
"trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT",
…
}
| Alan | Tür | İçerik |
|---|---|---|
exchange_buy, exchange_sell | string | Alış borsası ve satış borsası |
market_buy, market_sell | string | Tarafın piyasası: spot veya futures |
price_buy, price_sell | number | Spreadin hesaplandığı fiyatlar |
bid_*, ask_* | number veya null | Her tarafta en iyi alış ve satış teklifi |
spread_pct | number | Spread, % |
network, contract | string; string veya null | Token ağı ve kontrat adresi |
deposit_enabled_*, withdraw_enabled_* | boolean | Her borsada yatırma ve çekimin açık olup olmadığı |
volume_24h_buy, volume_24h_sell | number veya null | 24 saatlik hacim, USD |
trade_url_buy, trade_url_sell | string | İşlem terminallerine bağlantılar |
spread_pct, price_buy ve price_sell değerlerinden hesaplanır — sitedeki Fiyat sütunu, yani son işlem. İşlemin kendisi emir defteri üzerinden gerçekleşir: ask_buy fiyatından alır, bid_sell fiyatından satarsınız. Örnekte bid_sell, ask_buy değerinin altındadır; yani en iyi tekliflerde parite negatiftir:
(0.0007021 − 0.0007029) / 0.0007029 × 100 ≈ −0,11%
Hacminiz için kesin fark, Order-book Δ'dan gelir — GET /orderbooks/spreads/{dataset}; ayrıntılar emir defteri endpoint'leri rehberinde.
Transfer edilebilen Spot – Spot pariteleri
Borsalar arası spot parite ancak coin taşınabiliyorsa çalışır: bir borsadan alınır, çekilir ve diğerine yatırılır. Bunun için alış borsasında çekimin (withdraw_enabled_buy) ve satış borsasında yatırmanın (deposit_enabled_sell) açık olması gerekir. İstekte bu bayraklar için parametre yoktur, bu yüzden onları kodda filtrelersiniz; min_volume ise likiditesi düşük coinleri sunucuda eler.
import os
import requests
r = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"min_spread": 1, "min_volume": 50000},
timeout=15,
)
r.raise_for_status()
rows = r.json()["data"]
# Transfer ancak alış borsasında çekim ve satış
# borsasında yatırma açıksa çalışır
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
ok.sort(key=lambda x: x["spread_pct"], reverse=True)
for x in ok[:10]:
print(f'{x["coin"]:<8} {x["exchange_buy"]} → '
f'{x["exchange_sell"]} {x["spread_pct"]}% '
f'ağ {x["network"]}')
429 ve 503 için yeniden denemeler, Genesis API yanıtları ve hataları sayfasındaki get_json fonksiyonuyla gelir. Bu pariteleri Telegram'a gönderen bir bot, Python ile kripto arbitraj botu makalesinde kurulur.
DEX – Spot ve DEX – Futures
DEX veri setleri, bir tokenın DEX yani merkeziyetsiz borsadaki fiyatını CEX'teki fiyatıyla karşılaştırır: DEX – Spot spot ile, DEX – Futures vadeli ile. Her iki endpoint de Pro ve Max planlarındadır.
| Parametre | Tür | Ne yapar | Örnek |
|---|---|---|---|
coin | string | Coin sembolüne göre filtreler | coin=SCR |
exchange | string | CEX borsası; birden fazlası virgülle ayrılır | exchange=MEXC |
min_spread | number | Minimum spread, % | min_spread=2 |
min_liquidity | number | Minimum likidite, USD | min_liquidity=50000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
-d min_spread=2 -d min_liquidity=50000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-futures" \
-d min_spread=1 -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Dokümantasyondan kısaltılmış bir DEX – Spot satırı:
{
"coin": "SCR",
"exchange": "MEXC",
"cex_price": 0.02691,
"dex_price": 0.02679,
"spread_pct": 0.45,
"network": "SCROLL",
"liquidity_usd": 10544.15,
"market_cap": 5091835.0,
"deposit_enabled": true,
"withdraw_enabled": true,
"dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
"dextools_url": null,
"gmgn_url": null,
…
}
MEXC fiyatı havuz fiyatının üzerinde olduğu için spread pozitiftir. spread_pct işareti yönü belirler: artı, tokenın DEX'te daha ucuz olduğu anlamına gelir; orada alır, CEX'te satarsınız; eksi ise tersidir.
| Alan | Tür | İçerik |
|---|---|---|
exchange | string | CEX borsası |
cex_price, dex_price | number | CEX'teki ve DEX'teki fiyat |
liquidity_usd | number | Havuz likiditesi, USD |
market_cap, dex_volume_24h | number veya null | Piyasa değeri ve 24 saatlik DEX hacmi (DEX – Spot) |
ticker, max_position_usd | string; number veya null | Borsa paritesi ve maksimum pozisyon, USD (DEX – Futures) |
deposit_enabled, withdraw_enabled | boolean | CEX'te yatırma ve çekimin açık olup olmadığı |
dexscreener_url, dextools_url, gmgn_url | string veya null | DexScreener, DEXTools ve GMGN bağlantıları |
Örnekteki havuzda 10.544 $ likidite var, bu yüzden büyük bir alım fiyatını oynatır. 100 $ ile 100.000 $ arasındaki tutarlar için kayma, token vergileri ve kontrat başına honeypot işareti, Pro ve Max planlarında GET /orderbooks/dex-slippage ile gelir.
Cross-chain: bir token, birden fazla ağ
GET /arbitrage/crosschain, bir tokenın DEX fiyatını blokzincirler arasında karşılaştırır ve Pro ile Max planlarındadır. Satır coin, spread_pct ve aynı alanlara sahip iki nesne içerir: tokenın daha ucuz olduğu taraf buy ve daha pahalı olduğu taraf sell. Token, ağlar arasında zincirler arası köprü ile taşınır.
| Parametre | Tür | Ne yapar | Örnek |
|---|---|---|---|
coin | string | Token sembolüne göre filtreler | coin=WLD |
chain | string | Ağa göre filtreler | chain=ethereum |
min_spread | number | Minimum spread, % | min_spread=1 |
min_liquidity | number | Minimum likidite, USD | min_liquidity=20000 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/crosschain" \
-d coin=WLD -d min_liquidity=20000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Cross-chain dokümantasyonundan kısaltılmış bir satır:
{
"coin": "WLD",
"spread_pct": 0.59,
"buy": {
"chain": "optimism",
"pair": "WLD/USDC",
"price_usd": 0.4048,
"liquidity_usd": 48747,
"volume_24h_usd": 2484,
"pool_created_at": "2023-07-24 08:44:19 UTC",
…
},
"sell": {
"chain": "ethereum",
"pair": "WLD/WETH",
"price_usd": 0.4072,
"liquidity_usd": 421426,
…
}
}
| Alan | Tür | İçerik |
|---|---|---|
buy.chain | string | Tarafın ağı |
buy.pair | string | WLD/USDC gibi DEX paritesi |
buy.contract | string | O ağdaki kontrat adresi |
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usd | number | Fiyat, havuz likiditesi ve 24 saatlik hacim, USD |
buy.pool_created_at | string veya null | Havuzun oluşturulma tarihi |
buy.dexscreener_url, dextools_url, gmgn_url | string veya null | DexScreener, DEXTools ve GMGN bağlantıları |
sell aynı alanlara sahiptir. pool_created_at, API'deki çoğu zaman damgasının aksine unix saniyesi değil, UTC tarih dizesidir ve null olabilir. Birkaç gün önce oluşturulmuş bir havuz, iki taraftaki kontratları kontrol etmek için bir nedendir: yeni bir ağda aynı sembolün arkasında farklı bir token olabilir.
Hisse arbitrajı: hisseler, metaller, endeksler, emtialar
GET /arbitrage/stocks, CEX borsaları arasında tokenize hisseler, metaller, endeksler ve emtialardaki spreadleri döndürür ve Start planından itibaren kullanılabilir.
| Parametre | Tür | Ne yapar | Örnek |
|---|---|---|---|
symbol | string | Enstrüman sembolüne göre filtreler | symbol=BRENT |
category | string | Kategori: Stock, Metal, Index veya Commodity | category=Commodity |
exchange | string | Borsaya göre filtreler; birden fazlası virgülle ayrılır | exchange=MEXC |
min_spread | number | Minimum spread, % | min_spread=0.3 |
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/stocks" \
-d category=Commodity -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Hisse arbitrajı dokümantasyonundan kısaltılmış bir satır:
{
"symbol": "BRENT",
"category": "Commodity",
"exchange_buy": "MEXC",
"exchange_sell": "Ourbit",
"symbol_on_buy": "UKOIL",
"symbol_on_sell": "BRENTOIL",
"price_buy": 76.68,
"price_sell": 76.82,
"spread_pct": 0.18,
…
}
symbol enstrümanın genel sembolüdür; symbol_on_buy ve symbol_on_sell ise her borsadaki adlarıdır: örnekte Brent petrol, MEXC'te UKOIL, Ourbit'te BRENTOIL olarak işlem görür. Enstrümanı borsada symbol_on_* ile arayın. Satırda ağ, kontrat veya yatırma alanları yoktur: CEX'te bu enstrümanlar süresiz vadeli işlemler olarak işlem görür ve parite Long ve Short pozisyonlarla açılır (tablo rehberi).
API yanıtları ve site tabloları
Site tablolarındaki sütunlar rehberlerde açıklanmıştır:
| Endpoint | Site tablosu ve rehberi |
|---|---|
/arbitrage/spot-spot | Spot – Spot |
/arbitrage/spot-futures | Spot – Futures |
/arbitrage/futures-futures | Futures Arbitrage |
/arbitrage/dex-spot | DEX – Spot |
/arbitrage/dex-futures | DEX – Futures |
/arbitrage/crosschain | Crosschain |
/arbitrage/stocks | Stock Arbitrage |
Parite izleyicisi nasıl kurulur
Planınıza uygun endpoint'i seçin
Yukarıdaki planlar tablosuna bakın: DEX veri setleri ve Cross-chain yalnızca Pro ve Max'te.
Kümeyi sunucuda daraltın
min_spreaddeğerini komisyonlarınızın toplamının üzerine,min_volumeveyamin_liquiditydeğerini ise likiditesi düşük coinleri elemek için ayarlayın.İşleme alınabilir satırları kodda tutun
Spot – Spot —
withdraw_enabled_buyvedeposit_enabled_sell. Pozitif spreadli DEX – Spot —deposit_enabled, negatif spreadli —withdraw_enabled. Hisseler —symbol_on_buyvesymbol_on_sellile arayın.Tokenı ve emir defterini kontrol edin
contractvenetworkdeğerlerini karşılaştırın, hacminiz için gerçekleşmeyi emir defteri endpoint'leriyle hesaplayın.Planınızın hızında sorgulayın
meta.freshness_secdeğerinden daha sık değil. Bot uyarı gönderir, işlemi borsada kendiniz açarsınız.
Sorular ve cevaplar
Bu endpoint'ler işlem açabilir mi?
Hayır. Genesis API yalnızca veri sunar ve emir vermez. Genesis API üzerindeki bir bot pariteyi bulur ve size uyarı gönderir, işlemi borsada kendiniz açarsınız.
Satırlarda neden Book veya Ord. sütunları yok?
İkisi de emir defterlerinden hesaplanır ve ayrı gelir: Order-book Δ GET /orderbooks/spreads/{dataset} ile, bir piyasanın emir defteri GET /orderbooks/book ile; ikisi de Pro ve Max planlarında.
DEX ve Cross-chain için hangi plan gerekir?
Pro veya Max. Trial üç CEX veri setini kapsar, Start hisse arbitrajını ekler.