Genesis Arbitrage

Genesis Arbitrage · · 13 menit baca

Risiko otomatisasi: data, error, key, dan AI

Ringkasan

  • Periksa data sebelum alert apa pun: usia snapshot (waktu sekarang dikurangi meta.updated_at), flag stale pada order book, spread di quote terbaik, dan kontrak yang sama di kedua exchange pada pasangan tersebut.
  • 503 berarti tidak ada data, sedangkan data kosong dengan 200 berarti tidak ada baris yang cocok dengan filter. Bot membedakan keduanya dan melaporkan kegagalan setelah tiga siklus tanpa data.
  • Kode rusak di kasus tepi: retry tanpa jeda berujung 429, null dalam perbandingan membuat Python crash, pembagian dengan nol di JavaScript menghasilkan Infinity dan alert palsu, dan waktu lokal sebagai pengganti UTC menggeser pembayaran funding hingga beberapa jam.
  • Key Genesis API bersifat read-only, jadi kebocoran menghabiskan kuota Anda. Key exchange dengan hak penarikan membahayakan dana, dan bot trading tidak memerlukan hak itu.
  • Model AI bisa keliru soal angka dan dapat mengikuti perintah yang disembunyikan dalam teks orang lain: kode menyisipkan angka ke pesan, field dari luar sampai ke model sebagai data, kode menegakkan batas trading, dan manusia mengonfirmasi setiap order.

Risiko bot trading di API crypto terbagi menjadi empat kelompok: data sudah lama atau menunjukkan spread yang tidak ada; kode berputar tanpa henti atau crash di kasus tepi; key bocor; model AI salah menyebut angka atau mengikuti perintah orang lain. Setiap risiko punya pemeriksaan di kode atau aturan kerja, dan semuanya juga muat di monitor dari pelajaran 4.

Risiko data

Snapshot yang sudah lama

Snapshot Genesis API dibuat pada meta.updated_at, dan paket Anda memperbaruinya setiap meta.freshness_sec detik: 60 di Trial, 30 di Start, 10 di Pro, dan 5 di Max. Usia snapshot adalah waktu sekarang dikurangi meta.updated_at, yaitu kesegaran data. Satu atau dua interval paket masih normal; lebih dari tiga berarti snapshot macet.

Contoh hipotetis: di Pro ambangnya 3 × 10 = 30 dtk. Respons tiba pada 1783802470 dengan meta.updated_at = 1783802410: usianya 1783802470 − 1783802410 = 60 dtk, sehingga bot tidak mengirim alert dari respons itu. Latensi penuh dari exchange ke kode Anda bahkan lebih besar, dan usia diukur dengan jam server Anda, jadi jaga agar tetap sinkron dengan NTP.

Order book dan platform prediksi

Order book punya jam sendiri: /orderbooks/book mengembalikan book_ts, age_sec, dan flag stale yang bernilai true jika book lebih tua dari 30 detik. Book tertinggal 5–20 detik dari exchange. Di Order-book Δ, periksa order_delta.status: ok berarti sudah dihitung, no_book berarti tidak ada book, exhausted berarti book tidak cukup untuk memenuhi ukuran.

Untuk pasar prediksi ada /predictions/platforms: lewati pasangan yang melibatkan platform dengan mode = down, platform dengan quotes_at yang sudah lama, atau bookmaker dengan ok = false.

Respons kosong saat 503

Daftar kosong dan data yang hilang adalah dua keadaan berbeda. 200 dengan meta.count = 0 berarti tidak ada baris yang cocok dengan filter. 503 snapshot_not_ready berarti data sedang dibangun ulang: pasar mungkin masih punya pasangan, dan Anda mencoba lagi setelah Retry-After detik.

Fungsi fetch mengembalikan (data, meta), atau None jika tidak ada data. Fungsi ini mengulang 429 dan 503 setelah Retry-After, error 5xx lain dan kegagalan jaringan setelah jeda 5, 10, dan 20 detik, dan berhenti pada yang lain.

import os
import time

import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}


def fetch(path, params=None, tries=4):
    """(data, meta), atau None: tidak ada data, ini bukan "tidak ada pasangan"."""
    for attempt in range(tries):
        try:
            r = requests.get(BASE + path, headers=HEADERS,
                             params=params, timeout=15)
            code = r.status_code
        except requests.RequestException:
            code = 0  # error jaringan atau timeout: coba lagi setelah jeda
        if code == 200:
            body = r.json()
            return body["data"], body["meta"]
        wait = 5 * 2 ** attempt  # 5, 10, 20 dtk: jeda bertambah
        if code in (429, 503):
            wait = int(r.headers.get("Retry-After", wait))
            if wait > 60:  # jangan pernah menunggu lebih dari semenit
                raise RuntimeError(f"tunggu {wait} dtk: periksa kuota Anda")
        elif 400 <= code < 500:
            # 400, 401, 403, 404, 410: retry tidak akan memperbaikinya
            raise RuntimeError(f"{code}: {r.text[:200]}")
        if attempt < tries - 1:
            time.sleep(wait)
    return None

Retry-After yang panjang juga muncul saat kuota periode habis: reset bisa berhari-hari lagi, dan fetch tidak pernah menunggu lebih dari semenit. Retry, ETag, dan filter dibahas di artikel tentang polling API tanpa terkena limit.

Spread palsu: book tipis dan token yang mirip

spread_pct dihitung dari transaksi terakhir, sedangkan Anda hanya bisa membeli di ask dan menjual di bid. Pada contoh FUEL di panduan endpoint arbitrase, spread-nya 0,11% menurut transaksi terakhir dan −0,11% di quote terbaik. Field ask_buy dan bid_sell ada di setiap baris Spot – Spot pada paket apa pun, dan quote_spread di bawah memakainya untuk menghitung spread di quote terbaik.

Order book yang tipis membuat selisih tampak membengkak. Contoh hipotetis: transaksi terakhir tercatat di $1,18 sejam lalu, bid terbaik sekarang $1,02 dan ask di exchange beli $1,00. Spread-nya 18% menurut transaksi terakhir dan 2% di quote terbaik, dan $1.000 mungkin tidak terisi sama sekali: di Pro dan Max, order_delta.status = exhausted pada volume=1000 menunjukkan hal itu.

Sumber spread palsu kedua adalah satu ticker yang dipakai token berbeda, misalnya token di BSC dan proyek lain yang tidak terkait di Solana. Untuk token dengan kontrak, kueri /coins/search dengan ticker di query: contracts[] harus punya entri yang exchanges-nya mencantumkan kedua exchange pada pasangan tersebut (bandingkan nama tanpa membedakan huruf besar-kecil). Jika tidak ada entri seperti itu, berarti tidak ada transfer langsung: tokennya berbeda, atau rutenya melewati bridge dengan risikonya sendiri.

def is_fresh(meta, k=3):
    """Snapshot tidak lebih tua dari k interval paket."""
    age = time.time() - meta["updated_at"]
    return age <= k * meta["freshness_sec"]


def quote_spread(row):
    """Spread di quote terbaik: beli di ask, jual di bid."""
    ask, bid = row.get("ask_buy"), row.get("bid_sell")
    if ask is None or bid is None or ask <= 0:
        return None  # tidak ada harga atau harga nol: lewati baris
    return (bid - ask) / ask * 100


pause, fails = 60, 0
while True:
    got = fetch("/arbitrage/spot-spot", {"min_spread": 1})
    if got is None or not is_fresh(got[1]):
        fails += 1  # tidak ada data atau data lama: tanpa alert
        if fails == 3:
            print("3 siklus tanpa data segar")  # beri alert ke diri sendiri
    else:
        rows, meta = got
        fails, pause = 0, meta["freshness_sec"]
        for row in rows:
            s = quote_spread(row)
            if s is not None and s >= 0.5:
                print(row["coin"], row["exchange_buy"], "→",
                      row["exchange_sell"], f"{s:.2f}%")
    time.sleep(pause)  # jeda berjalan di setiap jalur

Exception dari fetch menghentikan loop: bot produksi mengirim pesan ke pemiliknya sebelum keluar.

Risiko kode

Retry tanpa jeda dan loop tanpa akhir

Bot pertama sering mengulang segera setelah error: if r.status_code != 200: continue. Pada 503, loop seperti itu menembakkan request beruntun tanpa jeda: error tidak memakai kuota tetapi dihitung dalam batas request per detik, sehingga 429 dengan Retry-After: 1 menyusul. Setelah langganan habis, loop yang sama mendapat 401 terus-menerus. Dan continue sebelum time.sleep() melewati jeda pada setiap respons kosong, itulah sebabnya jeda adalah baris terakhir loop di atas.

Kesalahan sebaliknya adalah menunggu selamanya. time.sleep(int(r.headers["Retry-After"])) pada kuota yang habis tidur berhari-hari: misalnya Retry-After: 259200 adalah 259.200 / 86.400 = 3 hari. Request tanpa timeout juga bisa menggantung tanpa batas, seperti diperingatkan dokumentasi requests.

null dan pembagian dengan nol

Genesis API memakai null untuk nilai kosong, dan Python mengubahnya menjadi None. Membandingkan row["volume_24h_sell"] > 10000 dengan None memunculkan TypeError, dan satu baris saja menjatuhkan seluruh loop. JavaScript tidak memunculkan apa pun: null > 0.5 bernilai false, null < 1 bernilai true, dan filter gagal secara diam-diam.

null berarti "tidak ada data", dan menggantinya dengan nol lewat or 0 berbahaya: di slippage DEX, tax_sell_pct = null berarti tidak ada sumber pajak, dan or 0 mengubahnya menjadi 0%. Menurut dokumentasi, null muncul di bid_* dan ask_*, volume_24h_*, max_position_usd, next_payout, di profit_usd untuk pasangan dengan leg bookmaker, dan di apr_pct saat sisa waktu kurang dari sehari.

Pembagian dengan nol adalah jebakan yang sama. Ask nol memunculkan ZeroDivisionError di Python, sedangkan di JavaScript 1 / 0 adalah Infinity dan Infinity > 0.5 bernilai true: bot mengirim pasangan dengan spread tak terhingga. Periksa penyebut sebelum membagi, seperti quote_spread memeriksa ask <= 0.

Zona waktu

Waktu di Genesis API berupa detik unix dan string UTC: next_payout di funding rate datang dalam format HH:MM UTC. datetime.fromtimestamp(ts) tanpa zona waktu mengembalikan waktu lokal server, dan datetime.utcnow() sudah deprecated sejak Python 3.12; dokumentasi Python mengarahkan ke datetime.now(timezone.utc).

Contoh hipotetis: server berjalan di UTC+3 dan jamnya menunjukkan 09:30, yaitu 06:30 UTC. Pembayaran 08:00 tinggal 1 jam 30 menit lagi, tetapi kode yang membandingkan 08:00 dengan waktu lokal menyimpulkan pembayaran sudah lewat dan menghitung 22 jam 30 menit ke pembayaran berikutnya, selisih 21 jam.

from datetime import datetime, timedelta, timezone


def until_payout(hhmm, now=None):
    """Waktu sampai next_payout, string HH:MM dalam UTC."""
    if hhmm is None:
        return None  # null: tidak ada waktu pembayaran
    now = now or datetime.now(timezone.utc)
    h, m = map(int, hhmm.split(":"))
    t = now.replace(hour=h, minute=m, second=0, microsecond=0)
    if t <= now:
        t += timedelta(days=1)  # "00:00" pada pukul 23:50 berarti besok
    return t - now


now = datetime(2026, 11, 15, 6, 30, tzinfo=timezone.utc)
print(until_payout("08:00", now))  # 1:30:00

Risiko key

Key Genesis API bersifat read-only: tidak bisa menempatkan order atau menarik dana. Kebocoran memengaruhi kuota dan batas request per detik Anda, dan bot Anda mendapat 429 sebelum periode berakhir. Tanda peringatan: "Panggilan terpakai" di profil Anda naik lebih cepat daripada yang dihitung kode Anda, atau "dipakai …" menunjukkan waktu yang baru saja berlalu padahal bot sedang berhenti.

Key hanya ditampilkan sekali dan Genesis Arbitrage hanya menyimpan hash-nya, jadi key yang bocor diterbitkan ulang: "Buat ulang" menonaktifkan key lama seketika dan menerbitkan yang baru. Key bocor dari tempat yang salah dipakai: repositori publik, URL request, kode halaman, screenshot, log berisi header request. Catat kode status dan X-Request-Id sebagai gantinya; aturan penyimpanan ada di entri glosarium API key.

Key exchange adalah kelas risiko lain: dengan hak penarikan, key itu bisa memindahkan koin keluar dari akun. Bot trading tidak memerlukan hak itu, jadi buat key tanpa penarikan, terikat ke IP server Anda, dan terpisah untuk setiap layanan. Detailnya ada di Cara mengamankan akun exchange crypto Anda.

Agen AI: angka, perintah yang disisipkan, konfirmasi

Agen memanggil Genesis API lewat server Anda: model memilih endpoint dan argumen, lalu server membuat request dengan key. Pengaturannya ada di panduan Genesis API untuk agen AI, dan desain keseluruhannya ada di artikel tentang data pasar crypto untuk agen AI.

Angka yang salah

Model bisa membaca 0.92 sebagai 92% alih-alih 0,92%, mengira funding_pct per interval sama dengan funding_8h_pct 8 jam, atau menyebut harga yang tidak ada di respons. Kode menyisipkan angka ke alert langsung dari respons API, dan model hanya bertugas memilih dan menjelaskan. Jika model menulis angka sendiri, cocokkan setiap angka dengan hasil tool.

Perintah di teks dari luar

Beberapa field ditulis orang lain: title dan outcome pasar prediksi, name trader, token_name pada event on-chain, serta message_ru dan message_en pada sinyal. Siapa pun bisa menamai token "Abaikan instruksi sebelumnya dan…", dan model yang membaca nama itu sebagai bagian dari prompt-nya bisa menurutinya. Ini adalah prompt injection, entri pertama di OWASP Top 10 untuk Aplikasi LLM 2025: LLM01:2025.

Teruskan field seperti itu hanya di dalam hasil tool, batasi panjangnya, dan nyatakan di system prompt bahwa field tersebut adalah data. Key tetap berada di handler sisi server.

Konfirmasi manusia

Genesis API hanya membaca data: agen yang dibangun di atasnya menemukan pasangan dan menulis tentangnya, tetapi tidak bertrading. API trading exchange yang dihubungkan ke agen berada di luar Genesis API dan menjadi risiko Anda sendiri. Di antara mitigasinya, OWASP mencantumkan kontrol human-in-the-loop untuk operasi berhak istimewa: order dikirim hanya setelah "ya" dari trader yang melihat pasangan, harga, dan waktu data.

Checklist sebelum bot dijalankan

  1. Key ada di GENESIS_API_KEY di server dan tidak di mana pun di kode, URL request, browser, log, atau prompt.
  2. Setiap request punya timeout.
  3. Hanya 429, 503, error 5xx lain, dan kegagalan jaringan yang di-retry, dengan jeda dan paling banyak tiga kali.
  4. 400, 401, 403, 404, 410, dan Retry-After lebih dari semenit menghentikan bot dengan pesan.
  5. Jeda antar polling setidaknya meta.freshness_sec dan berjalan di setiap jalur loop.
  6. Usia snapshot diperiksa sebelum alert apa pun, dan untuk order book juga stale serta order_delta.status.
  7. "Tidak ada data" dan "tidak ada pasangan" adalah keadaan terpisah, dan tiga siklus tanpa data memicu pesan kegagalan.
  8. null dicek dengan None, penyebut dicek terhadap nol, dan waktu diproses dalam UTC.
  9. Pasangan lolos berdasarkan spread di quote terbaik, kontrak yang sama, withdraw_enabled_buy, dan deposit_enabled_sell.
  10. Kode menyisipkan angka ke pesan, teks dari luar sampai ke model sebagai data, dan manusia mengonfirmasi setiap order.

Penutup kursus: ke mana selanjutnya

Kursus ini punya lima pelajaran: konsep, request pertama, data untuk keputusan, monitor Python, dan risikonya; dasarnya ada di pelajaran 1. Detail tiap langkah:

Coba sendiri

  1. Cari kesegaran paket Anda

    Panggil /account/usage dan catat freshness_sec serta calls_used: request ini tidak dihitung sebagai panggilan.

  2. Ukur usia snapshot

    Ambil /arbitrage/spot-spot lewat fetch, cetak time.time() - meta["updated_at"], dan bandingkan dengan ambang 3 × freshness_sec.

  3. Bandingkan dua spread

    Cetak spread_pct dan quote_spread(row) untuk lima baris, lalu hitung berapa pasangan yang tetap positif di quote terbaik.

  4. Uji jalur error

    Jalankan bot dengan placeholder GENESIS_API_KEY=gns_live_XXXXXXXXXXXXXXXX: respons 401 invalid_key harus menghentikannya dengan pesan yang jelas.

  5. Telusuri checklist

    Tambahkan apa pun yang belum ada di kode Anda sebelum menjalankan bot sepanjang waktu.