Genesis Arbitrage

Genesis Arbitrage · · 12 dk okuma

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

EndpointNe döndürürPlanlar
/arbitrage/spot-spotCEX spot piyasaları arasındaki spreadlerTrial, Start, Pro, Max
/arbitrage/spot-futuresCEX'te spot ve vadeli karşılaştırmasıTrial, Start, Pro, Max
/arbitrage/futures-futuresCEX borsaları arasında vadeli işlemlerTrial, Start, Pro, Max
/arbitrage/dex-spotDEX fiyatı ve CEX spotPro, Max
/arbitrage/dex-futuresDEX fiyatı ve CEX vadeliPro, Max
/arbitrage/crosschainBir token, ağlar arasında DEX'tePro, Max
/arbitrage/stocksCEX'te tokenize hisseler, metaller, endeksler ve emtialarStart, 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.

ParametreTürNe yaparÖrnek
coinstringCoin sembolüne göre filtrelercoin=BTC
exchangestringBorsaya göre filtreler; birden fazlası virgülle ayrılırexchange=Binance,OKX
min_spreadnumberMinimum spread, %min_spread=1
min_volumenumberHer iki tarafta minimum 24 saatlik hacim, USDmin_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",
  …
}
AlanTürİçerik
exchange_buy, exchange_sellstringAlış borsası ve satış borsası
market_buy, market_sellstringTarafın piyasası: spot veya futures
price_buy, price_sellnumberSpreadin hesaplandığı fiyatlar
bid_*, ask_*number veya nullHer tarafta en iyi alış ve satış teklifi
spread_pctnumberSpread, %
network, contractstring; string veya nullToken ağı ve kontrat adresi
deposit_enabled_*, withdraw_enabled_*booleanHer borsada yatırma ve çekimin açık olup olmadığı
volume_24h_buy, volume_24h_sellnumber veya null24 saatlik hacim, USD
trade_url_buy, trade_url_sellstringİş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.

ParametreTürNe yaparÖrnek
coinstringCoin sembolüne göre filtrelercoin=SCR
exchangestringCEX borsası; birden fazlası virgülle ayrılırexchange=MEXC
min_spreadnumberMinimum spread, %min_spread=2
min_liquiditynumberMinimum likidite, USDmin_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.

AlanTürİçerik
exchangestringCEX borsası
cex_price, dex_pricenumberCEX'teki ve DEX'teki fiyat
liquidity_usdnumberHavuz likiditesi, USD
market_cap, dex_volume_24hnumber veya nullPiyasa değeri ve 24 saatlik DEX hacmi (DEX – Spot)
ticker, max_position_usdstring; number veya nullBorsa paritesi ve maksimum pozisyon, USD (DEX – Futures)
deposit_enabled, withdraw_enabledbooleanCEX'te yatırma ve çekimin açık olup olmadığı
dexscreener_url, dextools_url, gmgn_urlstring veya nullDexScreener, 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.

ParametreTürNe yaparÖrnek
coinstringToken sembolüne göre filtrelercoin=WLD
chainstringAğa göre filtrelerchain=ethereum
min_spreadnumberMinimum spread, %min_spread=1
min_liquiditynumberMinimum likidite, USDmin_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,
    …
  }
}
AlanTürİçerik
buy.chainstringTarafın ağı
buy.pairstringWLD/USDC gibi DEX paritesi
buy.contractstringO ağdaki kontrat adresi
buy.price_usd, buy.liquidity_usd, buy.volume_24h_usdnumberFiyat, havuz likiditesi ve 24 saatlik hacim, USD
buy.pool_created_atstring veya nullHavuzun oluşturulma tarihi
buy.dexscreener_url, dextools_url, gmgn_urlstring veya nullDexScreener, 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.

ParametreTürNe yaparÖrnek
symbolstringEnstrüman sembolüne göre filtrelersymbol=BRENT
categorystringKategori: Stock, Metal, Index veya Commoditycategory=Commodity
exchangestringBorsaya göre filtreler; birden fazlası virgülle ayrılırexchange=MEXC
min_spreadnumberMinimum 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:

EndpointSite tablosu ve rehberi
/arbitrage/spot-spotSpot – Spot
/arbitrage/spot-futuresSpot – Futures
/arbitrage/futures-futuresFutures Arbitrage
/arbitrage/dex-spotDEX – Spot
/arbitrage/dex-futuresDEX – Futures
/arbitrage/crosschainCrosschain
/arbitrage/stocksStock Arbitrage

Parite izleyicisi nasıl kurulur

  1. 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.

  2. Kümeyi sunucuda daraltın

    min_spread değerini komisyonlarınızın toplamının üzerine, min_volume veya min_liquidity değerini ise likiditesi düşük coinleri elemek için ayarlayın.

  3. İşleme alınabilir satırları kodda tutun

    Spot – Spot — withdraw_enabled_buy ve deposit_enabled_sell. Pozitif spreadli DEX – Spot — deposit_enabled, negatif spreadli — withdraw_enabled. Hisseler — symbol_on_buy ve symbol_on_sell ile arayın.

  4. Tokenı ve emir defterini kontrol edin

    contract ve network değerlerini karşılaştırın, hacminiz için gerçekleşmeyi emir defteri endpoint'leriyle hesaplayın.

  5. Planınızın hızında sorgulayın

    meta.freshness_sec değ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.