Genesis Arbitrage

Genesis Arbitrage · · 15 dk okuma

Kripto emir defteri API: borsalar arasında derinlik, gerçekleşme fiyatı ve slipaj

Kısaca

  • Emir defteri API'si, bid ve ask seviyelerini (her seviyedeki fiyat ve büyüklük) REST anlık görüntüsü veya değişikliklerin WebSocket akışı olarak döndürür. En iyi bid ve ask, işlemin yalnızca ilk dolarlarını anlatır.
  • Derinlik, büyük bir emrin fiyatını belirler. Varsayımsal bir örnekte 10.000 $'lık alış beş seviyeyi tüketir, ortalama fiyatı defterin orta fiyatının 25 baz puan üzerine çıkar ve borsalar arası spread %1,20'den %0,70'e düşer.
  • Pro ve Max planlarında Genesis API, 500–10.000 $ için hazır gerçekleşme fiyatlarını, arbitraj satırları için Emir defteri Δ'yı, defter yaşı ve derinliğini, slipaj geçmişini ve DEX slipaj merdivenini döndürür. Yalnızca REST; defterler borsanın 5–20 saniye gerisindedir.

Kripto emir defteri API'si, bir işlem çifti için güncel alış ve satış emirlerini fiyat seviyelerine göre gruplanmış halde döndürür: her seviye bir fiyat ve o fiyatta bekleyen büyüklüğü taşır. Bu seviyelerden belirli büyüklükteki bir emrin gerçekleşme fiyatını, slipajını ve piyasa derinliğini hesaplarsınız; iki borsanın defterinden de gerçek bir işlemde spread'in ne kadarının ayakta kaldığını.

Borsa kendi defterini REST anlık görüntüsü veya WebSocket akışı olarak sunar; Pro ve Max planlarındaki Genesis API ise birçok borsa için hazır gerçekleşme fiyatlarını, derinliği ve Emir defteri Δ'yı tek seferde verir.

Emir defteri API'si ne döndürür

Emir defteri, tek bir çift için bekleyen limit emirlerin listesidir. Alış emirleri (bid) en yüksek fiyattan aşağı, satış emirleri (ask) en düşük fiyattan yukarı doğru sıralanır. Seviye, bir fiyat ve o fiyattaki toplam büyüklüktür; en iyi ask ile en iyi bid arasındaki fark defterin spread'idir.

REST anlık görüntüsü, tek bir isteğin yanıtıdır: o andaki seviyeler. Binance emir defteri endpoint'i herkese açıktır ve API anahtarı gerektirmez; aşağıda BTC/USDT'nin ilk beş seviyesi için bir istek ve yanıt var (sayılar varsayımsaldır):

curl "https://api.binance.com/api/v3/depth?symbol=BTCUSDT&limit=5"
{
  "lastUpdateId": 81273645120,
  "bids": [["96015.90000000", "1.25000000"], …],
  "asks": [["96016.00000000", "0.84100000"], …]
}

Her seviye, miktarı coin cinsinden olan [fiyat, miktar] biçiminde bir dize çiftiyle gelir: en iyi bid 1,25 × 96.015,9 = 120.019,88 $ değerindedir. limit parametresi varsayılan olarak 100'dür ve taraf başına 5.000 seviyeye kadar çıkar (Binance dokümantasyonu).

WebSocket akışını borsa, kalıcı bir bağlantı üzerinden kendisi gönderir. Binance'te iki tür defter akışı vardır: btcusdt@depth5, btcusdt@depth10 ve btcusdt@depth20 ilk 5, 10 veya 20 seviyeyi gönderir, btcusdt@depth ise yalnızca değişiklikleri. İkisi de 1000 ms'de bir ya da @100ms soneki ile 100 ms'de bir güncellenir (Binance WebSocket akışları).

Tam yerel defter, anlık görüntü ile fark akışından kurulur; anlık görüntünün lastUpdateId değeri olayların güncelleme kimlikleriyle eşleştirilir. Bir olay kaçırılırsa defter baştan kurulur.

YöntemNe elde edersinizNe için kullanılır
REST anlık görüntüsüİstek anındaki seviyeler, Binance'te taraf başına 5.000'e kadarTek seferlik kontroller, seyrek sorgulama
WebSocket akışıİlk seviyeler veya değişiklikler, her 100–1000 msBellekte yerel defter, işlem botu
REST üzerinden Genesis API[fiyat, USD tutarı] biçiminde seviyeler, gerçekleşme fiyatı, derinlik ve defter yaşıBorsaları karşılaştırmak, kurulumu kontrol etmek

En iyi bid ve ask büyük işlemlerde neden yanıltır

En iyi ask yalnızca ilk seviyenin fiyatıdır. Bu seviyeden büyük bir piyasa alışı sonraki, daha pahalı seviyeleri de alır ve ortalama gerçekleşme fiyatı yükselir; buna slipaj denir.

Varsayımsal bir örnek: A borsasında ABC tokeni, en iyi bid 0,9996, en iyi ask 1,0004, defterin orta fiyatı 1,0000. 10.000 $'lık bir piyasa alışı beş ask seviyesini tüketir:

Ask fiyatıDefterde, $Alınan, $Coin
1,00041.1001.1001.099,56
1,00101.4001.4001.398,60
1,00182.6002.6002.595,33
1,00303.0003.0002.991,03
1,00506.0001.9001.890,55

Emir toplamda 9.975,07 coin alır. Ortalama gerçekleşme fiyatı, hacim ağırlıklı ortalama fiyat olan VWAP'tir: 10.000 / 9.975,07 ≈ 1,0025.

En iyi ask'a göre slipaj: (1,0025 − 1,0004) / 1,0004 × 100 ≈ %0,21. Defterin orta fiyatına göre: (1,0025 − 1,0000) / 1,0000 × 10.000 = 25 baz puan. Bunun dördü defter spread'inin yarısıdır ve her piyasa alışı onu öder; kalan 21'i derinlikten gelir.

±X% içindeki piyasa derinliği ve duvarlar

Piyasa derinliği, en iyi fiyattan belirli bir uzaklık içindeki emirlerin toplam büyüklüğüdür. Örnekte, en iyi ask'ın +%0,2'sine kadar, yani 1,0024'e kadar olan ask'lar 1.100 + 1.400 + 2.600 = 5.100 $ eder; +%0,5'e, yani 1,0054'e kadar ise 14.100 $.

Derinliği kapasite olarak okuyun: +%0,2 içindeki derinlikten büyük bir emir, bu sınırın ötesindeki seviyelerde dolacaktır. A borsasında 5.000 $'lık alış bu sınırın içine sığar, 10.000 $'lık alış sığmaz.

Duvar, tek bir seviyedeki, komşularından belirgin biçimde büyük emirdir: örnekte 1,0050'deki 6.000 $. Duvar durduğu sürece fiyatı tutar, ama emriniz ona ulaşmadan bir saniye önce geri çekilebilir; alış o zaman arkasındaki seviyelerde dolar.

Genesis API'de derinlik, tek bir piyasanın defteri olan /orderbooks/book ve bir coin'in tüm borsalardaki ve piyasalardaki defterlerini tek seferde veren /orderbooks/coin/{coin} üzerinden gelir (Piyasa emir defteri, Coin emir defterleri). Yanıt, [fiyat, USD tutarı] biçiminde ilk 10 bids ve asks seviyesini, en büyük duvarları walls_bid ve walls_ask içinde, tarafın en iyi fiyattan ±%50 içindeki tüm derinliğini ise depth_bid_usd ve depth_ask_usd içinde taşır. ±%50 koridoru geniştir; belirli bir büyüklük için seviyelere veya hazır gerçekleşme fiyatına bakın.

Defter yaşı: eski defterler ve sınırlı derinlik

Her defter anlık görüntüsünün bir yaşı vardır. Bir borsanın defteri diğerinden 15 saniye eskiyse aralarındaki spread'in bir kısmı zamanlama farkı olabilir: eski defterdeki fiyat çoktan hareket etmiştir.

Genesis API'de defterler borsanın 5–20 saniye gerisindedir ve her biri kendi yaşını taşır. Dokümantasyondan /orderbooks/book yanıtının başı:

{
  "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,
  …
}

book_ts defterin Unix saniyesi cinsinden zamanı, age_sec saniye cinsinden yaşıdır; stale: true 30 saniyeden eski bir defteri işaretler. source, defterin borsadan nasıl alındığını gösterir: WebSocket (ws) veya REST istekleriyle (rest).

depth_limited: true, borsanın sınırlı derinlik yayınladığı anlamına gelir: toplamlar kısmidir ve büyük bir emir dolmayabilir. Emirler tükendiğinde /orderbooks/exec fiyat yerine null, Emir defteri Δ ise exhausted durumunu döndürür.

Borsalar arası gerçekleştirilebilir spread: Emir defteri Δ

Varsayımsal örneğe dönelim. B borsasında son işlem 1,0120'de gerçekleşti, en iyi bid 1,0116, ask 1,0124. B'nin bid'lerinde 1,0116'da 1.100 $, 1,0110'da 1.300 $, 1,0102'de 2.800 $, 1,0090'da 2.900 $ ve 1,0070'te 5.000 $ var.

10.000 $'ı bu bid'lere satmak, aynı formülle 1,0095 VWAP'ı verir. Bu, B'nin defter orta fiyatının (1,0120 − 1,0095) / 1,0120 × 10.000 ≈ 24,7 baz puan altıdır.

Spread nasıl hesaplanırA'dan al → B'de satSpread
Son işlemler, tablo satırındaki gibi1,0000 → 1,0120%1,20
Defterin en iyi fiyatları1,0004 → 1,0116%1,12
10.000 $ gerçekleştikten sonra1,0025 → 1,0095%0,70

Satır spread'i: (1,0120 − 1,0000) / 1,0000 × 100 = %1,20. Gerçekleşme sonrası: (1,0095 − 1,0025) / 1,0025 × 100 ≈ %0,70. Satır, 10.000 $ üzerinden 120 $ vaat eder; defterlerden sonra yaklaşık 70 $ kalır: 10.000 × 0,006983 ≈ 69,83.

Kaybedilen 50 baz puanın 8'i son işlem ile en iyi emirler arasındaki farka, kalan 42'si iki defterin derinliğine gitti.

Emir defteri Δ, Genesis Arbitrage'ın bir satırın spread'inin verilen büyüklük için emir defterleri üzerinden yeniden hesaplanmasına verdiği addır; sitede arbitraj tablolarındaki «Emir defteri Δ» sütunudur, örneğin Spot – Futures. API'de /orderbooks/spreads/{dataset} üzerinden gelir: spot-spot, spot-futures, futures-futures, dex-spot veya dex-futures veri setinde bir coin'in her satırı bir order_delta nesnesi alır (Emir defteri Δ).

order_delta, seçilen büyüklük için buy_price ve sell_price'ı, gerçekleşme sonrası spread_pct'yi ve bir status'u taşır: ok, no_book (defter yok) veya exhausted (defter dolmadı). volume değeri 0 (defterin en iyi fiyatları) veya 500, 1000, 2500, 5000, 10000'dir ve sonuç hiçbir zaman satırın spread'ini aşmaz. DEX satırları fiyat çifti yerine side ve cex_price taşır: CEX tarafı ve onun gerçekleşme fiyatı.

Gerçekleşme fiyatlarının kendisi, tüm piyasalar için birlikte, /orderbooks/exec üzerinden gelir: Binance|spot|BTC gibi bir anahtarın altında bir [alış fiyatı, satış fiyatı] çifti; defter çok inceyse null (Gerçekleşme fiyatları).

Coin transferi ve ağ kontrolleriyle tam kurulum Borsalar arası kripto arbitrajı yazısında anlatılıyor.

Python örneği: satır spread'i ve gerçekleşme sonrası spread

Betik, spread'i en az %0,5 olan Spot – Spot kurulumlarını alır, spread'i en geniş on coin için 5.000 $'da Emir defteri Δ ister ve defterlerin kaç baz puan götürdüğünü yazdırır. Anahtar GENESIS_API_KEY ortam değişkeninden gelir. 429 ve 503 durumlarında betik Retry-After saniye bekler; bekleme bir dakikadan uzunsa (aylık kota bitmiştir) durur.

import os
import time
import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
VOLUME = 5000      # dollars per leg
MIN_SPREAD = 0.5   # row spread, %


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):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # the monthly quota is used up
                break
            time.sleep(wait)
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API did not answer, try again later")


rows = get("/arbitrage/spot-spot", {"min_spread": MIN_SPREAD})
rows.sort(key=lambda x: x["spread_pct"], reverse=True)
coins = list(dict.fromkeys(x["coin"] for x in rows))[:10]

for coin in coins:
    data = get("/orderbooks/spreads/spot-spot",
               {"coin": coin, "volume": VOLUME})
    for row in data:
        od = row["order_delta"]
        if row["spread_pct"] < MIN_SPREAD or od["status"] != "ok":
            continue  # no_book or exhausted: the size will not fill
        lost = (row["spread_pct"] - od["spread_pct"]) * 100
        print(f'{coin} {row["exchange_buy"]}→{row["exchange_sell"]}'
              f' {row["spread_pct"]:.2f}% → {od["spread_pct"]:.2f}%,'
              f' the books ate {lost:.0f} bps')
    time.sleep(0.25)  # up to 4 requests per second: Pro allows 5

Betik, coin'ler arasında 0,25 sn aralıkla en fazla 11 çağrı yapar. Bir döngüde meta.freshness_sec değerinden daha sık çalıştırmayın: Pro'da 10 sn, Max'te 5 sn (Genesis API limitleri). Bildirim eklemek için Python ile kripto arbitraj botu yazısına bakın.

Gerçekleşme maliyeti geçmişi

Tek bir anlık görüntü, mevcut slipajın piyasa için normal olup olmadığını ya da defterin her zamankinden ince olup olmadığını söylemez. /orderbooks/exec-history, Genesis Charts'tan geçmişi döndürür: 500 $, 1.000 $, 2.500 $, 5.000 $ ve 10.000 $'lık bir gerçekleşmenin defter orta fiyatından kaç baz puan uzaklığa mal olduğu, alış ve satış için ayrı ayrı (Gerçekleşme geçmişi).

Her aralıkta 360 nokta vardır: 1m 6 saati, 15m 3,75 günü, 1h 15 günü ve 1d yaklaşık bir yılı kapsar; veriler 6 Eylül 2026'dan itibaren mevcuttur. Bir istek keys parametresinde en fazla 8 piyasa alır. Alış değerleri pozitif, satış değerleri negatiftir; null, veri olmadığını veya defterin dolmadığını gösterir. Genesis API, defterin geçmiş anlık görüntülerini sunmaz.

import os
import statistics
import requests

KEY = "Binance|spot|BTC"
r = requests.get(
    "https://api.genesisarbitrage.com/v1/orderbooks/exec-history",
    headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
    params={"keys": KEY, "interval": "1h"},  # 360 hours, 15 days
    timeout=15,
)
r.raise_for_status()
data = r.json()["data"]
series = data["series"][KEY]
if series is None:
    raise SystemExit("market not found: " + KEY)
i = data["volumes_usd"].index(10000)  # the $10,000 buy series
buy = series["buy"][i]
known = [x for x in buy if x is not None]
if not known:
    raise SystemExit("no data for the period")
print("15-day median, bps:", statistics.median(known))
print("latest point, bps:", buy[-1])

Varsayımsal olarak, 15 günlük medyan 12 baz puan, son nokta 25 ise gerçekleşme şu anda olağandan iki kat pahalıdır ve bu coin için spread eşiğini yükseltmek mantıklıdır.

DEX: slipaj merdiveni, token vergileri ve honeypot'lar

DEX havuzunda emir defteri yoktur: takas fiyatı havuzun formülünden gelir ve işlem likiditeye göre ne kadar büyükse fiyat o kadar kayar. Bu yüzden DEX bacağı bir merdivenle, yani bir dizi büyüklükteki slipajla değerlendirilir.

/orderbooks/dex-slippage, her kontrat için 100 $, 500 $, 1.000 $, 2.500 $, 5.000 $, 10.000 $, 20.000 $, 50.000 $ ve 100.000 $'daki alış ve satış slipajını, token vergilerini ve honeypot bayrağını döndürür; sitedeki DEX tablosu sütunlarıyla aynıdır (DEX slippage). Dokümantasyondaki örnek yanıtta alış slipajı 10.000 $'da %0,86, 50.000 $'da %3,12 ve 100.000 $'da %6,05'tir.

Bu, kurulumun sınırını belirler: %2'lik bir DEX – CEX spread'i, komisyonlardan önce bile 10.000 $'da havuzun slipajına dayanır ama 50.000 $'da dayanmaz. Merdivendeki null, havuzda o büyüklük için likidite olmadığı anlamına gelir; ağ gas'ı yanıtta yoktur, ayrıca hesaba katın.

tax_buy_pct ve tax_sell_pct, tokenın alış ve satış vergisidir (%); null kaynak olmadığı anlamına gelir ve sıfır olarak okunmamalıdır. honeypot: no — işaret yok, suspect — kaynaklar çelişiyor, yes — tokenı satmak imkânsız olabilir.

Tokenı elle kontrol etmek için Almadan önce token nasıl kontrol edilir yazısına; DEX fiyatları ve likiditesini CEX'in yanında görmek için DEX API yazısına bakın.

Genesis API'de emir defterleri: endpoint'ler ve planlar

GörevEndpoint
Her piyasada 500–10.000 $ için gerçekleşme fiyatı/orderbooks/exec
Bir satırın gerçekleşme sonrası spread'i/orderbooks/spreads/{dataset}
10 seviye, duvarlar, derinlik ve defter yaşı/orderbooks/book
Bir coin'in tüm borsalardaki defterleri/orderbooks/coin/{coin}
Gerçekleşme maliyeti geçmişi/orderbooks/exec-history
DEX slipajı, vergiler ve honeypot bayrağı/orderbooks/dex-slippage

Altısı da Pro ve Max API planlarına dahildir. Pro ayda 100 $'dır: 5 Mn çağrı, saniyede 5 istek, 10 sn tazelik. Max 200 $'dır: 10 Mn çağrı, saniyede 15 istek, 5 sn; Trial ve Start'ta emir defteri endpoint'leri 403 plan_restricted döndürür.

Parametreler ve yanıt örnekleri emir defteri endpoint'leri rehberindedir; API verilerine genel bakış için Kripto API yazısına ve Arbitraj için API verileri dersine bakın.

Sorular ve cevaplar

Tablodaki spread neden işlemde elde ettiğimden büyük?

Satır spread'i son işlemlerden gelir; piyasa emri ise defterin karşısında dolar ve büyüklük arttıkça ortalama fiyatı en iyi fiyattan uzaklaşır. Üstüne komisyonlar ve transfer sırasındaki fiyat hareketi biner. Emir defteri Δ, büyüklüğünüzde spread'in ne kadarının kaldığını gösterir.

Emir defterleri ne sıklıkla güncellenir?

Defter her yeni emir ve iptalle değişir; Binance akışı değişiklikleri her 100 veya 1000 ms'de bir gönderir. Genesis API'de defterler borsanın 5–20 saniye gerisindedir (yaş age_sec içindedir) ve yanıtlar Pro'da 10 saniyede, Max'te 5 saniyede bir yenilenir.

Genesis API'de emir defterleri için WebSocket var mı?

Hayır. Genesis API yalnızca RESTtir: HTTP GET isteği ve JSON yanıtı. Gerçek zamanlı defter akışları borsaların kendi WebSocket'lerinden gelir; borsanın işlem API'si üzerinden emir veren bir bot da buna ihtiyaç duyar.

Ücretsiz bir emir defteri API'si var mı?

Borsaların herkese açık endpoint'leri vardır: /api/v3/depth üzerindeki Binance defteri anahtarsız yanıt verir, ama tek bir borsayı kapsar ve gerçekleşme fiyatını kendiniz hesaplarsınız. Genesis API'de ücretsiz plan yoktur; emir defterleri ayda 100 $'lık Pro'ya ve 200 $'lık Max'e dahildir.