API endpoint
Endpoint adalah URL satu fungsi API tertentu: program memanggilnya untuk mendapat satu jenis data, misalnya spread Spot – Spot atau funding rate. Dokumentasi mencantumkan endpoint bersama metode HTTP-nya: GET /arbitrage/spot-spot.
Rincian URL
URL https://api.genesisarbitrage.com/v1/arbitrage/spot-spot?min_spread=0.5 dalam request curl:
BASE="https://api.genesisarbitrage.com/v1"
curl "$BASE/arbitrage/spot-spot?min_spread=0.5" \
-H "X-API-Key: $GENESIS_API_KEY"
| Bagian | Nilai |
|---|---|
| Base URL | https://api.genesisarbitrage.com/v1: server dan versi API |
| Path | /arbitrage/spot-spot: dataset Spot — Spot |
| Parameter query | min_spread=0.5: spread 0,5% atau lebih |
Request ini mengembalikan setup dengan spread 0,5% atau lebih: koin (coin), exchange beli dan jual (exchange_buy, exchange_sell), harga, spread_pct, serta flag deposit dan penarikan. Parameter lain endpoint ini, coin, exchange, dan min_volume, tercantum di bagian Spot — Spot.
Parameter path dan parameter query
Parameter path adalah bagian dari URL itu sendiri; dokumentasi menampilkannya dalam kurung kurawal. Pada /orderbooks/coin/{coin} Anda mengganti {coin} dengan ticker: /orderbooks/coin/BTC mengembalikan order book BTC di setiap exchange dan pasar (Order book koin).
Parameter query mengikuti tanda ? sebagai pasangan nama=nilai yang dipisahkan &. Satu URL bisa membawa keduanya: pada /orderbooks/spreads/spot-futures?coin=BTC&volume=5000 dataset spot-futures ada di path, sedangkan koin dan volume $5.000 adalah parameter query (Δ order book).
Error saat memanggil
| Respons | Penyebab |
|---|---|
404 not_found | Endpoint atau resource tidak ada |
400 bad_request | Parameter tidak valid, rinciannya di message |
403 plan_restricted | Endpoint tidak termasuk dalam paket Anda |
410 gone | Endpoint sudah dihentikan, penggantinya ada di message |
Daftar lengkap 35+ endpoint ada di dokumentasi dan di spesifikasi OpenAPI yang bisa dibaca mesin.
Lihat juga: REST API, JSON, endpoint arbitrase, endpoint order book.
Tanya jawab
Apa bedanya endpoint dengan API?
API adalah seluruh kumpulan fungsi sebuah layanan; endpoint adalah satu fungsi dengan URL-nya sendiri. Genesis API memiliki lebih dari 35 endpoint: arbitrase, order book, funding, pasar, on-chain, pasar prediksi, sinyal AI, dan pencarian koin.