Genesis Arbitrage

Genesis Arbitrage · · 18 menit baca

Bot arbitrase kripto dengan Python: dari API spread ke alert Telegram

Ringkasan

  • Bot arbitrase kripto punya empat mata rantai: data spread, filter untuk pair yang bisa dieksekusi, alert, dan keputusan manusia. Kode menangani tiga yang pertama; transaksinya Anda lakukan sendiri di exchange.
  • Eksekusi adalah bagian tersulit arbitrase: memindahkan koin, biaya, slippage, dan waktu. Karena itu bot hanya menyimpan pair dengan withdrawal dan deposit yang terbuka, dan di Pro serta Max bot juga menghitung ulang spread lewat order book $1.000.
  • Bot memanggil Genesis API tidak lebih sering dari meta.freshness_sec, menunggu Retry-After saat 429 dan 503, dan mengirim alert untuk satu pair paling banyak sekali per 15 menit. Versi dasarnya berjalan di paket Trial seharga $20 per bulan.

Bot arbitrase kripto adalah program yang secara berkala mengambil spread antar exchange (selisih harga satu koin, dalam persen), menyimpan pair yang benar-benar bisa dieksekusi, dan memberi tahu Anda. Manusia yang memutuskan dan menempatkan transaksinya. Bot seperti ini untuk arbitrase spot antar exchange membutuhkan sekitar 140 baris Python: spread datang dari Genesis API, dan pesan dikirim lewat Telegram Bot API.

Apa saja isi bot arbitrase

Setiap bot arbitrase tersusun dari empat mata rantai:

Mata rantaiFungsinyaDi bot ini
DataMengambil harga dan spread antar exchangeGenesis API GET /arbitrage/spot-spot
FilterMenyimpan pair yang bisa dieksekusiStatus deposit dan withdrawal, Order-book Δ untuk $1.000
AlertMelaporkan pairMetode sendMessage Telegram Bot API
Keputusan dan transaksiMemeriksa pair dan bertransaksiManusia di exchange

Membuat kolektor data sendiri adalah mata rantai paling lambat: setiap exchange punya API sendiri, nama ticker dan jaringan sendiri, serta status deposit dan withdrawal sendiri, dan semuanya harus digabung ke satu format. Genesis API mengembalikan pair siap pakai di 20+ exchange CEX, termasuk Binance, OKX, Bybit, Bitget, MEXC, dan Gate, lengkap dengan harga, spread, jaringan, kontrak, status deposit dan withdrawal, serta volume. Kolom setiap endpoint arbitrase ada di panduan endpoint arbitrase Genesis API, dan cara memilih sumber data dibahas di API kripto: jenis dan cara memilihnya.

Mengapa transaksi tetap di tangan manusia

Menemukan spread adalah bagian mudah dari arbitrase. Eksekusi adalah bagian sulitnya: ada empat hambatan antara satu baris di respons API dan uang di akun Anda.

Contoh hipotetis: bot mengirim pair dengan spread 1,2%, yaitu $12 dari $1.000. Setelah menelusuri order book untuk $1.000, tersisa 0,8%, atau $8. Biaya taker 0,1% pada pembelian dan penjualan sekitar $2, dan withdrawal koin $3.

Kode yang membeli dan menarik koin sendiri mengubah setiap kegagalan ini menjadi transaksi yang tidak diperiksa siapa pun. Itu sebabnya bot ini hanya mengirim sinyal: bot memeriksa withdrawal, deposit, dan spread setelah order book sendiri, dan manusia memverifikasi kontrak, biaya, dan rute transfer sebelum bertransaksi. Genesis API memang tidak bisa bertransaksi: ia hanya membaca data dan tidak menempatkan order. Pemeriksaan manual pair langkah demi langkah ada di Arbitrase kripto antar exchange.

Yang Anda butuhkan

python3 --version   # butuh Python 3.10 atau lebih baru
python3 -m pip install requests

export GENESIS_API_KEY="gns_live_XXXXXXXXXXXXXXXX"
export TG_BOT_TOKEN="123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"

# setelah /start di chat bot, cari "chat":{"id":...} di balasan
curl "https://api.telegram.org/bot$TG_BOT_TOKEN/getUpdates"

export TG_CHAT_ID="123456789"

Variabel yang diatur dengan export bertahan sampai terminal ditutup. Menurut dokumentasi Telegram, token memberi kendali penuh atas bot, dan kunci memberi akses ke paket Anda, jadi keduanya hanya disimpan di variabel lingkungan: tidak pernah masuk ke kode atau repositori.

Kode bot langkah demi langkah

Tujuh blok di bawah ini adalah bot.py lengkap: simpan semuanya ke satu file sesuai urutan. Ambang di pengaturan hanyalah placeholder; sesuaikan dengan biaya dan ukuran transaksi Anda.

1. Pengaturan

import os
import time

import requests

API = "https://api.genesisarbitrage.com/v1"
TG = "https://api.telegram.org/bot" + os.environ["TG_BOT_TOKEN"]
CHAT_ID = os.environ["TG_CHAT_ID"]

MIN_SPREAD = 1.0      # spread baris mulai dari 1%
MIN_VOLUME = 50_000   # volume 24 jam di kedua exchange mulai dari $50.000
MIN_EXEC = 0.5        # spread setelah order book $1.000 mulai dari 0,5%
TOP = 5               # maksimal pair per putaran
REPEAT_SEC = 15 * 60  # satu pair paling banyak sekali per 15 menit
RECHECK_SEC = 5 * 60  # pair yang dimakan book menunggu 5 menit

api = requests.Session()
api.headers["X-API-Key"] = os.environ["GENESIS_API_KEY"]
cache = {}       # permintaan -> (ETag, respons)
wait_until = {}  # pair -> waktu sampai kapan tetap diam

Kunci dikirim di header X-API-Key pada setiap permintaan lewat sesi api dan tidak pernah masuk ke URL. MIN_VOLUME membuang pair yang volume 24 jamnya di salah satu exchange di bawah $50.000. cache menyimpan ETag respons, dan wait_until menyimpan waktu sampai kapan bot diam soal sebuah pair.

2. Memanggil Genesis API: Retry-After dan ETag

def get(path, params=None):
    """GET ke Genesis API dengan retry Retry-After dan ETag."""
    key = (path, tuple(sorted((params or {}).items())))
    for _ in range(4):  # satu permintaan dan maksimal tiga retry
        hdr = {"If-None-Match": cache[key][0]} if key in cache else {}
        r = api.get(API + path, params=params, headers=hdr,
                    timeout=15)
        if r.status_code == 304:  # snapshot tidak berubah
            return cache[key][1]
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # begini tampilan kuota yang habis
                raise SystemExit(f"Kuota habis: tunggu {wait} dtk")
            time.sleep(wait)
            continue
        r.raise_for_status()  # 400, 401, 403: retry tidak membantu
        body = r.json()
        if "ETag" in r.headers:  # hanya dataset penuh yang membawa ETag
            cache[key] = (r.headers["ETag"], body)
        return body
    raise RuntimeError("Genesis API sibuk, coba lagi di putaran berikutnya")

429 muncul saat Anda melewati rate limit per detik atau volume unduhan, dan 503 saat data sedang dibangun ulang. Keduanya membawa Retry-After, dan get menunggu sebanyak detik yang diminta server. Kuota yang habis juga mengembalikan 429, tetapi dengan Retry-After yang diisi waktu reset, kadang berhari-hari, sehingga bot berhenti. 400, 401, dan 403 tidak akan hilang dengan retry, jadi raise_for_status melemparkannya. Semua limit ada di panduan limit Genesis API.

3. Spread dan penyaringan pair

def candidates():
    """Pair Spot – Spot yang koinnya benar-benar bisa dipindahkan."""
    body = get("/arbitrage/spot-spot",
               {"min_spread": MIN_SPREAD, "min_volume": MIN_VOLUME})
    # withdrawal terbuka di sisi beli, deposit terbuka di sisi jual
    rows = [x for x in body["data"]
            if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
    rows.sort(key=lambda x: x["spread_pct"], reverse=True)
    return rows, body["meta"]["freshness_sec"]

min_spread dan min_volume menyaring baris di server. Tidak ada parameter untuk flag deposit dan withdrawal, jadi kode yang memeriksanya: koin bisa dipindahkan jika withdrawal terbuka di exchange beli (withdraw_enabled_buy) dan deposit terbuka di exchange jual (deposit_enabled_sell). Kolom yang dipakai bot, dalam satu baris dari dokumentasi Spot — Spot:

{
  "coin": "FUEL",
  "exchange_buy": "ByBit",
  "exchange_sell": "Gate",
  "spread_pct": 0.11,
  "network": "ETH",
  "contract": "0x675B68AA4d9c2d3BB3F0397048e62E6B7192079c",
  "withdraw_enabled_buy": true,
  "deposit_enabled_sell": true,
  "volume_24h_buy": 17652.64,
  "volume_24h_sell": 12512.51,
  "trade_url_buy": "https://www.bybit.com/trade/spot/FUEL/USDT",
  "trade_url_sell": "https://www.gate.io/trade/FUEL_USDT",
  …
}

Baris ini tidak akan lolos filter bot: spread 0,11% dan volume di bawah $50.000. Bot memasukkan jaringan dan kontrak ke pesan agar Anda bisa mencocokkannya dengan halaman withdrawal dan deposit kedua exchange.

4. Cek order book $1.000

def exec_spread(row):
    """Spread setelah order book $1.000. Hanya Pro dan Max."""
    body = get("/orderbooks/spreads/spot-spot",
               {"coin": row["coin"], "volume": 1000})
    for x in body["data"]:
        od = x["order_delta"]
        if (x["exchange_buy"] == row["exchange_buy"]
                and x["exchange_sell"] == row["exchange_sell"]
                and od["status"] == "ok"):
            return od["spread_pct"]
    return None  # no_book, exhausted, atau pair sudah hilang

Endpoint ini mengembalikan baris koin dari dataset Spot – Spot dengan objek order_delta — Order-book Δ, yaitu spread setelah menelusuri order book: membeli lewat ask exchange beli dan menjual ke bid exchange jual. Fungsi mengambil baris dengan exchange yang sama dan order_delta.spread_pct-nya ketika status adalah ok; no_book berarti tidak ada book, dan exhausted berarti book habis sebelum $1.000. Book tertinggal 5–20 detik dari exchange; kolomnya dijelaskan di dokumentasi Order-book Δ dan panduan endpoint order book.

Langkah ini hanya ada di Pro dan Max; di Trial dan Start endpoint mengembalikan 403 plan_restricted. Bot membaca paket Anda saat mulai dan melewati pengecekan di sana: pesan menyebut order book tidak diperiksa, dan Anda melihat kedalaman sendiri di terminal exchange.

5. Pesan Telegram

def message(row, ex):
    buy, sell = row["exchange_buy"], row["exchange_sell"]
    if ex is None:
        book = "order book tidak diperiksa (Trial atau Start)"
    else:
        book = f"setelah order book $1.000: {ex:.2f}%"
    return "\n".join([
        f'{row["coin"]}: {buy} → {sell}',
        f'Spread {row["spread_pct"]}%, {book}',
        f'Jaringan {row["network"]}, kontrak {row["contract"] or "—"}',
        f'Beli: {row["trade_url_buy"]}',
        f'Jual: {row["trade_url_sell"]}',
    ])


def send(text):
    """sendMessage Telegram Bot API; saat 429 tunggu retry_after."""
    for _ in range(3):
        r = requests.post(TG + "/sendMessage", timeout=15, json={
            "chat_id": CHAT_ID, "text": text,
            "link_preview_options": {"is_disabled": True}})
        if r.status_code != 429:
            r.raise_for_status()  # 400 atau 401: chat atau token salah
            return
        wait = r.json().get("parameters", {}).get("retry_after", 5)
        time.sleep(wait)  # flood control Telegram
    raise RuntimeError("Telegram tidak menerima pesan")

sendMessage menerima chat_id dan text sepanjang 1 sampai 4096 karakter, dan permintaan dikirim ke https://api.telegram.org/bot<token>/sendMessage (dokumentasi Telegram Bot API). link_preview_options dengan is_disabled mematikan pratinjau tautan. Saat kena flood control, Telegram mengembalikan 429 dan menaruh waktu tunggu, dalam detik, di parameters.retry_after. Dalam satu chat, Telegram meminta bot tidak mengirim lebih dari satu pesan per detik (FAQ pengembang bot).

Pesannya terlihat seperti ini, sebagai contoh hipotetis:

XYZ: MEXC → Gate
Spread 1.4%, setelah order book $1.000: 0.62%
Jaringan ETH, kontrak 0x…
Beli: https://…
Jual: https://…

6. Deduplikasi: satu pair per 15 menit

def scan(books):
    """Satu putaran: spread, order book, pesan."""
    rows, pause = candidates()
    done = 0
    for row in rows:
        key = (row["coin"], row["exchange_buy"], row["exchange_sell"])
        if time.time() < wait_until.get(key, 0):
            continue  # sudah dialert, atau book memakan spread
        if done == TOP:
            break
        done += 1
        ex = exec_spread(row) if books else None
        ok = not books or (ex is not None and ex >= MIN_EXEC)
        if ok:
            send(message(row, ex))
        # diam 15 menit setelah alert, 5 menit jika book tipis
        hold = REPEAT_SEC if ok else RECHECK_SEC
        wait_until[key] = time.time() + hold
        time.sleep(1)  # maksimal satu permintaan dan pesan per detik
    return pause

Satu pair adalah tripel koin, exchange beli, dan exchange jual. Setelah alert, bot diam soal pair itu selama 15 menit, bahkan jika spread bertahan. Jika book memakan spread, bot kembali ke pair itu dalam 5 menit, sehingga pengecekan order book tidak memakan satu panggilan di setiap putaran. Satu putaran mengambil paling banyak lima pair dengan spread terlebar dan berhenti sedetik setelah masing-masing: ini menjaga bot tetap sesuai saran Telegram dan di bawah limit per detik paket mana pun. Dictionary-nya hidup di memori, jadi pair segar bisa berulang setelah restart.

7. Loop: jeda minimal freshness_sec

def main():
    usage = get("/account/usage")["data"]  # tidak memakai kuota
    books = usage["plan"] in ("pro", "max")
    pause = usage["freshness_sec"]
    print("Paket", usage["plan"], "| polling tiap", pause, "dtk",
          "| order book:", "ya" if books else "tidak")
    while True:
        try:
            pause = scan(books)
        except requests.HTTPError as e:
            if e.response.status_code < 500:
                raise  # kunci, paket, atau token: retry tidak membantu
            print("Error server, mencoba lagi:", e)
        except (requests.RequestException, RuntimeError) as e:
            print("Tidak ada respons, mencoba lagi:", e)
        time.sleep(pause)  # tidak lebih sering dari meta.freshness_sec


if __name__ == "__main__":
    main()

Saat mulai, bot memanggil /account/usage: permintaan ini tidak memakai kuota dan mengembalikan paket Anda serta freshness_sec. Itu adalah kesegaran data, interval ketika paket Anda mendapat snapshot baru: 60 detik di Trial, 30 di Start, 10 di Pro, dan 5 di Max. Setelah itu jeda diambil dari meta.freshness_sec, karena polling lebih cepat mengembalikan snapshot yang sama. Kegagalan jaringan dan error 5xx menunggu putaran berikutnya, sedangkan error 4xx lainnya — kunci salah, langganan kedaluwarsa, paket tanpa endpoint itu, token atau chat_id salah — menghentikan bot. Kode error tercantum di respons dan error Genesis API, dan monitor spread tanpa Telegram dibuat di pelajaran Monitor spread dan funding rate dengan Python.

Cara menjalankan dan memeriksanya

python3 bot.py
# Paket trial | polling tiap 60 dtk | order book: tidak
  1. Tunggu putaran pertama

    Pesan datang ketika pasar punya pair di atas ambang Anda. Jika tidak ada yang datang dalam beberapa menit, turunkan MIN_SPREAD dan MIN_VOLUME untuk sementara: itu menunjukkan rantai dari API ke Telegram berfungsi.

  2. Bandingkan satu pair dengan tabel

    Buka Spot – Spot di situs: koin dan pasangan exchange yang sama ada di tabel. Angkanya bisa sedikit berbeda, karena API menyajikan snapshot dengan jeda sesuai paket Anda.

  3. Periksa deduplikasi

    Pair yang sama tidak boleh datang lagi dalam 15 menit.

  4. Pantau pemakaian panggilan

    Lihat kolom calls_used di /account/usage atau baris "Panggilan terpakai" di profil Anda: di Trial tanpa cek order book, bot memakai sekitar 1.440 panggilan per hari.

  5. Biarkan bot berjalan

    nohup python3 bot.py >> bot.log 2>&1 & menjalankan bot di latar belakang; atur variabel lingkungan di sesi terminal yang sama.

Paket Genesis API mana yang dibutuhkan bot

Satu putaran adalah satu panggilan /arbitrage/spot-spot, ditambah hingga lima panggilan /orderbooks/spreads/spot-spot di Pro dan Max; hanya respons 200 yang memakai kuota. Batas atas untuk 30 hari: (1 + pengecekan per putaran) × 86.400 / jeda × 30.

PaketPollingCek order book $1.000Panggilan per 30 hari
Trial, $20/bulanTiap 60 dtkTidak43.200 dari 500.000
Start, $50/bulanTiap 30 dtkTidak86.400 dari 2 juta
Pro, $100/bulanTiap 10 dtkYaHingga 1.555.200 dari 5 juta
Max, $200/bulanTiap 5 dtkYaHingga 3.110.400 dari 10 juta

Di Trial itu 86.400 / 60 × 30 = 43.200 panggilan, 8,64% dari kuota. Di Pro, pada kasus terburuk ketika setiap putaran mengecek lima book, hasilnya 6 × 86.400 / 10 × 30 = 1.555.200 panggilan, atau 31,1% dari kuota. Aturan kuota ada di bagian Paket & limit dalam dokumentasi.

Risiko bot arbitrase

Tanpa kode: alert Telegram Genesis Arbitrage

Jika Anda tidak mau menulis dan menjalankan bot sendiri, Alert Telegram Genesis Arbitrage mengirim pair untuk Anda. Anda membuat bot di @BotFather, menempelkan tokennya di situs, dan memilih kategori seperti Spot - Spot, DEX - Futures, Crosschain, dan Funding arbitrage. Filter menentukan spread minimum, exchange dan jaringan, status Deposit/Withdrawal, dan Order spread, sedangkan Waktu ulang (menit) membatasi seberapa sering satu pair kembali. Bot pribadi berjalan di paket Pro situs, terpisah dari paket Genesis API; pengaturannya ada di panduan notifikasi Telegram.

Tanya jawab

Apakah bot bisa bertransaksi sendiri?

Tidak lewat Genesis API: API hanya menyajikan data dan tidak menempatkan order. Transaksi ditambahkan lewat API exchange sendiri dengan kunci trading, yang merupakan kode terpisah dan risiko Anda sendiri: spread basi atau withdrawal yang tertutup menjadi transaksi yang tidak diperiksa siapa pun.

Berapa biaya bot seperti ini?

Kodenya gratis, begitu juga pesan bot ke pengguna Telegram. Anda membayar untuk data: Genesis API mulai dari $20 per bulan di Trial, dan cek order book mulai dari Pro seharga $100. Anda juga butuh komputer atau server yang menyala sepanjang waktu.

Paket Genesis API mana yang saya butuhkan?

Trial cukup untuk bot dasar: /arbitrage/spot-spot ada di setiap paket, dengan snapshot baru tiap 60 detik. Start memperbarui data tiap 30 detik. Cek Order-book Δ $1.000 hanya bekerja di Pro dan Max.

Mengapa bot mengirim pair yang spread-nya sudah habis di exchange?

Data tiba dengan jeda sesuai paket Anda, dan trader lain juga menutup selisihnya. Spread baris juga dihitung dari transaksi terakhir, sedangkan Anda hanya bisa membeli di ask dan menjual di bid. Periksa harga dan order book di terminal exchange sebelum bertransaksi.

Bolehkah saya menaruh bot di GitHub?

Boleh: ketentuan mengizinkan membangun bot sendiri di atas Genesis API, dan satu-satunya batasan adalah menjual ulang data mentah apa adanya. Jauhkan kunci dan token dari repositori. Jika kunci masuk ke kode publik, klik "Terbitkan ulang" di profil Anda, dan perintah /token di @BotFather mengganti token bot.