Genesis Arbitrage

Genesis Arbitrage · · 3 dk okuma

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ÖrnekPython'da
Nesne{"coin": "BTC"}dict
Dizi[0.11, 0.45]list
String"ByBit"str
Sayı214, 0.92int, float
Booleantrue, falseTrue, False
Boş değernullNone

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.