JSON
JSON (JavaScript Object Notation) adalah format teks untuk pertukaran data, tempat nilai dikelompokkan dalam objek dengan kurung kurawal dan array dengan kurung siku. Formatnya diatur dalam RFC 8259 dan standar ECMA-404, dengan media type application/json. Genesis API juga merespons dalam JSON.
Tipe nilai
| Tipe | Contoh | Di Python |
|---|---|---|
| Objek | {"coin": "BTC"} | dict |
| Array | [0.11, 0.45] | list |
| String | "ByBit" | str |
| Angka | 214, 0.92 | int, float |
| Boolean | true, false | True, False |
| Nilai kosong | null | None |
Nama field dan string hanya memakai tanda kutip ganda. JSON tidak punya komentar, dan koma setelah elemen terakhir membuat dokumen tidak valid.
Respons Genesis API
Contoh hipotetis respons endpoint /arbitrage/spot-spot: satu baris, beberapa field dihilangkan.
{
"success": true,
"data": [
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"spread_pct": 0.11,
"deposit_enabled_buy": true,
"volume_24h_sell": null
}
],
"meta": {
"count": 1,
"updated_at": 1783802410,
"freshness_sec": 10,
"plan": "pro"
}
}
Setiap respons sukses Genesis API berbentuk sama: success adalah flag keberhasilan, data berisi datanya, dan meta membawa jumlah item, waktu unix saat data dibangun, keterlambatan pengiriman pada paket Anda dalam detik, dan paket Anda. null pada volume_24h_sell berarti tidak ada data, jadi jangan anggap sebagai nol. Rinciannya ada di bagian Format respons.
Parsing di Python
import os
import requests
response = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"min_spread": 0.5},
timeout=10,
)
body = response.json() # JSON → dict
if not body["success"]:
print(body["error"]["code"], body["error"]["message"])
else:
for row in body["data"]:
vol = row["volume_24h_sell"] # null → None
vol = "n/a" if vol is None else f"${vol:,.0f}"
print(row["coin"], f"{row['spread_pct']}%", vol)
response.json() mengubah teks respons menjadi dictionary Python. Jika body bukan JSON, misalnya halaman error dari proxy, metode ini melempar requests.exceptions.JSONDecodeError. Parsing yang berhasil tidak berarti request berhasil: error Genesis API datang sebagai JSON jenis yang sama dengan "success": false dan objek error; kodenya ada di bagian Error.
Lihat juga: REST API, spread, format respons, ETag, dan error, pelajaran: request API pertama Anda dengan HTTP, header, dan JSON.
Tanya jawab
Bagaimana mengubah updated_at menjadi tanggal?
Nilainya adalah waktu unix dalam detik. Di Python, datetime.fromtimestamp(1783802410, timezone.utc) menghasilkan 11 Juli 2026, 20:40:10 UTC.