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 API | Yang diberikan | Kapan dibutuhkan |
|---|---|---|
| API exchange | Harga, order book, dan trade satu exchange; order dengan key | Trading di exchange itu, stream trade satu pair |
| API data pasar | Banyak exchange dalam satu format, spread siap pakai | Membandingkan exchange, scanner, alert |
| API on-chain | Transaksi, transfer, saldo, event kontrak | Whale, arus exchange, unlock |
| API DEX | Harga dan likuiditas pool, swap, slippage | Token yang tidak ada di CEX, setup DEX – CEX |
| Data derivatif | Funding, open interest, harga futures | Arbitrase funding, kemiringan posisi |
| API prediction market dan odds | Harga YES dan NO, order book, odds bandar | Arbitrase 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.
| Kriteria | Yang diperiksa |
|---|---|
| Cakupan platform dan chain | Exchange Anda, spot dan futures, DEX, dan chain |
| Kesegaran dan latensi | Waktu pembuatan di respons, langkah refresh, usia order book |
| Normalisasi field | Ticker, satuan, persentase, dan waktu yang konsisten |
| Status deposit dan penarikan | Flag deposit dan penarikan per exchange dan jaringan |
| Kedalaman order book | Harga eksekusi untuk ukuran Anda |
| Rate limit dan kuota | Request per detik, panggilan per periode, apa yang dihitung sebagai panggilan |
| Harga | Paket atau bayar per panggilan, apa yang terjadi saat melewati limit |
| Dokumentasi dan OpenAPI | Contoh request dan respons, spesifikasi |
| Ketentuan penggunaan data | Boleh 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.
| Tugas | Kode sendiri di atas API exchange | Genesis API |
|---|---|---|
| Menempatkan order | Satu-satunya cara: API trading exchange | Tidak, read-only |
| Setiap trade satu pair | WebSocket exchange | Tidak, snapshot setiap 60–5 dtk |
| Spread di 20+ exchange | Hingga 40 konektor plus penggabungan | Satu request |
| Status deposit dan penarikan | Satu endpoint per exchange, dengan key di Binance | Field di baris setup |
| DEX, on-chain, prediction market | Node, indexer, API platform | Format 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.
| Data | Contoh endpoint | Paket API |
|---|---|---|
| Spread CEX | /arbitrage/spot-spot | Semua |
| DEX dan cross-chain | /arbitrage/dex-spot | Pro, Max |
| Order book | /orderbooks/exec | Pro, Max |
| Funding dan OI | /funding/rates | Semua |
| On-chain | /onchain/{section} | Start, Pro, Max |
| Prediction market dan surebet | /predictions/arbitrage | Start: 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.
| Paket | Panggilan per bulan | Request per detik | Kesegaran |
|---|---|---|---|
| Trial, $20/bln | 500K | 1 | 60 dtk |
| Start, $50 | 2M | 2 | 30 dtk |
| Pro, $100 | 5M | 5 | 10 dtk |
| Max, $200 | 10M | 15 | 5 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).