Genesis Arbitrage

Genesis Arbitrage · · 14 menit baca

API kripto: jenis API data pasar kripto dan cara memilihnya untuk trading

Ringkasan

  • API kripto memberi kode Anda data pasar: harga, order book, funding rate, transaksi on-chain, dan kuotasi prediction market. API exchange mencakup satu platform dan menerima order dengan key; API data pasar menggabungkan banyak platform dalam satu format.
  • Pilih API berdasarkan sembilan kriteria: cakupan platform dan chain, kesegaran data, normalisasi field, status deposit dan penarikan, kedalaman order book, rate limit, harga, dokumentasi, dan ketentuan penggunaan data.
  • Genesis API adalah REST API read-only: CEX, DEX, on-chain, prediction market, dan surebet sportsbook dalam satu format JSON, dengan paket mulai dari $20 per bulan. Tidak menempatkan order.

API kripto adalah antarmuka pemrograman yang dipakai kode untuk membaca data pasar kripto atau mengirim order ke exchange: harga, order book, funding rate, transaksi blockchain, kuotasi prediction market. Jenis API dibedakan menurut cakupannya: API exchange hanya mengenal satu platform dan menerima order dengan key, API data pasar menggabungkan banyak platform dalam satu format, dan API on-chain membaca blockchain.

Jenis-jenis API kripto

Jenis APIYang diberikanKapan dibutuhkan
API exchangeHarga, order book, dan trade satu exchange; order dengan keyTrading di exchange itu, stream trade satu pair
API data pasarBanyak exchange dalam satu format, spread siap pakaiMembandingkan exchange, scanner, alert
API on-chainTransaksi, transfer, saldo, event kontrakWhale, arus exchange, unlock
API DEXHarga dan likuiditas pool, swap, slippageToken yang tidak ada di CEX, setup DEX – CEX
Data derivatifFunding, open interest, harga futuresArbitrase funding, kemiringan posisi
API prediction market dan oddsHarga YES dan NO, order book, odds bandarArbitrase prediction market, surebet

API exchange

API exchange kripto adalah antarmuka satu platform, dan terdiri dari dua bagian. Bagian publik menyajikan data pasar tanpa key: di Binance, endpoint ini bertipe keamanan NONE, dan GET /api/v3/ticker/price mengembalikan harga sebuah pair. Bagian privat — order, saldo, riwayat trade — memerlukan API key dan tanda tangan request; di Binance ini adalah tipe TRADE dan USER_DATA (dokumentasi Binance).

API semacam ini mencakup satu exchange: untuk membandingkan harga sebuah koin di 20 exchange, Anda butuh 20 koneksi dengan format dan limit yang berbeda.

API data pasar

API data pasar mengumpulkan data dari banyak exchange, menormalkannya, dan mengembalikannya dalam satu request. Responsnya sudah berisi apa yang dibutuhkan untuk menggabungkan platform: spread antar exchange, funding rate yang dinormalkan ke satu periode, open interest per exchange.

API on-chain

API on-chain membaca blockchain: transaksi, transfer token, saldo alamat, event smart contract. Lapisan paling bawah adalah node jaringan: setiap klien Ethereum berbicara JSON-RPC, di mana eth_getBalance mengembalikan saldo dalam wei sebagai angka heksadesimal dan eth_getLogs mengembalikan event kontrak yang cocok dengan filter.

Node tidak tahu alamat mana yang milik exchange, tim, atau whale; indexer dan layanan analitik on-chain menambahkan label tersebut. Data apa yang dibutuhkan trader dibahas di API data on-chain.

API DEX

API DEX menyajikan harga dan likuiditas pool di exchange terdesentralisasi, swap, dan slippage. Semakin besar swap dibanding likuiditas pool, semakin jauh harga bergeser, sehingga setup DEX – CEX memerlukan slippage untuk ukuran Anda, dan token baru memerlukan pajak token serta pemeriksaan honeypot. Selengkapnya di API DEX.

Data derivatif: funding dan open interest

Perpetual futures membutuhkan funding rate, open interest (volume posisi terbuka), dan harga futures di samping spot. Exchange menyelesaikan funding setiap 8, 4, atau 1 jam, sehingga rate dibandingkan setelah dinormalkan ke satu periode. Selengkapnya di API funding rate dan API open interest.

API prediction market dan odds

Platform prediksi menyajikan harga kontrak YES dan NO serta order book. Di Polymarket, data pasar publik tidak memerlukan kredensial, sedangkan order memerlukan autentikasi dan tanda tangan wallet (dokumentasi Polymarket).

Formatnya juga berbeda di sini: order book Kalshi hanya berisi bid, dan ask YES adalah $1 dikurangi bid NO terbaik, jadi bid NO $0,56 berarti ask YES $0,44 (dokumentasi Kalshi). Odds bandar dibandingkan dengan harga YES dan NO lewat probabilitas tersirat — lihat API Polymarket dan API Kalshi serta API odds olahraga.

REST dan WebSocket

REST API menjawab request dengan snapshot yang difilter sesuai keinginan Anda, dan pembaruan didapat lewat polling berkala.

WebSocket menjaga koneksi tetap terbuka, dan server mendorong setiap trade serta perubahan order book. Sebagai gantinya, Anda harus memproses stream tanpa celah, menyambung ulang setelah putus, dan membangun ulang book dari snapshot ditambah update, dan Kalshi mewajibkan autentikasi untuk terhubung bahkan ke channel publik. Reaksi di bawah satu detik memerlukan WebSocket; scanner dan alert di 20+ exchange berjalan lewat REST.

Genesis API hanya REST, tanpa WebSocket dan tanpa webhook: setiap request adalah GET, respons dikompresi gzip dalam format JSON, dan data diperbarui setiap meta.freshness_sec detik. Mengulang request set penuh tanpa filter dengan ETag sebelumnya di If-None-Match akan mengembalikan 304 tanpa body jika tidak ada yang berubah, dan respons itu tidak memakai kuota. Pola polling ada di Praktik terbaik polling API.

Cara memilih API kripto: checklist

Enam kriteria pertama terlihat di respons API yang berjalan; sisanya ada di dokumentasi dan halaman harga.

KriteriaYang diperiksa
Cakupan platform dan chainExchange Anda, spot dan futures, DEX, dan chain
Kesegaran dan latensiWaktu pembuatan di respons, langkah refresh, usia order book
Normalisasi fieldTicker, satuan, persentase, dan waktu yang konsisten
Status deposit dan penarikanFlag deposit dan penarikan per exchange dan jaringan
Kedalaman order bookHarga eksekusi untuk ukuran Anda
Rate limit dan kuotaRequest per detik, panggilan per periode, apa yang dihitung sebagai panggilan
HargaPaket atau bayar per panggilan, apa yang terjadi saat melewati limit
Dokumentasi dan OpenAPIContoh request dan respons, spesifikasi
Ketentuan penggunaan dataBoleh tidaknya membangun produk sendiri di atas data

Cakupan dan kesegaran

Periksa cakupan terhadap daftar Anda sendiri: jika bot Anda bekerja dengan MEXC dan Gate, API yang tidak memiliki salah satunya tidak cocok. Kesegaran data adalah berapa detik yang telah berlalu sejak snapshot dibuat; latensi adalah seluruh jalur dari trade di exchange hingga kode Anda. Pada snapshot berumur semenit, bot melihat spread yang sudah hilang.

Normalisasi field

Pair BTC/USDT yang sama ditulis berbeda di API exchange: BTCUSDT di Binance, BTC-USDT di OKX (perpetual-nya BTC-USDT-SWAP), BTC_USDT di Gate. Binance mengembalikan harga sebagai string ("price": "4.00000200" pada contoh di dokumentasinya) dan waktu dalam milidetik. Kode Anda harus menangani setiap perbedaan ini.

API data pasar menyeragamkan field, seperti pada entri /funding/rates dari dokumentasi Genesis API ini:

{
  "coin": "TON",
  "exchanges": [
    {
      "exchange": "MEXC",
      "funding_pct": 0.02,
      "funding_8h_pct": 0.04,
      "next_payout": "00:00",
      "interval": "4h",
      "price": 2.184,
      "trade_url": "https://futures.mexc.com/exchange/TON_USDT"
    }
  ]
}

MEXC menyelesaikan funding koin ini setiap 4 jam, dan rate 0,02% per interval dinormalkan ke 8 jam di funding_8h_pct: 0,02 × 8 / 4 = 0,04% (lihat Funding rate).

Status deposit dan penarikan

Setup spot antar exchange hanya dapat dieksekusi jika koin bisa ditarik dari exchange beli dan di-deposit ke exchange jual. Di Binance, status jaringan berasal dari GET /sapi/v1/capital/config/getall, endpoint USER_DATA bertanda tangan yang memerlukan API key akun Anda (dokumentasi Binance). Di Genesis API, status tersebut datang di setiap baris Spot – Spot sebagai withdraw_enabled_buy dan deposit_enabled_sell (dokumentasi Spot — Spot).

Kedalaman order book

Spread pada harga terbaik menunjukkan selisih di puncak book, sedangkan trade $5.000 menyapu beberapa level kedalaman pasar. Pada contoh di dokumentasi Genesis API untuk /orderbooks/spreads/spot-futures, spread BTC adalah 0,031% pada harga terbaik dan 0,0202% setelah menyapu book untuk $5.000. Endpoint Harga eksekusi mengembalikan harga eksekusi untuk $500–10.000; selengkapnya di API order book kripto.

Limit, harga, dan dokumentasi

Limit dihitung dengan cara berbeda. Di Binance, setiap endpoint punya bobot, request untuk banyak simbol bobotnya lebih besar, dan IP yang terus mengirim request setelah 429 diblokir selama 2 menit hingga 3 hari (limit Binance). Untuk API data, periksa kuota panggilan, rate limit per detik, dan apa yang dihitung sebagai panggilan: di Genesis API hanya respons 200 yang memakai kuota.

Harga berupa paket dengan kuota atau bayar per panggilan; cari tahu apa yang terjadi saat melewati limit — error 429 atau biaya tambahan. Spesifikasi OpenAPI adalah deskripsi API yang dapat dibaca mesin untuk membuat klien dan menghubungkan agen AI, dan ketentuan penggunaan menjelaskan apakah Anda boleh membangun produk di atas data tersebut dan apa yang tidak boleh dijual kembali.

Pemeriksaan dengan satu request

Skrip ini mengambil set Spot – Spot penuh (tersedia di setiap paket Genesis API) dan memakai satu respons untuk memeriksa cakupan, usia snapshot, dan porsi setup yang bisa ditransfer:

import os
import time

import requests

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

r = requests.get(BASE + "/arbitrage/spot-spot",
                 headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]

# Coverage: which exchanges appear in the setups
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("exchanges in response:", len(venues), sorted(venues))

# Freshness: snapshot age and the plan's refresh step
age = time.time() - meta["updated_at"]
print(f"snapshot {age:.0f} s old, plan step {meta['freshness_sec']} s")

# Transfer: withdrawals open on the buy side, deposits on the sell side
ok = [x for x in rows
      if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"transferable setups: {len(ok)} of {len(rows)}")

Retry untuk 429 dan 503 berasal dari fungsi get_json di Respons dan error Genesis API. Setelah itu periksa harga dan status 3–5 setup di exchange lewat trade_url_buy dan trade_url_sell.

Bangun sendiri atau pakai API siap pakai

Untuk satu atau dua exchange plus trading, kode sendiri di atas API mereka adalah pilihan yang wajar. Untuk 20 exchange dengan spot dan futures, itu berarti hingga 40 konektor data pasar: di Binance, spot dan futures USDⓈ-M adalah API terpisah, api.binance.com dan fapi.binance.com. Setiap konektor membawa snapshot REST, stream WebSocket dengan reconnect, limit dan format simbolnya sendiri, dan di atasnya ada penggabungan: koin dicocokkan berdasarkan kontrak dan jaringan, karena satu ticker bisa berupa token berbeda di exchange berbeda.

TugasKode sendiri di atas API exchangeGenesis API
Menempatkan orderSatu-satunya cara: API trading exchangeTidak, read-only
Setiap trade satu pairWebSocket exchangeTidak, snapshot setiap 60–5 dtk
Spread di 20+ exchangeHingga 40 konektor plus penggabunganSatu request
Status deposit dan penarikanSatu endpoint per exchange, dengan key di BinanceField di baris setup
DEX, on-chain, prediction marketNode, indexer, API platformFormat JSON yang sama

Pendekatannya bisa digabung: API data menemukan setup, dan trade dibuka di exchange secara manual atau lewat API trading-nya dengan key tanpa hak penarikan (lihat Cara mengamankan akun exchange kripto Anda). Bot dengan alert Telegram dibangun di Bot arbitrase kripto dengan Python.

Posisi Genesis API

Genesis API adalah REST API untuk data Genesis Arbitrage: CEX, DEX, on-chain, prediction market, dan surebet sportsbook dalam satu format JSON, dengan key di header X-API-Key. API ini menyajikan data yang sama dengan yang dipublikasikan situs lewat 35+ endpoint (37 operasi dalam spesifikasi) dan hanya membaca data.

DataContoh endpointPaket API
Spread CEX/arbitrage/spot-spotSemua
DEX dan cross-chain/arbitrage/dex-spotPro, Max
Order book/orderbooks/execPro, Max
Funding dan OI/funding/ratesSemua
On-chain/onchain/{section}Start, Pro, Max
Prediction market dan surebet/predictions/arbitrageStart: exact, dutch; Pro, Max: llm, sport

Cakupan: 20+ exchange CEX (Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, Kraken, WhiteBit, Coinbase, CoinW, edgeX, HTX, Hyperliquid, dan lainnya), funding untuk 1000+ koin yang dinormalkan ke 8 jam, open interest di 13+ exchange futures. Prediction market adalah Polymarket, Kalshi, Limitless, Predict.fun, dan Opinion; mode sport membangun surebet sportsbook di 13 platform, hanya pre-match.

PaketPanggilan per bulanRequest per detikKesegaran
Trial, $20/bln500K160 dtk
Start, $502M230 dtk
Pro, $1005M510 dtk
Max, $20010M155 dtk

Paket API terpisah dari langganan situs; Anda membayar dengan kripto, dengan diskon 10% untuk 3 bulan dan 20% untuk 6 bulan. Jika melewati limit, server mengembalikan 429 dan tidak menagih apa pun, dan endpoint di luar paket Anda mengembalikan 403 plan_restricted. Bandingkan paket di Harga Genesis API; aturannya ada di Paket & limit.

Setiap bagian dokumentasi punya URL sendiri dengan parameter, field, contoh curl, dan formulir Coba sekarang. Untuk program dan agen AI tersedia spesifikasi OpenAPI 3.1 dan referensi llms-full.txt; pengaturannya dibahas di Genesis API untuk agen AI. Anda dapat membangun layanan, bot, dan dasbor sendiri di atas Genesis API; Anda tidak boleh menjual kembali data mentah apa adanya.

Request pertama — paket, key di profil Anda, dan GET dengan X-API-Key — dibahas di mulai cepat, dan dasarnya di pelajaran Apa itu API kripto dan apa yang bisa Anda otomatisasi. Tanpa kode, data yang sama ada di tabel situs dan di alert Telegram.

Tanya jawab

Apakah ada API kripto gratis?

Ya: API exchange publik menyajikan harga, order book, dan trade secara gratis dan tanpa key (di Binance, endpoint NONE), tetapi masing-masing hanya mencakup satu exchange. Genesis API tidak punya paket gratis: Trial seharga $20 per bulan untuk 500K panggilan.

Apakah saya butuh SDK untuk memakai API kripto?

Untuk REST API, klien HTTP sudah cukup: curl, requests di Python, atau fetch di JavaScript. Genesis API tidak punya SDK resmi, dan setiap request adalah GET dengan satu header; Anda dapat membuat klien bertipe dari spesifikasi OpenAPI 3.1.

Bisakah saya trading lewat API data pasar?

Tidak jika API-nya read-only, seperti Genesis API: API ini menemukan setup tetapi tidak menempatkan order. Order dilakukan lewat exchange, secara manual atau lewat API trading-nya dengan key dan tanda tangan (di Binance, endpoint TRADE), yang berada di luar Genesis API dan menjadi risiko Anda sendiri.

Bagaimana cara mendapatkan harga kripto dari API?

Endpoint publik exchange mengembalikan harga sebuah pair di exchange tersebut: di Binance itu GET /api/v3/ticker/price, dan harganya berupa string. Harga sebuah koin di setiap exchange, beserta status deposit dan penarikan, didapat dari /coins/search?query=BTC di Genesis API (lihat Pencarian koin).