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, menungguRetry-Aftersaat429dan503, 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 rantai | Fungsinya | Di bot ini |
|---|---|---|
| Data | Mengambil harga dan spread antar exchange | Genesis API GET /arbitrage/spot-spot |
| Filter | Menyimpan pair yang bisa dieksekusi | Status deposit dan withdrawal, Order-book Δ untuk $1.000 |
| Alert | Melaporkan pair | Metode sendMessage Telegram Bot API |
| Keputusan dan transaksi | Memeriksa pair dan bertransaksi | Manusia 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.
- Memindahkan koin: withdrawal dan deposit memakan waktu dari beberapa menit sampai beberapa jam, dan exchange bisa menangguhkan deposit atau withdrawal kapan saja.
- Biaya: kedua exchange memungut biaya trading, sedangkan biaya withdrawal biasanya berupa jumlah koin tetap yang memakan spread pada transaksi kecil.
- Slippage: spread dihitung dari transaksi terakhir, sementara market order menelusuri order book, sehingga pembelian terisi di atas ask terbaik dan penjualan di bawah bid terbaik.
- Waktu: data tiba dengan jeda sesuai paket Anda, hingga 60 detik di Trial, dan trader lain melihat selisih yang sama lalu menutupnya.
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
- Python 3.10 atau lebih baru dan pustaka
requests. - Kunci Genesis API dari paket mana pun: klik "Dapatkan kunci" di profil Anda dan simpan kunci
gns_live_…, yang hanya ditampilkan sekali. Penyimpanan dan penerbitan ulang dibahas di panduan kunci Genesis API. - Token bot Telegram: kirim
/newbotke @BotFather, pilih nama dan username, lalu BotFather membalas dengan token seperti123456:ABC-DEF…. chat_id, ID chat Anda dengan bot. Bot tidak bisa mengirim pesan lebih dulu (dokumentasi Telegram): kirim/startke bot, lalu panggilgetUpdates; angka di"chat":{"id":…}adalahchat_idAnda. Update disimpan paling lama 24 jam.
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
Tunggu putaran pertama
Pesan datang ketika pasar punya pair di atas ambang Anda. Jika tidak ada yang datang dalam beberapa menit, turunkan
MIN_SPREADdanMIN_VOLUMEuntuk sementara: itu menunjukkan rantai dari API ke Telegram berfungsi.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.
Periksa deduplikasi
Pair yang sama tidak boleh datang lagi dalam 15 menit.
Pantau pemakaian panggilan
Lihat kolom
calls_useddi/account/usageatau baris "Panggilan terpakai" di profil Anda: di Trial tanpa cek order book, bot memakai sekitar 1.440 panggilan per hari.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.
| Paket | Polling | Cek order book $1.000 | Panggilan per 30 hari |
|---|---|---|---|
| Trial, $20/bulan | Tiap 60 dtk | Tidak | 43.200 dari 500.000 |
| Start, $50/bulan | Tiap 30 dtk | Tidak | 86.400 dari 2 juta |
| Pro, $100/bulan | Tiap 10 dtk | Ya | Hingga 1.555.200 dari 5 juta |
| Max, $200/bulan | Tiap 5 dtk | Ya | Hingga 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
- Harga basi: snapshot diperbarui tiap
freshness_secdan order book tertinggal 5–20 detik dari exchange, jadi periksa harga di terminal exchange sebelum bertransaksi. - Jaringan tertutup: flag deposit dan withdrawal berlaku pada saat snapshot, dan exchange bisa menutup withdrawal saat Anda membeli. Satu ticker bisa berarti token berbeda di exchange berbeda, jadi cocokkan
contractdannetwork. - Biaya dan withdrawal:
spread_pcttidak menyertakannya, dan biaya withdrawal tetap memakan seluruh spread pada jumlah kecil. - Spread palsu di book tipis: spread transaksi terakhir yang lebar pada koin yang jarang diperdagangkan hilang bersama order pertama.
min_volumedan cek $1.000 menyaring sebagian pair seperti ini, tetapi tidak semuanya. - Kena limit: permintaan berlebih dalam satu detik mendapat
429denganRetry-After: 1, dan kuota yang habis menghentikan bot sampai reset. Memakai beberapa kunci atau akun untuk menghindari limit melanggar aturan; paket yang lebih tinggi tersedia untuk beban lebih berat. Telegram juga menjawab429saat flood control.
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.