Genesis Arbitrage

Genesis Arbitrage · · 15 menit baca

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-slippage mengembalikan 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:

DataMengapa penting di arbitraseField Genesis API
Harga DEX dan CEXSpread dan arahnyadex_price, cex_price, spread_pct
Likuiditas poolSeberapa jauh trade menggeser hargaliquidity_usd
Volume 24 jamApakah pool diperdagangkan sama sekalidex_volume_24h, volume_24h_usd
Market capSeberapa besar tokenmarket_cap
Kontrak dan networkApakah token yang sama dengan di exchangecontract, network atau chain
Usia poolPool baru adalah alasan untuk memeriksa ulang kontrakpool_created_at
Deposit dan penarikan di CEXApakah token bisa masuk ke atau keluar dari exchangedeposit_enabled, withdraw_enabled
Slippage, pajak, honeypotBerapa spread yang tersisa/orderbooks/dex-slippage
Tautan poolLihat sendiri pool dan transaksinyadexscreener_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:

Untuk arbitrase, tanda spread menentukan arah trade, dan arah menentukan apa yang harus terbuka di exchange serta data leg DEX mana yang dibaca:

spread_pctTradeDibutuhkan di CEXData leg DEX
Di atas 0Beli di DEX, deposit ke exchange, jualdeposit_enabledslippage_buy_pct, tax_buy_pct
Di bawah 0Beli di exchange, tarik, jual di DEXwithdraw_enabledslippage_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 tradeSlippageGas, % dari ukuranSpread tersisa
$5000,5%0,8%0,6%, atau $3
$1.0000,7%0,4%0,8%, atau $8
$2.5001,3%0,16%0,44%, atau $11
$5.0002,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

EndpointYang dikembalikanDokumentasi
/arbitrage/dex-spotHarga DEX vs spot CEX, likuiditas, market cap, volumeDEX — Spot
/arbitrage/dex-futuresHarga DEX vs futures CEX, max_position_usdDEX — Futures
/arbitrage/crosschainSatu token di DEX pada dua network, usia poolCross-chain
/orderbooks/dex-slippageSlippage dari $100 hingga $100.000, pajak, honeypotSlippage DEX
/market/dex-dumpsAnjloknya token di DEX dan apakah token diperdagangkan di CEXDEX 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

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.