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.92 | int, float |
| بولی | true, false | True, False |
| مقدار تهی | null | None |
نام فیلدها و رشتهها فقط دو گیومهٔ مستقیم میگیرند. 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 را میدهد.