API DEX: harga DEX, likuiditas, dan slippage di samping harga CEX
Ringkasan
- API DEX mengembalikan harga token di pool, likuiditas, volume, market cap, kontrak, dan network. Untuk arbitrase, Anda juga butuh harga CEX dari kontrak yang sama — endpoint DEX – Spot dan DEX – Futures di Genesis API mengembalikannya di paket Pro dan Max.
- Harga DEX bergantung pada ukuran trade karena ditentukan oleh liquidity pool. Dalam contoh hipotetis, spread 3% menyisakan $11 pada trade $2.500 dan menjadi negatif di $5.000 setelah slippage, pajak token, dan gas.
/orderbooks/dex-slippagemengembalikan slippage untuk ukuran trade Anda, pajak beli dan jual, serta flag honeypot. Genesis API hanya membaca data: Anda menandatangani swap sendiri di dompet Anda.
API DEX adalah akses terprogram ke data exchange terdesentralisasi (DEX): harga token di pool, likuiditas pool, volume perdagangan, market cap, alamat kontrak, dan network. Sebagian besar DEX tidak punya order book maupun proses listing: harga ditentukan liquidity pool, dan siapa pun bisa membuat pool. Karena itu API DEX harus mengembalikan, selain harga, data yang Anda perlukan untuk memeriksa token dan pool.
Untuk arbitrase, harga DEX dibandingkan dengan harga CEX dari kontrak yang sama, lalu dihitung berapa spread yang tersisa pada ukuran trade Anda setelah slippage, pajak token, dan gas. Di Genesis API, pair DEX ↔ CEX berasal dari /arbitrage/dex-spot dan /arbitrage/dex-futures, sedangkan slippage, pajak, dan flag honeypot per kontrak berasal dari /orderbooks/dex-slippage.
Bagaimana DEX menentukan harga
Di sebagian besar DEX, swap berjalan melalui liquidity pool — smart contract yang menyimpan cadangan dua token, misalnya sebuah token dan USDC. Harga adalah rasio cadangan. Pembelian mengambil token dari pool dan menambahkan USDC, sehingga setiap unit token berikutnya lebih mahal daripada sebelumnya.
Uniswap menggambarkan pool seperti ini dengan rumus constant product x × y = k, di mana x dan y adalah cadangan token: setelah swap, hasil kalinya tidak boleh turun.
Contoh hipotetis: sebuah pool memiliki likuiditas $200.000, masing-masing $100.000 di tiap sisi. Pembelian $1.000 menggeser harga rata-rata sebesar 2 × 1.000 / 200.000 = 1%, pembelian $10.000 sebesar 10%. Perhitungan langkah demi langkah dengan tabel ada di pelajaran Apa itu arbitrase DEX.
Rumus ini menggambarkan satu pool klasik. Di Uniswap v3 dan v4, rumus berlaku di dalam rentang harga yang dipilih penyedia likuiditas, dan harga DEX di baris Genesis Arbitrage diagregasi per kontrak dan network. Jadi slippage yang tepat untuk ukuran trade tertentu berasal dari data, sedangkan rumus berfungsi sebagai estimasi cepat.
Apa yang Anda butuhkan dari API DEX
Menilai pair DEX ↔ CEX membutuhkan lebih dari satu harga. Berikut yang Anda butuhkan dan letaknya di respons Genesis API:
| Data | Mengapa penting di arbitrase | Field Genesis API |
|---|---|---|
| Harga DEX dan CEX | Spread dan arahnya | dex_price, cex_price, spread_pct |
| Likuiditas pool | Seberapa jauh trade menggeser harga | liquidity_usd |
| Volume 24 jam | Apakah pool diperdagangkan sama sekali | dex_volume_24h, volume_24h_usd |
| Market cap | Seberapa besar token | market_cap |
| Kontrak dan network | Apakah token yang sama dengan di exchange | contract, network atau chain |
| Usia pool | Pool baru adalah alasan untuk memeriksa ulang kontrak | pool_created_at |
| Deposit dan penarikan di CEX | Apakah token bisa masuk ke atau keluar dari exchange | deposit_enabled, withdraw_enabled |
| Slippage, pajak, honeypot | Berapa spread yang tersisa | /orderbooks/dex-slippage |
| Tautan pool | Lihat sendiri pool dan transaksinya | dexscreener_url, dextools_url, gmgn_url |
Market cap dan volume DEX ada di DEX – Spot, usia pool di sisi buy dan sell Cross-chain. Permintaan untuk satu baris DEX – Spot satu koin:
curl -G --compressed \
"https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
-d coin=SCR \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Satu baris dari dokumentasi DEX — Spot, diringkas:
{
"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 lebih mahal di MEXC daripada di pool, jadi spread positif: 0,45%. Likuiditas pool $10.544 dan volume DEX 24 jam sekitar $320. Jika ini satu pool klasik, harga rata-rata pembelian $1.000 akan sekitar 2 × 1.000 / 10.544 ≈ 19% di atas harga awal — lebih dari 40 kali spread. Tautan bisa null: baris ini hanya punya dexscreener_url.
Mengapa harga DEX menyimpang dari harga CEX
Harga pool hanya berubah lewat trade di dalamnya, dan dari luar harga baru muncul di setiap blok: Ethereum membagi waktu menjadi slot 12 detik. Di CEX, harga bergerak mengikuti aliran order di book. Selisih bertahan sampai seorang arbitrase menutupnya, dan inilah yang menghalangi:
- Deposit atau penarikan ditutup. Jika token tidak bisa masuk ke atau keluar dari exchange, kedua pasar hidup terpisah. Di baris, ini adalah
deposit_enableddanwithdraw_enabled. - Biaya melebihi selisih. Gas, fee pool, dan fee exchange: selisih yang lebih kecil dari biaya ini tidak layak ditutup.
- Pajak token. Dengan pajak beli 5%, selisih hingga 5% habis oleh pajak itu sendiri.
- Pool tipis. Di pool bernilai puluhan ribu dolar, satu trade berukuran menengah menggeser harga.
- Token yang berbeda. Salinan dengan kontrak berbeda bisa diperdagangkan di DEX dengan ticker yang sama. Genesis Arbitrage membandingkan harga hanya ketika alamat kontrak cocok.
Untuk arbitrase, tanda spread menentukan arah trade, dan arah menentukan apa yang harus terbuka di exchange serta data leg DEX mana yang dibaca:
spread_pct | Trade | Dibutuhkan di CEX | Data leg DEX |
|---|---|---|---|
| Di atas 0 | Beli di DEX, deposit ke exchange, jual | deposit_enabled | slippage_buy_pct, tax_buy_pct |
| Di bawah 0 | Beli di exchange, tarik, jual di DEX | withdraw_enabled | slippage_sell_pct, tax_sell_pct |
Selagi token berpindah antara dompet dan exchange, spread bisa menutup. Pada pair DEX – Futures, short futures yang dibuka bersamaan dengan pembelian di DEX mengimbangi pergerakan harga, tetapi risiko margin, funding, dan likuidasi ikut datang — lihat pelajaran Arbitrase: DEX — Futures. Baris DEX – Futures juga punya max_position_usd, ukuran posisi maksimum, jika disediakan exchange.
Slippage, pajak token, dan honeypot
/orderbooks/dex-slippage menggambarkan leg DEX sebuah pair per kontrak: slippage beli dan jual untuk ukuran dari $100 hingga $100.000, pajak beli dan jual token, serta flag honeypot (honeypot adalah token yang bisa dibeli tetapi tidak bisa dijual). Datanya sama dengan kolom tabel DEX di situs. Filternya adalah contract (dipisahkan koma untuk beberapa alamat) dan network; field dijelaskan di bagian Slippage DEX.
Contoh respons dari dokumentasi, satu kontrak:
{
"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
}
]
}
Array mengikuti grid sizes_usd: pembelian $1.000 kehilangan 0,36%, pembelian $10.000 kehilangan 0,86%, pembelian $100.000 kehilangan 6,05%. null dalam array berarti pool kekurangan likuiditas untuk ukuran itu. honeypot punya tiga nilai: no, suspect — sumber tidak sepakat, dan yes — penjualan mungkin tidak bisa dilakukan. Setiap kontrak punya waktu pembaruannya sendiri di updated_at.
Contoh hipotetis: spread 3% dan sisanya
Token seharga $1,00 di DEX dan $1,03 di CEX: spread 3% pada harga beli, jadi Anda membeli di DEX dan menjual di exchange. Pajak beli 1%, fee exchange saat penjualan 0,1%, dan gas untuk swap serta transfer ke exchange $4. Tangga slippage_buy_pct: 0,5% di $500, 0,7% di $1.000, 1,3% di $2.500, dan 2,3% di $5.000.
| Ukuran trade | Slippage | Gas, % dari ukuran | Spread tersisa |
|---|---|---|---|
| $500 | 0,5% | 0,8% | 0,6%, atau $3 |
| $1.000 | 0,7% | 0,4% | 0,8%, atau $8 |
| $2.500 | 1,3% | 0,16% | 0,44%, atau $11 |
| $5.000 | 2,3% | 0,08% | −0,48%, atau −$24 |
Untuk $5.000: 3 − 2,3 − 1 − 0,1 − 0,08 = −0,48%, rugi $24 pada trade. Menjumlahkan persentase cukup untuk estimasi; perhitungan tepat dengan perkalian hasilnya beberapa per seratus persen lebih rendah.
Dalam dolar, sisa terbesar ada di $2.500, sedangkan di $5.000 spread yang sama membuat trade negatif. Seiring ukuran naik, porsi gas mengecil dan slippage membesar, jadi setiap pair punya ukuran kerjanya sendiri. Dengan honeypot: "yes" dan spread negatif tidak ada yang perlu dihitung: token yang dibeli di exchange mungkin tidak bisa dijual di pool.
Penjualan CEX dalam contoh memakai harga baris. Dalam praktik, Anda memeriksanya terhadap order book exchange: Δ order book untuk baris DEX berasal dari /orderbooks/spreads/dex-spot untuk $500, $1.000, $2.500, $5.000, dan $10.000 — field ada di dokumentasi, penjelasan langkah demi langkah di panduan Endpoint order book.
Endpoint DEX di Genesis API
| Endpoint | Yang dikembalikan | Dokumentasi |
|---|---|---|
/arbitrage/dex-spot | Harga DEX vs spot CEX, likuiditas, market cap, volume | DEX — Spot |
/arbitrage/dex-futures | Harga DEX vs futures CEX, max_position_usd | DEX — Futures |
/arbitrage/crosschain | Satu token di DEX pada dua network, usia pool | Cross-chain |
/orderbooks/dex-slippage | Slippage dari $100 hingga $100.000, pajak, honeypot | Slippage DEX |
/market/dex-dumps | Anjloknya token di DEX dan apakah token diperdagangkan di CEX | DEX Dumps |
Kelimanya berjalan di paket API Pro ($100 per bulan, kesegaran 10 dtk) dan Max ($200, kesegaran 5 dtk); di Trial dan Start mengembalikan 403 plan_restricted. DEX – Spot dan DEX – Futures menerima coin, exchange, min_spread, dan min_liquidity, Cross-chain menerima chain sebagai pengganti exchange, dan DEX Dumps menerima chain dan min_liquidity. Parameter dan field dibahas di panduan Endpoint arbitrase, harga ada di halaman harga Genesis API.
min_spread membandingkan spread bertanda: min_spread=2 juga menyingkirkan baris dengan spread −5%. Untuk melihat kedua arah, terapkan ambang pada nilai absolut di kode, seperti pada contoh di bawah. Swap pool besar dengan estimasi price impact berasal dari endpoint on-chain /onchain/dex-swaps, dibahas di artikel API data on-chain.
Tanpa kode, tabel di situs menampilkan pair yang sama: kolom, filter, dan urutan pemeriksaannya dijelaskan di Cara memakai tabel DEX – Spot.
Contoh Python: pair DEX – Spot tanpa jebakan
Skrip mengambil pair DEX – Spot dengan likuiditas mulai $50.000 dan spread absolut mulai 2%, meminta slippage dan pajak untuk kontraknya, lalu menyingkirkan honeypot: "yes" dan pajak di atas 5%. Untuk sisanya, skrip menghitung berapa spread yang tersisa pada $1.000 setelah slippage dan pajak. Key diambil dari environment variable GENESIS_API_KEY.
Fungsi permintaan menunggu Retry-After detik pada 429 dan 503. Ketika kuota bulanan habis, Retry-After menghitung mundur sampai kuota direset dan bisa sampai berhari-hari, sehingga skrip tidak memulai penantian panjang:
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")
Memilih pair dan memeriksa kontrak:
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}')
Skrip tidak mengurangi gas dan fee exchange, jadi tambahkan angka network dan exchange Anda sendiri. Skrip melewati baris yang tidak punya data di /orderbooks/dex-slippage: periksa token tersebut secara manual lewat tautan baris. Alamat dibandingkan dalam huruf kecil karena DEX – Spot bisa mengembalikan kontrak dengan huruf campuran, seperti pada contoh di atas.
Lakukan polling dalam loop tidak lebih sering daripada meta.freshness_sec. Di Pro itu berarti setiap 10 detik: 30 × 86.400 / 10 = 259.200 panggilan ke satu endpoint per 30 hari terhadap kuota 5 juta. Cara menghemat kuota dan trafik dibahas di Cara polling API tanpa kena limit.
Risiko yang tidak terlihat dari spread
- MEV dan serangan sandwich. Bot bisa melihat swap DEX Anda sebelum masuk ke blok: ia membeli di depan Anda, menjual tepat sesudahnya, dan mengambil sebagian spread. Semakin lebar slippage tolerance di dompet Anda, semakin banyak yang bisa diambil; perlindungannya dibahas di MEV dan serangan sandwich di DEX.
- Kewenangan pemilik token. Jika kontrak mengizinkan, pemilik bisa menaikkan pajak atau memblokir penjualan setelah Anda membeli, dan
honeypot: "no"serta pajak nol hari ini tidak melindungi Anda dari itu. Izin kontrak dan penguncian likuiditas diperiksa langkah demi langkah di Cara memeriksa token sebelum membeli. - Keterlambatan data. Harga tiba dengan keterlambatan paket Anda dan tangga slippage dengan
updated_at-nya sendiri. Sebelum trade, periksa harga pool lewat tautan baris dan order book di exchange. - Transfer ke exchange. Deposit bisa ditutup selagi token dalam perjalanan, dan pengkreditan menunggu konfirmasi network, angka yang ditetapkan tiap exchange sendiri.
- Gas. Di network yang ramai, gas naik dan memakan spread pada trade kecil.
Tanya jawab
Bisakah saya membeli token lewat Genesis API?
Tidak. Genesis API hanya mengembalikan data dan tidak menempatkan order, baik di DEX maupun di exchange. Anda menandatangani swap DEX di dompet sendiri dan membuka trade CEX sendiri di exchange.
Seberapa sering harga DEX diperbarui di API?
Harga pool berubah dengan setiap trade di dalamnya dan terlihat dari luar pada setiap blok baru. Inti Genesis Arbitrage menyegarkan data setiap detik, dan API menyajikannya dengan kesegaran paket Anda: 10 dtk di Pro dan 5 dtk di Max, satu-satunya paket dengan endpoint DEX. Waktu pembuatan snapshot ada di meta.updated_at; slippage dan pajak membawa updated_at milik tiap kontrak.
Apa arti null pada pajak token?
Artinya tidak ada sumber untuk data pajak token ini. Jangan anggap nol: pajaknya bisa berapa saja. Contoh Python di atas mempertahankan baris seperti itu dan mencetak "tax no data" agar Anda bisa memeriksanya manual.
Paket Genesis API mana yang saya perlukan untuk data DEX?
Pro ($100 per bulan) atau Max ($200). Di Trial dan Start, DEX – Spot, DEX – Futures, Cross-chain, DEX Dumps, dan slippage DEX mengembalikan 403 plan_restricted.
Apakah respons menyertakan tautan DexScreener?
Ya. Baris DEX – Spot dan DEX – Futures serta kedua sisi Cross-chain membawa dexscreener_url, dextools_url, dan gmgn_url, tautan ke halaman pool atau token. Jika tautan tidak ada, field-nya null. Di DEX Dumps, tautan pool adalah pool_url, dan yang lain ada di array links.