Genesis Arbitrage

Genesis Arbitrage · · 15 dk okuma

DEX API: DEX fiyatları, likidite ve slipaj CEX fiyatlarıyla yan yana

Kısaca

  • DEX API, bir tokenın havuzdaki fiyatını, likiditesini, hacmini, piyasa değerini, kontratını ve ağını verir. Arbitraj için aynı kontratın CEX fiyatı da gerekir: Genesis API'nin DEX – Spot ve DEX – Futures endpoint'leri bunu Pro ve Max planlarında döndürür.
  • DEX fiyatı işlem büyüklüğüne bağlıdır, çünkü fiyatı bir likidite havuzu belirler. Varsayımsal bir örnekte %3'lük spread, 2.500 $'lık işlemde 11 $ bırakır; 5.000 $'da slipaj, token vergisi ve gas sonrası negatife döner.
  • /orderbooks/dex-slippage işlem büyüklüğünüz için slipajı, alış ve satış vergilerini ve honeypot bayrağını döndürür. Genesis API yalnızca veri okur: swap'ı kendi cüzdanınızda kendiniz imzalarsınız.

DEX API, merkeziyetsiz borsalardaki (DEX) verilere programlı erişimdir: bir tokenın havuzdaki fiyatı, havuz likiditesi, işlem hacmi, piyasa değeri, kontrat adresi ve ağ. Çoğu DEX'te emir defteri de listeleme süreci de yoktur: fiyatı bir likidite havuzu belirler ve havuzu herkes oluşturabilir. Bu yüzden DEX API'nin fiyatla birlikte tokenı ve havuzu kontrol etmek için gereken verileri de döndürmesi gerekir.

Arbitrajda DEX fiyatı aynı kontratın CEX fiyatıyla karşılaştırılır ve spread'in işlem büyüklüğünüzde slipaj, token vergisi ve gas sonrası ne kadarının kaldığı hesaplanır. Genesis API'de DEX ↔ CEX pariteleri /arbitrage/dex-spot ve /arbitrage/dex-futures üzerinden gelir; kontrat başına slipaj, vergiler ve honeypot bayrağı ise /orderbooks/dex-slippage üzerinden alınır.

DEX fiyatı nasıl belirler

Çoğu DEX'te swap, bir likidite havuzundan geçer: iki tokenın rezervini tutan akıllı kontrat, örneğin bir token ve USDC. Fiyat, rezervlerin oranıdır. Alış işlemi havuzdan tokenı çeker ve USDC ekler; bu yüzden tokenın her sonraki birimi bir öncekinden pahalıya gelir.

Uniswap böyle bir havuzu sabit çarpım formülüyle x × y = k tanımlar; burada x ve y token rezervleridir: swap sonrası çarpım azalmamalıdır.

Varsayımsal örnek: havuzda 200.000 $ likidite var, her tarafta 100.000 $. 1.000 $'lık alış ortalama fiyatı 2 × 1.000 / 200.000 = %1, 10.000 $'lık alış %10 kaydırır. Tabloyla adım adım hesap, DEX arbitrajı nedir dersinde.

Formül tek bir klasik havuzu anlatır. Uniswap v3 ve v4'te likidite sağlayıcılarının seçtiği fiyat aralıklarında geçerlidir; Genesis Arbitrage satırlarındaki DEX fiyatı ise kontrata ve ağa göre toplulaştırılır. Bu yüzden belirli bir işlem büyüklüğü için kesin slipaj veriden gelir, formül ise hızlı tahmin işini görür.

DEX API'den ne istemelisiniz

Bir DEX ↔ CEX paritesini değerlendirmek için tek fiyat yetmez. Gerekenler ve Genesis API yanıtlarındaki yerleri:

VeriArbitrajda neden önemliGenesis API alanı
DEX ve CEX fiyatıSpread ve yönüdex_price, cex_price, spread_pct
Havuz likiditesiİşlemin fiyatı ne kadar kaydıracağıliquidity_usd
24s hacimHavuzda hiç işlem olup olmadığıdex_volume_24h, volume_24h_usd
Piyasa değeriTokenın ne kadar büyük olduğumarket_cap
Kontrat ve ağBorsadakiyle aynı token olup olmadığıcontract, network veya chain
Havuz yaşıYeni havuz, kontratı yeniden kontrol etmek için bir nedendirpool_created_at
CEX'te para yatırma ve çekmeTokenın borsaya girip çıkıp çıkamayacağıdeposit_enabled, withdraw_enabled
Slipaj, vergi, honeypotSpread'den ne kadarının kaldığı/orderbooks/dex-slippage
Havuz bağlantılarıHavuza ve işlemlerine kendiniz bakmak içindexscreener_url, dextools_url, gmgn_url

Piyasa değeri ve DEX hacmi DEX – Spot'ta, havuz yaşı ise Zincirler arası'nın buy ve sell taraflarında gelir. Tek bir coinin DEX – Spot satırı için istek:

curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
  -d coin=SCR \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

DEX — Spot dokümantasyonundan bir satır, kısaltılmış:

{
  "coin": "SCR",
  "exchange": "MEXC",
  "cex_price": 0.02691,
  "dex_price": 0.02679,
  "spread_pct": 0.45,
  "network": "SCROLL",
  "contract": "0xd29687c813D741E2F938F4aC377128810E217b1b",
  "liquidity_usd": 10544.15,
  "market_cap": 5091835.0,
  "dex_volume_24h": 319.73,
  "deposit_enabled": true,
  "withdraw_enabled": true,
  "dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
  "dextools_url": null,
  …
}

Token MEXC'de havuzdakinden pahalı, yani spread pozitif: %0,45. Havuz likiditesi 10.544 $, 24 saatlik DEX hacmi yaklaşık 320 $. Bu tek bir klasik havuzsa, 1.000 $'lık alışın ortalama fiyatı başlangıç fiyatının yaklaşık 2 × 1.000 / 10.544 ≈ %19 üstünde olur; yani spread'in 40 katından fazla. Bağlantılar null olabilir: bu satırda yalnızca dexscreener_url var.

DEX fiyatları CEX fiyatlarından neden ayrışır

Havuzun fiyatı yalnızca içindeki işlemlerle değişir ve dışarıdan yeni fiyat her blokla görünür: Ethereum zamanı 12 saniyelik slotlara böler. CEX'te fiyat, defterdeki emir akışıyla hareket eder. Fark, bir arbitrajcı kapatana kadar sürer; onu kapatmayı engelleyenler şunlardır:

Arbitrajda spread'in işareti işlem yönünü belirler; yön de borsada neyin açık olması gerektiğini ve DEX bacağının hangi verilerinin okunacağını belirler:

spread_pctİşlemCEX'te gerekenDEX bacağı verileri
0'ın üstündeDEX'ten al, borsaya yatır, satdeposit_enabledslippage_buy_pct, tax_buy_pct
0'ın altındaBorsadan al, çek, DEX'te satwithdraw_enabledslippage_sell_pct, tax_sell_pct

Token cüzdan ile borsa arasında yoldayken spread kapanabilir. DEX – Futures paritesinde, DEX alışıyla birlikte açılan vadeli short fiyat hareketini dengeler; ancak marjin, fonlama ve likidasyon riski de beraberinde gelir. Bkz. Arbitraj: DEX — Futures dersi. DEX – Futures satırında borsa sağlıyorsa en büyük pozisyon büyüklüğü olan max_position_usd de bulunur.

Slipaj, token vergisi ve honeypot'lar

/orderbooks/dex-slippage, bir paritenin DEX bacağını kontrat bazında anlatır: 100 $ ile 100.000 $ arası büyüklükler için alış ve satış slipajı, tokenın alış ve satış vergisi ve honeypot bayrağı (honeypot, alabildiğiniz ama satamadığınız tokendır). Sitedeki DEX tablosu sütunlarıyla aynı veridir. Filtreler contract (birden fazla adres için virgülle ayrılır) ve network'tür; alanlar DEX slippage bölümünde anlatılır.

Dokümantasyondan örnek bir yanıt, tek kontrat:

{
  "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
    }
  ]
}

Diziler sizes_usd ızgarasını izler: 1.000 $'lık alış %0,36, 10.000 $'lık alış %0,86, 100.000 $'lık alış %6,05 kaybeder. Dizide null, havuzda o büyüklük için likidite olmadığı anlamına gelir. honeypot üç değer alır: no, suspect — kaynaklar çelişiyor ve yes — satış imkânsız olabilir. Her kontratın kendi güncellenme zamanı updated_at'tedir.

Varsayımsal örnek: %3'lük spread ve ondan kalan

Token DEX'te 1,00 $, CEX'te 1,03 $: alış fiyatı üzerinden %3 spread, yani DEX'ten alıp borsada satarsınız. Alış vergisi %1, satışta borsa komisyonu %0,1, swap ve borsaya transfer için gas 4 $. slippage_buy_pct merdiveni: 500 $'da %0,5, 1.000 $'da %0,7, 2.500 $'da %1,3 ve 5.000 $'da %2,3.

İşlem büyüklüğüSlipajGas, büyüklüğün % olarak payıKalan spread
500 $%0,5%0,8%0,6 veya 3 $
1.000 $%0,7%0,4%0,8 veya 8 $
2.500 $%1,3%0,16%0,44 veya 11 $
5.000 $%2,3%0,08−%0,48 veya −24 $

5.000 $ için: 3 − 2,3 − 1 − 0,1 − 0,08 = −%0,48, işlemde 24 $ zarar. Yüzdeleri toplamak tahmin için yeterlidir; çarpımlarla yapılan kesin hesap yüzde birkaç yüzlük daha düşük çıkar.

Dolar olarak en çok 2.500 $'da kalır; 5.000 $'da aynı spread işlemi negatife çevirir. Büyüklük arttıkça gasın payı küçülür, slipaj büyür; bu yüzden her paritenin kendi çalışma büyüklüğü vardır. honeypot: "yes" ve negatif spread varsa hesaplanacak bir şey yoktur: borsadan alınan token havuzda satılamayabilir.

Örnekteki CEX satışı satır fiyatını kullanır. Pratikte bunu borsanın emir defteriyle kontrol edersiniz: DEX satırları için Emir defteri Δ, 500 $, 1.000 $, 2.500 $, 5.000 $ ve 10.000 $ için /orderbooks/spreads/dex-spot'tan gelir — alanlar dokümantasyonda, adım adım anlatım Emir defteri endpoint'leri rehberinde.

Genesis API'deki DEX endpoint'leri

EndpointNe döndürürDokümantasyon
/arbitrage/dex-spotDEX fiyatı ve CEX spot, likidite, piyasa değeri, hacimDEX — Spot
/arbitrage/dex-futuresDEX fiyatı ve CEX vadeli, max_position_usdDEX — Futures
/arbitrage/crosschainİki ağdaki DEX'lerde aynı token, havuz yaşıZincirler arası
/orderbooks/dex-slippage100 $ ile 100.000 $ arası slipaj, vergiler, honeypotDEX slippage
/market/dex-dumpsDEX'lerde token çöküşleri ve tokenın CEX'te işlem görüp görmediğiDEX Dumps

Beşi de Pro (ayda 100 $, 10 sn tazelik) ve Max (200 $, 5 sn tazelik) API planlarında çalışır; Trial ve Start'ta 403 plan_restricted döndürürler. DEX – Spot ve DEX – Futures coin, exchange, min_spread ve min_liquidity alır, Zincirler arası exchange yerine chain alır, DEX Dumps ise chain ve min_liquidity alır. Parametreler ve alanlar Arbitraj endpoint'leri rehberinde, fiyatlar Genesis API fiyatları sayfasında.

min_spread işaretli spread'i karşılaştırır: min_spread=2, −%5 spread'li bir satırı da eler. Her iki yönü görmek için eşiği, aşağıdaki örnekte olduğu gibi, kodda mutlak değere uygulayın. Fiyat etkisi tahminiyle büyük havuz swap'ları, zincir üstü endpoint /onchain/dex-swaps üzerinden gelir; Zincir üstü veri API'si yazısında anlatılıyor.

Kodsuz seçenekte sitedeki tablo aynı pariteleri gösterir: sütunları, filtreleri ve kontrol sırası DEX – Spot tablosu nasıl kullanılır yazısında.

Python örneği: tuzaksız DEX – Spot pariteleri

Script, likiditesi 50.000 $'dan ve mutlak spread'i %2'den başlayan DEX – Spot paritelerini alır, kontratları için slipaj ve vergileri ister; honeypot: "yes" olanları ve %5'in üstünde vergili olanları eler. Kalanlar için slipaj ve vergi sonrası 1.000 $'da spread'den ne kaldığını hesaplar. Anahtar GENESIS_API_KEY ortam değişkeninden gelir.

İstek fonksiyonu 429 ve 503'te Retry-After saniye bekler. Aylık kota bittiğinde Retry-After kota sıfırlanmasına kadar geriye sayar ve günlere varabilir; bu yüzden script uzun bir bekleme başlatmaz:

import os
import time
import requests

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


def get(path, params=None):
    for _ in range(3):
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code == 403:
            raise SystemExit("DEX endpoints need the Pro or Max plan")
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # monthly quota used up
                raise SystemExit(f"quota used up, retry in {wait} s")
            time.sleep(wait)
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API busy, try again later")

Pariteleri seçmek ve kontratları kontrol etmek:

SIZE = 1000   # trade size, USD: one of the sizes_usd values
MAX_TAX = 5   # skip tokens taxed above 5%

rows = get("/arbitrage/dex-spot", {"min_liquidity": 50000})
rows = [x for x in rows
        if x["contract"] and abs(x["spread_pct"]) >= 2]

addrs = sorted({x["contract"].lower() for x in rows})
checks, sizes = {}, []
for i in range(0, len(addrs), 50):  # up to 50 addresses per call
    d = get("/orderbooks/dex-slippage",
            {"contract": ",".join(addrs[i:i + 50])})
    sizes = d["sizes_usd"]
    for c in d["contracts"]:  # addresses come in lowercase
        checks[c["contract"]] = c

found = []
for x in rows:
    c = checks.get(x["contract"].lower())
    if c is None or c["honeypot"] == "yes":
        continue  # no data, or selling may be impossible
    taxes = [t for t in (c["tax_buy_pct"], c["tax_sell_pct"])
             if t is not None]  # null means no source, not 0%
    if any(t > MAX_TAX for t in taxes):
        continue
    buy = x["spread_pct"] >= 0  # positive: buy on the DEX
    ladder = c["slippage_buy_pct" if buy else "slippage_sell_pct"]
    k = sizes.index(SIZE)
    slip = ladder[k] if k < len(ladder) else None
    if slip is None:
        continue  # the pool lacks liquidity for SIZE
    tax = c["tax_buy_pct" if buy else "tax_sell_pct"]
    left = abs(x["spread_pct"]) - slip - (tax or 0)
    found.append((left, x, c["honeypot"], tax))

for left, x, hp, tax in sorted(found, key=lambda f: -f[0]):
    print(f'{x["coin"]:<8} {x["exchange"]:<8} '
          f'spread {x["spread_pct"]:+.2f}%, left {left:.2f}%, '
          f'tax {"no data" if tax is None else tax}, '
          f'honeypot {hp}')

Script gas ve borsa komisyonlarını düşmez; kendi ağ ve borsa rakamlarınızı ekleyin. /orderbooks/dex-slippage'da verisi olmayan satırları atlar: bu tokenları satırın bağlantılarından elle kontrol edin. Adresler küçük harfle karşılaştırılır, çünkü DEX – Spot kontratı, yukarıdaki örnekteki gibi, karışık harfle döndürebilir.

Döngüde meta.freshness_sec'ten sık sormayın. Pro'da bu 10 saniyede bir demektir: tek endpoint'e 30 gün için 30 × 86.400 / 10 = 259.200 çağrı, 5 milyonluk kotaya karşı. Kota ve trafikten nasıl tasarruf edileceği API'yi limitlere takılmadan nasıl sorgularsınız yazısında.

Spread'in göstermediği riskler

Sorular ve cevaplar

Genesis API üzerinden token alabilir miyim?

Hayır. Genesis API yalnızca veri döndürür ve ne DEX'lerde ne borsalarda emir vermez. DEX swap'larını kendi cüzdanınızda imzalar, CEX işlemlerini borsada kendiniz açarsınız.

DEX fiyatları API'de ne sıklıkla güncellenir?

Havuzun fiyatı içindeki her işlemle değişir ve dışarıdan her yeni blokla görünür. Genesis Arbitrage çekirdeği veriyi her saniye yeniler, API de onu planınızın tazeliğinde sunar: DEX endpoint'lerinin bulunduğu tek planlar olan Pro'da 10 sn, Max'te 5 sn. Anlık görüntünün oluşturulma zamanı meta.updated_at'tedir; slipaj ve vergiler her kontratın kendi updated_at'ini taşır.

Token vergisindeki null ne demek?

Bu tokenın vergi verisi için kaynak olmadığı demektir. Sıfır saymayın: vergi herhangi bir değer olabilir. Yukarıdaki Python örneği bu satırları tutar ve elle kontrol edebilmeniz için "tax no data" yazdırır.

DEX verisi için hangi Genesis API planı gerekir?

Pro (ayda 100 $) veya Max (200 $). Trial ve Start'ta DEX – Spot, DEX – Futures, Zincirler arası, DEX Dumps ve DEX slippage 403 plan_restricted döndürür.

Yanıtlarda DexScreener bağlantıları var mı?

Evet. DEX – Spot ve DEX – Futures satırları ile Zincirler arası'nın her iki tarafı dexscreener_url, dextools_url ve gmgn_url taşır; bunlar havuz veya token sayfasına bağlantılardır. Bağlantı yoksa alan null olur. DEX Dumps'ta havuz bağlantısı pool_url'dür, diğerleri links dizisindedir.