JSON
JSON (JavaScript Object Notation), değerlerin süslü parantezli nesnelerde ve köşeli parantezli dizilerde gruplandığı, veri alışverişi için metin tabanlı bir formattır. RFC 8259 ve ECMA-404 standardında tanımlanmıştır, medya türü application/json'dır. Genesis API de JSON ile yanıt verir.
Değer türleri
| Tür | Örnek | Python'da |
|---|---|---|
| Nesne | {"coin": "BTC"} | dict |
| Dizi | [0.11, 0.45] | list |
| String | "ByBit" | str |
| Sayı | 214, 0.92 | int, float |
| Boolean | true, false | True, False |
| Boş değer | null | None |
Alan adları ve string'ler yalnızca çift tırnak alır. JSON'da yorum yoktur ve son elemandan sonraki virgül belgeyi geçersiz kılar.
Genesis API yanıtı
/arbitrage/spot-spot endpoint'i yanıtının varsayımsal örneği: tek satır, bazı alanlar çıkarılmıştır.
{
"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"
}
}
Genesis API'nin her başarılı yanıtı aynı yapıdadır: success başarı bayrağı, data veriyi taşır; meta ise öğe sayısını, verinin oluşturulduğu unix zamanını, planınızdaki teslim gecikmesini saniye olarak ve planınızı içerir. volume_24h_sell içindeki null veri olmadığı anlamına gelir; sıfır saymayın. Ayrıntılar Yanıt formatı bölümündedir.
Python'da ayrıştırma
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(), yanıt metnini bir Python sözlüğüne çevirir. Gövde JSON değilse, örneğin bir proxy hata sayfasıysa, yöntem requests.exceptions.JSONDecodeError fırlatır. Ayrıştırmanın başarılı olması isteğin başarılı olduğu anlamına gelmez: Genesis API hataları da "success": false ve bir error nesnesiyle aynı türde JSON olarak gelir; kodlar Hatalar bölümündedir.
Ayrıca bakın: REST API, spread, yanıt formatı, ETag ve hatalar, ders: HTTP, başlıklar ve JSON ile ilk API isteğiniz.
Sorular ve cevaplar
updated_at değerini tarihe nasıl çeviririm?
Saniye cinsinden unix zamanıdır. Python'da datetime.fromtimestamp(1783802410, timezone.utc) 11 Temmuz 2026, 20:40:10 UTC sonucunu verir.