Genesis Arbitrage

Genesis Arbitrage · · 2 دقیقه مطالعه

JSON

JSON (JavaScript Object Notation) قالبی متنی برای تبادل داده است که در آن مقادیر در شیءهایی با آکولاد و آرایه‌هایی با کروشه گروه‌بندی می‌شوند. آن را 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

نام فیلدها و رشته‌ها فقط دو گیومهٔ مستقیم می‌گیرند. JSON کامنت ندارد و ویرگول بعد از آخرین عنصر سند را نامعتبر می‌کند.

پاسخ Genesis API

مثال فرضی از پاسخ endpoint با مسیر /arbitrage/spot-spot: یک ردیف، بعضی فیلدها حذف شده‌اند.

{
  "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 ساخت داده، تأخیر تحویل در پلن شما به ثانیه و پلن شما را می‌آورد. null در volume_24h_sell یعنی داده‌ای نیست؛ آن را صفر حساب نکنید. جزئیات در بخش قالب پاسخ است.

پارس کردن در 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 تبدیل می‌کند. اگر بدنه JSON نباشد، مثلاً صفحهٔ خطای یک پروکسی، این متد requests.exceptions.JSONDecodeError می‌دهد. پارس موفق به معنی درخواست موفق نیست: خطاهای Genesis API هم با همان JSON و "success": false و شیء error می‌رسند و کدهایشان در بخش خطاها است.

همچنین ببینید: REST API، اسپرد، قالب پاسخ، ETag و خطاها، درس: اولین درخواست API با HTTP، هدرها و JSON.

پرسش و پاسخ

updated_at را چگونه به تاریخ تبدیل کنم؟

زمان unix به ثانیه است. در Python عبارت datetime.fromtimestamp(1783802410, timezone.utc) تاریخ 11 ژوئیهٔ 2026، ساعت 20:40:10 UTC را می‌دهد.