Genesis Arbitrage

Genesis Arbitrage · · 3 मिनट में पढ़ें

JSON

JSON (JavaScript Object Notation) डेटा के आदान-प्रदान का टेक्स्ट फ़ॉर्मेट है, जिसमें मान curly braces वाले ऑब्जेक्ट और square brackets वाले ऐरे में समूहित होते हैं। इसे RFC 8259 और ECMA-404 मानक तय करते हैं, और इसका मीडिया टाइप application/json है। Genesis API भी JSON में जवाब देता है।

मानों के प्रकार

प्रकारउदाहरणPython में
ऑब्जेक्ट{"coin": "BTC"}dict
ऐरे[0.11, 0.45]list
स्ट्रिंग"ByBit"str
संख्या214, 0.92int, float
बूलियनtrue, falseTrue, False
ख़ाली मानnullNone

फ़ील्ड के नाम और स्ट्रिंग सिर्फ़ दोहरे quotes लेते हैं। JSON में कमेंट नहीं होते, और आख़िरी तत्व के बाद का अल्पविराम दस्तावेज़ को अमान्य बना देता है।

Genesis API का जवाब

/arbitrage/spot-spot endpoint के जवाब का काल्पनिक उदाहरण: एक पंक्ति, कुछ फ़ील्ड हटाए गए हैं।

{
  "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 का हर सफल जवाब एक ही ढाँचे का होता है: success सफलता का फ़्लैग है, data में डेटा है, और meta में तत्वों की गिनती, डेटा बनने का unix समय, आपके प्लान पर डिलीवरी में देरी (सेकंड में) और आपका प्लान है। volume_24h_sell में null का मतलब है कि डेटा नहीं है, उसे शून्य न मानें। विवरण रिस्पॉन्स फ़ॉर्मेट सेक्शन में हैं।

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() जवाब के टेक्स्ट को Python dictionary में बदलता है। अगर बॉडी JSON नहीं है, जैसे प्रॉक्सी का एरर पेज, तो यह मेथड requests.exceptions.JSONDecodeError उठाता है। पार्सिंग सफल होने का मतलब request सफल होना नहीं है: Genesis API की त्रुटियाँ भी उसी तरह के JSON में "success": false और error ऑब्जेक्ट के साथ आती हैं, और उनके कोड एरर सेक्शन में हैं।

यह भी देखें: REST API, स्प्रेड, रिस्पॉन्स फ़ॉर्मेट, ETag और एरर, पाठ: HTTP, हेडर और JSON के साथ आपकी पहली API request।

सवाल और जवाब

updated_at को तारीख़ में कैसे बदलें?

यह सेकंड में unix समय है। Python में datetime.fromtimestamp(1783802410, timezone.utc) से 11 जुलाई 2026, 20:40:10 UTC मिलता है।