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-slippageiş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:
| Veri | Arbitrajda neden önemli | Genesis 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 hacim | Havuzda hiç işlem olup olmadığı | dex_volume_24h, volume_24h_usd |
| Piyasa değeri | Tokenın ne kadar büyük olduğu | market_cap |
| Kontrat ve ağ | Borsadakiyle aynı token olup olmadığı | contract, network veya chain |
| Havuz yaşı | Yeni havuz, kontratı yeniden kontrol etmek için bir nedendir | pool_created_at |
| CEX'te para yatırma ve çekme | Tokenın borsaya girip çıkıp çıkamayacağı | deposit_enabled, withdraw_enabled |
| Slipaj, vergi, honeypot | Spread'den ne kadarının kaldığı | /orderbooks/dex-slippage |
| Havuz bağlantıları | Havuza ve işlemlerine kendiniz bakmak için | dexscreener_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:
- Para yatırma veya çekme kapalı. Token borsaya girip çıkamıyorsa iki piyasa ayrı yaşar. Satırda bunlar
deposit_enabledvewithdraw_enabled'dır. - Maliyetler farkı aşıyor. Gas, havuz ve borsa komisyonları: bu maliyetlerden küçük bir farkı kapatmaya değmez.
- Token vergisi. %5 alış vergisinde, %5'e kadar olan fark verginin kendisine gider.
- İnce havuz. Değeri on binlerce dolar olan bir havuzda orta büyüklükte tek bir işlem fiyatı kaydırır.
- Farklı bir token. DEX'te aynı ticker altında farklı kontratlı bir kopya işlem görebilir. Genesis Arbitrage fiyatları yalnızca kontrat adresi eşleştiğinde karşılaştırı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 | İşlem | CEX'te gereken | DEX bacağı verileri |
|---|---|---|---|
| 0'ın üstünde | DEX'ten al, borsaya yatır, sat | deposit_enabled | slippage_buy_pct, tax_buy_pct |
| 0'ın altında | Borsadan al, çek, DEX'te sat | withdraw_enabled | slippage_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üğü | Slipaj | Gas, 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
| Endpoint | Ne döndürür | Dokümantasyon |
|---|---|---|
/arbitrage/dex-spot | DEX fiyatı ve CEX spot, likidite, piyasa değeri, hacim | DEX — Spot |
/arbitrage/dex-futures | DEX fiyatı ve CEX vadeli, max_position_usd | DEX — Futures |
/arbitrage/crosschain | İki ağdaki DEX'lerde aynı token, havuz yaşı | Zincirler arası |
/orderbooks/dex-slippage | 100 $ ile 100.000 $ arası slipaj, vergiler, honeypot | DEX slippage |
/market/dex-dumps | DEX'lerde token çöküşleri ve tokenın CEX'te işlem görüp görmediği | DEX 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
- MEV ve sandwich saldırıları. Bir bot DEX swap'ınızı bloğa girmeden görebilir: önünüze alış yapar, hemen ardından satar ve spread'in bir kısmını alır. Cüzdanınızdaki slipaj toleransı ne kadar genişse, alabileceği o kadar fazladır; korunma yolları DEX'lerde MEV ve sandwich saldırıları yazısında.
- Token sahibinin yetkileri. Kontrat izin veriyorsa sahip, siz aldıktan sonra vergiyi artırabilir veya satışı engelleyebilir; bugünkü
honeypot: "no"ve sıfır vergi sizi bundan korumaz. Kontrat izinleri ve likidite kilitleri Almadan önce token nasıl kontrol edilir yazısında adım adım kontrol edilir. - Veri gecikmesi. Fiyatlar planınızın gecikmesiyle, slipaj merdiveni ise kendi
updated_at'iyle gelir. İşlemden önce havuz fiyatını satırın bağlantısından, borsadaki emir defterini de borsadan kontrol edin. - Borsaya transfer. Token yoldayken para yatırma kapanabilir; hesaba geçme ağ onaylarını bekler, bu sayıyı her borsa kendisi belirler.
- Gas. Yoğun bir ağda gas yükselir ve küçük işlemlerde spread'i yer.
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.