Genesis Arbitrage

Genesis Arbitrage · · 12 dk okuma

Genesis API emir defteri endpoint'leri: gerçekleşme fiyatı, Emir defteri Δ, defter, geçmiş ve DEX

Kısaca

  • API Pro ve Max planlarındaki altı emir defteri endpoint'i, sitenin "Emir defteri Δ" sütununda, "Emir defteri" penceresinde ve Genesis Charts'ta gösterdiği verilerin aynısını döndürür.
  • Gerçekleşme fiyatı, $500, $1.000, $2.500, $5.000 veya $10.000 tutarındaki bir piyasa işleminin ortalama fiyatıdır; null, defterin bu hacim için çok ince olduğu anlamına gelir.
  • Defterler borsanın 5–20 saniye gerisindedir: age_sec ve stale alanlarına bakın, işlemden önce de defteri borsa terminalinde kontrol edin.

Genesis API'deki emir defteri API'si, belirli bir işlem tutarında spread'in ne kadarının kaldığını gösteren altı endpoint'ten oluşur. Bir hacim için gerçekleşme fiyatlarını, arbitraj satırları için Emir defteri Δ'yı, derinliğiyle birlikte emir defterini, slippage geçmişini ve DEX slippage'ını döndürür — sitedeki "Emir defteri Δ" sütunuyla ve Genesis Charts ile aynı veriler.

Altı emir defteri endpoint'i

EndpointNe döndürürZorunluDokümantasyon
/orderbooks/execHer piyasada bir hacim için alış ve satış fiyatlarıvolumeGerçekleşme fiyatları
/orderbooks/spreads/{dataset}Arbitraj veri setinde tek bir coin'in satırları için Emir defteri ΔcoinEmir defteri Δ
/orderbooks/bookTek bir piyasanın defteri: 10 seviye, duvarlar, derinlik, yaşexchange, market, coinPiyasa emir defteri
/orderbooks/coin/{coin}Bir coin'in tüm borsalardaki ve piyasalardaki defterleriyolda coinCoin emir defterleri
/orderbooks/exec-historySlippage geçmişi, istek başına en fazla 8 piyasakeys, intervalGerçekleşme geçmişi
/orderbooks/dex-slippageSözleşme başına slippage, vergiler ve honeypot bayrağı—DEX slippage

Altısı da API planları Pro (ayda $100) ve Max'e ($200) dahildir; Trial ve Start'ta 403 plan_restricted döndürürler. /orderbooks/exec içinde ve geçmişteki keys parametresinde piyasa Exchange|market|COIN biçiminde yazılır, örneğin Binance|spot|BTC. Aşağıdaki yanıt örnekleri kısaltılmış data alanını gösterir.

Emir defteri verilerine genel bakış için emir defteri API'si makalesine bakın.

Bir hacim için gerçekleşme fiyatı

Gerçekleşme fiyatı, belirli büyüklükteki bir piyasa emrinin defteri taradığı ortalama fiyattır: alış ask'ları, satış bid'leri tüketir; yani işlemin yediği emirlerin VWAP'ıdır. /orderbooks/exec bunu ızgaradaki tek bir hacim için tüm piyasalarda döndürür.

ParametreTürNe yapar
volumesayıUSD cinsinden hacim: 500, 1000, 2500, 5000 veya 10000, zorunlu
exchangemetinBorsaya göre filtre; birden fazlası için virgülle ayırın
marketmetinspot veya futures
coinmetinCoin ticker'ı, örn. BTC
curl "https://api.genesisarbitrage.com/v1/orderbooks/exec?volume=1000" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "volume": 1000,
  "markets": {
    "Binance|spot|BTC": [96021.5, 96010.2],
    "ByBit|futures|BTC": [96030.1, 96018.7],
    "Ourbit|spot|SHELL": [0.10418, null],
    …
  }
}

Her piyasa anahtarının değeri [alış fiyatı, satış fiyatı] biçimindedir. Fiyat yerine null, defterin bu hacim için çok ince olduğunu gösterir: örnekte Ourbit'teki SHELL bid'leri $1.000'lık satışı karşılayamıyor. Filtre olmadan yanıt tüm piyasaları içerir; tek bir coin gerekiyorsa coin geçin.

Emir defteri Δ: defteri taradıktan sonraki spread

Emir defteri Δ, bir arbitraj satırının spread'inin belirli bir hacim için emir defterlerinden yeniden hesaplanmış halidir. /orderbooks/spreads/{dataset}, seçilen veri setinde tek bir coin'in tüm satırlarını alır ve her birine bir order_delta nesnesi ekler; formüller sitedeki sütunla aynıdır.

ParametreTürNe yapar
{dataset}metin, yoldaspot-spot, spot-futures, futures-futures, dex-spot veya dex-futures
coinmetinCoin ticker'ı, zorunlu
volumesayıVarsayılan 0 — defterin en iyi fiyatları; ya da 500, 1000, 2500, 5000, 10000

CEX çiftlerinde alış, exchange_buy borsasının ask'larından, satış ise exchange_sell borsasının bid'lerine yapılır. order_delta içinde buy_price ve sell_price bulunur; sonuç hiçbir zaman satırın spread_pct değerini aşmaz.

DEX satırlarında CEX tarafını spread'in işareti belirler: spread_pct ≥ 0 ise token CEX bid'lerine satılır, spread negatifse ask'lardan alınır. order_delta içinde side ve CEX gerçekleşme fiyatı olan cex_price bulunur; defteri taradıktan sonra işaret tersine dönerse Δ 0 olur.

status alanı: ok — hesaplandı, no_book — defter yok, exhausted — defter hacmi doldurmadı.

Varsayımsal bir örnek: XYZ coin'i, MEXC'te 2,000'den alış, Gate'te 2,016'dan satış, satır spread'i %0,8. $5.000 için Emir defteri Δ isteği:

curl -G \
  "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-spot" \
  -d coin=XYZ -d volume=5000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "XYZ",
  "exchange_buy": "MEXC",
  "exchange_sell": "Gate",
  "market_buy": "spot",
  "market_sell": "spot",
  "price_buy": 2.0,
  "price_sell": 2.016,
  "ask_buy": 2.001,
  "bid_sell": 2.015,
  "spread_pct": 0.8,
  "order_delta": {
    "volume": 5000,
    "buy_price": 2.004,
    "sell_price": 2.01,
    "spread_pct": 0.2994,
    "status": "ok"
  }
}

Satırın diğer alanları /arbitrage/spot-spot ile aynıdır. Satır spread'i: (2,016 − 2,000) / 2,000 × 100 = %0,8.

$5.000 için MEXC defteri üzerinden alış ortalama 2,004'e geliyor, Gate defterine satış 2,010 getiriyor: (2,010 − 2,004) / 2,004 × 100 ≈ %0,2994. %0,8'in yaklaşık %0,3'ü bu büyüklükte kalıyor — komisyonlar ve transferden önce kabaca $15: 5.000 × 0,002994 ≈ 14,97.

Python örneği: defterden önce ve sonra spread

Betik, Spot – Spot veri setindeki BTC için $5.000 hacminde satır spread'ini defterden sonraki spread'in yanında yazdırır. Anahtar GENESIS_API_KEY ortam değişkeninden gelir; 429 ve 503 durumunda betik Retry-After saniye bekler.

import os
import time
import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}


def get(path, params):
    for _ in range(3):
        r = requests.get(BASE + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):
            # rate limit or data being rebuilt
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API is busy, try again later")


rows = get("/orderbooks/spreads/spot-spot",
           {"coin": "BTC", "volume": 5000})
for row in rows:
    od = row["order_delta"]
    if od["status"] == "ok":
        after = f'{od["spread_pct"]:.4f}%'
    else:
        after = od["status"]  # no_book or exhausted
    print(f'{row["exchange_buy"]} → {row["exchange_sell"]}: '
          f'{row["spread_pct"]}% → {after}')

Bir döngüde, meta.freshness_sec saniyede birden sık sorgulamayın: Pro'da 10 sn, Max'te 5 sn. Kota ve limitler Genesis API limitleri rehberinde anlatılıyor.

Piyasa emir defteri ve coin emir defterleri

/orderbooks/book, sitedeki "Emir defteri" penceresi gibi tek bir piyasanın defterini döndürür. Üç zorunlu parametre piyasayı belirler: exchange (büyük/küçük harf duyarsız), market (spot veya futures) ve coin. /orderbooks/coin/{coin}, coin'in tüm borsalardaki ve piyasalardaki aynı nesnelerinden oluşan bir dizi döndürür.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/book" \
  -d exchange=Binance -d market=spot -d coin=BTC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "exchange": "Binance",
  "market": "spot",
  "coin": "BTC",
  "book_ts": 1794675858,
  "age_sec": 6,
  "stale": false,
  "source": "ws",
  "depth_limited": false,
  "levels_bid": 500,
  "levels_ask": 500,
  "best_bid": 96015.9,
  "best_ask": 96016,
  "bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
  "asks": [[96016, 388120.2], [96016.1, 20410.7], …],
  "walls_bid": [[95900, 2410000]],
  "walls_ask": [[96500, 1980000]],
  "depth_bid_usd": 61234567,
  "depth_ask_usd": 58765432
}
AlanAnlamı
best_bid, best_askEn iyi bid ve ask
bids, asksİlk 10 seviye: [fiyat, USD tutarı]
walls_bid, walls_askEn büyük duvarlar: [fiyat, USD tutarı]
depth_bid_usd, depth_ask_usdEn iyi fiyatın ±%50'si içinde tarafın derinliği, USD
book_ts, age_sec, staleDefterin zamanı ve saniye cinsinden yaşı; stale — 30 sn'den eski
source, depth_limitedDefter kaynağı (ws veya rest) ve sınırlı derinlik bayrağı

depth_bid_usd ve depth_ask_usd içindeki piyasa derinliği, defterin bir tarafında kaç dolarlık emir durduğudur: örnekte Binance'teki BTC için en iyi ask'ın +%50'si içinde yaklaşık $58,8 milyon ask var.

depth_limited: true iken borsa defterin yalnızca bir kısmını yayınlıyordur ve büyük bir hacim dolmayabilir. O borsa, piyasa ve coin için defter yoksa 404 alırsınız.

Gerçekleşme geçmişi

/orderbooks/exec-history, Genesis Charts'taki slippage geçmişidir: ızgaradaki her hacimde gerçekleşmenin defter orta fiyatından kaç baz puan uzak olduğu (1 bp = %0,01). Bir istek, keys içinde virgülle ayrılmış en fazla 8 piyasa alır; interval zorunludur.

intervalNokta adımı360 nokta kapsar
1m1 dakika6 saat
15m15 dakika3,75 gün
1h1 saat15 gün
1d1 günyaklaşık bir yıl

Veriler 6 Eylül 2026'dan beri toplanıyor; bu nedenle günlük seri yalnızca o tarihten itibaren dolu.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/exec-history" \
  --data-urlencode "keys=Binance|spot|BTC,ByBit|futures|BTC" \
  -d interval=1h \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "interval": "1h",
  "step_sec": 3600,
  "points": 360,
  "volumes_usd": [500, 1000, 2500, 5000, 10000],
  "last_bucket_ts": 1794672000,
  "series": {
    "Binance|spot|BTC": {
      "buy": [[1, 1, 2, …], [1, 2, 2, …], [2, 3, 4, …],
              [3, 4, 6, …], [5, 7, 9, …]],
      "sell": [[-1, -1, -2, …], …]
    },
    "ByBit|futures|BTC": { … }
  }
}

buy ve sell içinde beşer seri vardır, volumes_usd içindeki her hacim için bir tane; her birinde en eskiden en yeniye 360 değer bulunur. Son nokta last_bucket_ts zamanına aittir; i numaralı nokta ise last_bucket_ts − (points − 1 − i) × step_sec zamanına. Alış değerleri pozitif, satış değerleri negatiftir: ortalama işlem fiyatı defter orta fiyatının üstünde ve altındadır.

[5, 7, 9, …] serisi $10.000'lık bir alıştır: ilk noktalarında maliyeti 5–9 bp, yani orta fiyatın %0,05–0,09 üstündedir. Bir serideki null, veri olmadığı veya defterin dolmadığı anlamına gelir; piyasa nesnesi yerine null ise bilinmeyen anahtar demektir.

DEX slippage

/orderbooks/dex-slippage, bir kurulumun DEX bacağını anlatır: $100'dan $100.000'a kadar alış ve satış slippage'ı, token vergileri ve sözleşme başına honeypot bayrağı — sitedeki DEX tablosunun sütunlarıyla aynı. Filtreler: contract (birden fazlası için virgülle ayırın) ve network.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/dex-slippage" \
  -d contract=0x6982508145454ce325ddbe47a25d4ec3d2311933 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000,
                100000],
  "contracts": [
    {
      "contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "network": "ETH",
      "tax_buy_pct": 0,
      "tax_sell_pct": 0,
      "honeypot": "no",
      "slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86,
                           1.41, 3.12, 6.05],
      "slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9,
                            1.5, 3.3, 6.4],
      "updated_at": 1794671040
    }
  ]
}

Slippage dizileri sizes_usd ızgarasını izler: örnekte $5.000'lık bir alış %0,58, $100.000'lık bir alış %6,05 kayar. Dizideki null, havuzun o büyüklük için likiditesinin olmadığı anlamına gelir.

tax_buy_pct ve tax_sell_pct, token'ın alış ve satış vergisidir, %; null kaynak olmadığını gösterir, %0 anlamına gelmez. honeypot: no; suspect — kaynaklar çelişiyor; yes — satış imkânsız olabilir.

Bir kurulum defterlere karşı nasıl kontrol edilir

  1. Bir arbitraj satırı alın

    /arbitrage/spot-spot veya başka bir veri setinde bir kurulum bulun — bkz. Arbitraj endpoint'leri. Coin'i, borsaları ve spread_pct değerini not edin.

  2. Spread'i defterlerden yeniden hesaplayın

    O coin ve işlem büyüklüğünüzle /orderbooks/spreads/spot-spot isteği yapın, spread_pct ile order_delta.spread_pct değerlerini karşılaştırın.

  3. Tazeliği ve derinliği kontrol edin

    İki bacak için /orderbooks/book çağırın: age_sec, stale ve depth_limited sayılara güvenip güvenmeyeceğinizi söyler, duvarlar ise fiyatın nerede takılabileceğini gösterir.

  4. Geçmişle karşılaştırın

    /orderbooks/exec-history, bu slippage'ın piyasa için normal olup olmadığını gösterir: 1m 6 saati, 1h 15 günü kapsar.

  5. DEX bacağında vergileri kontrol edin

    DEX – Spot ve DEX – Futures kurulumları için satırın sözleşmesi üzerinden /orderbooks/dex-slippage isteği yapın: slippage, vergiler ve honeypot.

Sorular ve cevaplar

Emir defteri Δ, normal spread'den nasıl farklıdır?

Satırın spread_pct değeri borsaların son fiyatlarını kullanır; Emir defteri Δ ise verilen hacimdeki piyasa işlemlerinin ortalama fiyatlarını. Aradaki fark, defterin aldığı paydır.

Neden fiyat yerine null alıyorum?

/orderbooks/exec içinde defterde o hacim için yeterli emir yoktur; Emir defteri Δ'da aynı durum exhausted statüsüdür. Gerçekleşme geçmişinde null o nokta için veri olmadığı, DEX slippage'ında ise havuzda likidite olmadığı anlamına gelir.

$10.000'ın üzerinde gerçekleşmeyi hesaplayabilir miyim?

/orderbooks/exec ve Emir defteri Δ ızgarası $500 ile $10.000 arasında sabittir. Daha büyük tutarlar için /orderbooks/book içindeki derinliğe ve duvarlara bakın; DEX bacağında /orderbooks/dex-slippage $100.000'a kadar çıkar.