Genesis Arbitrage

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

API ارز دیجیتال: انواع API داده‌های بازار و نحوه انتخاب آن برای معامله

به طور خلاصه

  • API ارز دیجیتال داده‌های بازار را به کد شما می‌رساند: قیمت‌ها، دفتر سفارش، نرخ فاندینگ، تراکنش‌های آن‌چین و قیمت‌های بازار پیش‌بینی. API صرافی یک پلتفرم را پوشش می‌دهد و با کلید سفارش می‌پذیرد؛ API داده بازار چند پلتفرم را در یک قالب یکی می‌کند.
  • API را با نه معیار انتخاب کنید: پوشش پلتفرم‌ها و شبکه‌ها، تازگی داده، یکسان‌سازی فیلدها، وضعیت واریز و برداشت، عمق دفتر سفارش، rate limit، قیمت، مستندات و شرایط استفاده از داده.
  • Genesis API یک REST API فقط‌خواندنی است: CEX، DEX، آن‌چین، بازارهای پیش‌بینی و آربیتراژ شرط‌بندی در یک قالب JSON، با پلن‌هایی از 20 دلار در ماه. سفارش ثبت نمی‌کند.

API ارز دیجیتال یک رابط برنامه‌نویسی است که کد از طریق آن داده‌های بازار ارز دیجیتال را می‌خواند یا سفارش را به صرافی می‌فرستد: قیمت‌ها، دفتر سفارش، نرخ فاندینگ، تراکنش‌های بلاک‌چین، قیمت‌های بازار پیش‌بینی. انواع API در دامنه فرق دارند: API صرافی یک پلتفرم را می‌شناسد و با کلید سفارش می‌پذیرد، API داده بازار چند پلتفرم را در یک قالب یکی می‌کند و API آن‌چین بلاک‌چین را می‌خواند.

انواع API ارز دیجیتال

نوع APIچه می‌دهدکی لازم است
API صرافیقیمت، دفتر سفارش و معاملات یک صرافی؛ سفارش با کلیدمعامله در همان صرافی، جریان معاملات یک جفت‌ارز
API داده بازارچند صرافی در یک قالب، اسپرد آمادهمقایسه صرافی‌ها، اسکنرها، هشدارها
API آن‌چینتراکنش‌ها، انتقال‌ها، موجودی‌ها، رویدادهای قراردادنهنگ‌ها، جریان صرافی‌ها، آنلاک‌ها
API DEXقیمت و نقدینگی استخرها، سواپ‌ها، اسلیپیجتوکن‌های خارج از CEX، موقعیت‌های DEX – CEX
داده مشتقاتفاندینگ، اوپن اینترست، قیمت فیوچرزآربیتراژ فاندینگ، چولگی موقعیت‌ها
API بازار پیش‌بینی و ضرایبقیمت YES و NO، دفتر سفارش، ضرایب بوکمیکرهاآربیتراژ بازار پیش‌بینی، آربیتراژ شرط‌بندی

API صرافی‌ها

API صرافی ارز دیجیتال رابط یک پلتفرم است و دو بخش دارد. بخش عمومی داده بازار را بدون کلید می‌دهد: در Binance این endpointها نوع امنیتی NONE دارند و GET /api/v3/ticker/price قیمت یک جفت‌ارز را برمی‌گرداند. بخش خصوصی — سفارش‌ها، موجودی‌ها، تاریخچه معاملات — به کلید API و امضای درخواست نیاز دارد؛ در Binance این‌ها نوع‌های TRADE و USER_DATA هستند (مستندات Binance).

چنین API‌ای یک صرافی را پوشش می‌دهد: برای مقایسه قیمت یک کوین در 20 صرافی به 20 اتصال با قالب‌ها و محدودیت‌های متفاوت نیاز دارید.

API داده بازار

API داده بازار داده را از صرافی‌های زیاد جمع می‌کند، یکسان‌سازی می‌کند و در یک درخواست برمی‌گرداند. پاسخ از قبل چیزی را دارد که ادغام پلتفرم‌ها لازم دارد: اسپردهای بین‌صرافی‌ای، نرخ‌های فاندینگ یکسان‌شده روی یک دوره، اوپن اینترست به تفکیک صرافی.

API آن‌چین

API آن‌چین بلاک‌چین را می‌خواند: تراکنش‌ها، انتقال توکن‌ها، موجودی آدرس‌ها، رویدادهای قرارداد هوشمند. لایه پایین نود شبکه است: هر کلاینت Ethereum با JSON-RPC صحبت می‌کند، که در آن eth_getBalance موجودی را به wei و به‌صورت عدد هگزادسیمال برمی‌گرداند و eth_getLogs رویدادهای قرارداد منطبق با فیلتر را می‌دهد.

نود نمی‌داند کدام آدرس‌ها مال صرافی، تیم یا نهنگ‌اند؛ این برچسب‌ها را ایندکسرها و سرویس‌های تحلیل آن‌چین اضافه می‌کنند. اینکه معامله‌گر به کدام داده نیاز دارد در API داده آن‌چین آمده است.

API‌های DEX

API DEX قیمت استخرها و نقدینگی در صرافی‌های غیرمتمرکز، سواپ‌ها و اسلیپیج را می‌دهد. هرچه سواپ نسبت به نقدینگی استخر بزرگ‌تر باشد قیمت را بیشتر جابه‌جا می‌کند؛ پس موقعیت DEX – CEX به اسلیپیج برای حجم شما نیاز دارد و توکن‌های جدید به مالیات توکن و بررسی هانی‌پات. جزئیات در API DEX.

داده مشتقات: فاندینگ و اوپن اینترست

فیوچرز دائمی کنار اسپات به نرخ فاندینگ، اوپن اینترست (حجم موقعیت‌های باز) و قیمت فیوچرز نیاز دارد. صرافی‌ها فاندینگ را هر 8، 4 یا 1 ساعت تسویه می‌کنند، پس نرخ‌ها بعد از یکسان‌سازی روی یک دوره مقایسه می‌شوند. جزئیات در API نرخ فاندینگ و API اوپن اینترست.

API بازار پیش‌بینی و ضرایب

پلتفرم‌های پیش‌بینی قیمت قراردادهای YES و NO و دفتر سفارش را می‌دهند. در Polymarket داده عمومی بازار به اعتبارنامه نیاز ندارد، اما سفارش احراز هویت و امضای کیف پول می‌خواهد (مستندات Polymarket).

قالب‌ها اینجا هم فرق دارند: دفتر سفارش Kalshi فقط پیشنهادهای خرید دارد و قیمت فروش YES برابر 1 دلار منهای بهترین پیشنهاد خرید NO است؛ یعنی پیشنهاد خرید NO با 0.56 دلار یعنی قیمت فروش YES برابر 0.44 دلار (مستندات Kalshi). ضرایب بوکمیکرها از راه احتمال ضمنی با قیمت‌های YES و NO مقایسه می‌شوند — ببینید Polymarket API و Kalshi API و API ضرایب ورزشی.

REST و WebSocket

REST API به درخواست با یک اسنپ‌شات فیلترشده طبق خواسته شما پاسخ می‌دهد و به‌روزرسانی‌ها را با polling طبق زمان‌بندی می‌گیرید.

WebSocket اتصال را باز نگه می‌دارد و سرور هر معامله و هر تغییر دفتر سفارش را می‌فرستد. در عوض باید جریان را بدون حفره پردازش کنید، بعد از قطع دوباره وصل شوید و دفتر را از اسنپ‌شات به‌علاوه به‌روزرسانی‌ها بازسازی کنید؛ Kalshi حتی برای کانال‌های عمومی هم برای اتصال احراز هویت می‌خواهد. واکنش زیر یک ثانیه WebSocket می‌خواهد؛ اسکنرها و هشدارها روی بیش از 20 صرافی با REST کار می‌کنند.

Genesis API فقط REST است، بدون WebSocket و بدون وب‌هوک: هر درخواست GET است، پاسخ‌ها با gzip فشرده‌اند و قالب JSON دارند و داده هر meta.freshness_sec ثانیه به‌روز می‌شود. اگر درخواست مجموعه کامل بدون فیلتر را با ETag قبلی در If-None-Match تکرار کنید و چیزی تغییر نکرده باشد، 304 بدون بدنه می‌گیرید و این پاسخ از سهمیه مصرف نمی‌کند. الگوهای polling در بهترین روش‌های polling برای API آمده است.

چطور API ارز دیجیتال انتخاب کنیم: چک‌لیست

شش معیار اول در پاسخ زنده API دیده می‌شوند؛ بقیه در مستندات و قیمت‌گذاری‌اند.

معیارچه چیزی را بررسی کنیم
پوشش پلتفرم‌ها و شبکه‌هاصرافی‌های شما، اسپات و فیوچرز، DEXها و شبکه‌ها
تازگی و تأخیرزمان ساخت در پاسخ، گام به‌روزرسانی، عمر دفتر سفارش
یکسان‌سازی فیلدهاتیکرها، واحدها، درصدها و زمان یکدست
وضعیت واریز و برداشتپرچم‌های واریز و برداشت برای هر صرافی و شبکه
عمق دفتر سفارشقیمت اجرا برای حجم شما
rate limit و سهمیه‌هادرخواست در ثانیه، فراخوانی در دوره، چه چیزی فراخوانی حساب می‌شود
قیمتپلن یا پرداخت به‌ازای هر فراخوانی، پس از عبور از حد چه می‌شود
مستندات و OpenAPIنمونه درخواست و پاسخ، یک spec
شرایط استفاده از دادهآیا می‌توان محصول خودتان را روی داده ساخت

پوشش و تازگی

پوشش را با فهرست خودتان بسنجید: اگر ربات شما با MEXC و Gate کار می‌کند، APIای که یکی‌شان را ندارد به کار نمی‌آید. تازگی داده یعنی چند ثانیه از ساخت اسنپ‌شات گذشته است؛ تأخیر کل مسیر از معامله در صرافی تا کد شماست. روی اسنپ‌شات یک‌دقیقه‌ای ربات اسپردهایی را می‌بیند که دیگر وجود ندارند.

یکسان‌سازی فیلدها

همان جفت BTC/USDT در APIهای صرافی‌ها جور دیگری نوشته می‌شود: BTCUSDT در Binance، BTC-USDT در OKX (دائمی‌اش BTC-USDT-SWAP)، BTC_USDT در Gate. Binance قیمت‌ها را رشته برمی‌گرداند ("price": "4.00000200" در نمونه مستنداتش) و زمان را به میلی‌ثانیه. کد شما باید هر یک از این تفاوت‌ها را مدیریت کند.

API داده بازار فیلدها را به یک شکل می‌آورد، مثل این آیتم /funding/rates از مستندات Genesis API:

{
  "coin": "TON",
  "exchanges": [
    {
      "exchange": "MEXC",
      "funding_pct": 0.02,
      "funding_8h_pct": 0.04,
      "next_payout": "00:00",
      "interval": "4h",
      "price": 2.184,
      "trade_url": "https://futures.mexc.com/exchange/TON_USDT"
    }
  ]
}

MEXC فاندینگ این کوین را هر 4 ساعت تسویه می‌کند و نرخ 0.02% برای هر دوره در funding_8h_pct به 8 ساعت یکسان شده است: 0.02 × 8 / 4 = 0.04% (ببینید نرخ‌های فاندینگ).

وضعیت واریز و برداشت

موقعیت اسپات بین‌صرافی‌ای فقط وقتی قابل اجراست که کوین از صرافی خرید قابل برداشت و در صرافی فروش قابل واریز باشد. در Binance وضعیت شبکه‌ها از GET /sapi/v1/capital/config/getall می‌آید، یک endpoint امضاشده از نوع USER_DATA که کلید API حساب شما را می‌خواهد (مستندات Binance). در Genesis API وضعیت‌ها در هر ردیف Spot – Spot با فیلدهای withdraw_enabled_buy و deposit_enabled_sell می‌رسند (مستندات Spot — Spot).

عمق دفتر سفارش

اسپرد بهترین قیمت شکاف بالای دفتر را نشان می‌دهد، در حالی که معامله 5,000 دلاری از چند سطح عمق بازار عبور می‌کند. در نمونه مستندات Genesis API برای /orderbooks/spreads/spot-futures اسپرد BTC در بهترین قیمت‌ها 0.031% و پس از عبور از دفترها برای 5,000 دلار 0.0202% است. endpoint قیمت‌های اجرا قیمت اجرا را برای 500 تا 10,000 دلار برمی‌گرداند؛ بیشتر در API دفتر سفارش ارز دیجیتال.

محدودیت‌ها، قیمت و مستندات

محدودیت‌ها به شکل‌های متفاوت شمرده می‌شوند. در Binance هر endpoint وزنی دارد، درخواست روی نمادهای زیاد سنگین‌تر است و IPای که بعد از 429 به ارسال ادامه دهد از 2 دقیقه تا 3 روز مسدود می‌شود (محدودیت‌های Binance). برای API داده، سهمیه فراخوانی، rate limit در ثانیه و آنچه فراخوانی حساب می‌شود را بررسی کنید: در Genesis API فقط پاسخ 200 از سهمیه مصرف می‌کند.

قیمت‌گذاری یا پلن با سهمیه است یا پرداخت به‌ازای هر فراخوانی؛ بپرسید پس از عبور از حد چه می‌شود — خطای 429 یا هزینه اضافه. spec با قالب OpenAPI توصیف ماشین‌خوان API است برای ساخت کلاینت و اتصال عامل‌های هوش مصنوعی، و شرایط استفاده می‌گوید آیا می‌توانید روی داده محصول بسازید و چه چیزی را نمی‌توان دوباره فروخت.

بررسی با یک درخواست

این اسکریپت مجموعه کامل Spot – Spot را می‌گیرد (در همه پلن‌های Genesis API در دسترس است) و با یک پاسخ پوشش، عمر اسنپ‌شات و سهم موقعیت‌های قابل انتقال را بررسی می‌کند:

import os
import time

import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}

r = requests.get(BASE + "/arbitrage/spot-spot",
                 headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]

# پوشش: کدام صرافی‌ها در موقعیت‌ها دیده می‌شوند
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("exchanges in response:", len(venues), sorted(venues))

# تازگی: عمر اسنپ‌شات و گام به‌روزرسانی پلن
age = time.time() - meta["updated_at"]
print(f"snapshot {age:.0f} s old, plan step {meta['freshness_sec']} s")

# انتقال: برداشت در سمت خرید باز، واریز در سمت فروش باز
ok = [x for x in rows
      if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"transferable setups: {len(ok)} of {len(rows)}")

تلاش دوباره روی 429 و 503 از تابع get_json در پاسخ‌ها و خطاهای Genesis API می‌آید. بعد قیمت‌ها و وضعیت 3 تا 5 موقعیت را در صرافی‌ها از راه trade_url_buy و trade_url_sell بررسی کنید.

کد خودتان یا API آماده

برای یک یا دو صرافی به‌علاوه معامله، کد خودتان روی APIهای آن‌ها انتخاب طبیعی است. برای 20 صرافی با اسپات و فیوچرز این یعنی تا 40 کانکتور داده بازار: در Binance اسپات و فیوچرز USDⓈ-M دو API جداست، api.binance.com و fapi.binance.com. هر کانکتور اسنپ‌شات‌های REST، جریان WebSocket با اتصال مجدد، محدودیت‌ها و قالب نماد خودش را دارد و بالای آن ادغام می‌آید: کوین‌ها با قرارداد و شبکه تطبیق داده می‌شوند، چون یک تیکر در صرافی‌های مختلف می‌تواند توکن‌های مختلف باشد.

کارکد خودتان روی APIهای صرافیGenesis API
ثبت سفارشتنها راه: API معاملاتی صرافیخیر، فقط‌خواندنی
هر معامله یک جفت‌ارزWebSocket صرافیخیر، اسنپ‌شات هر 60–5 ثانیه
اسپرد در بیش از 20 صرافیتا 40 کانکتور به‌علاوه ادغامیک درخواست
وضعیت واریز و برداشتیک endpoint برای هر صرافی، در Binance با کلیدفیلدهایی در ردیف موقعیت
DEX، آن‌چین، بازارهای پیش‌بینینودها، ایندکسرها، APIهای پلتفرم‌هاهمان قالب JSON

این دو رویکرد قابل ترکیب‌اند: API داده موقعیت‌ها را پیدا می‌کند و معامله در صرافی دستی یا از راه API معاملاتی آن با کلیدی بدون حق برداشت باز می‌شود (ببینید چطور حساب صرافی ارز دیجیتال را ایمن کنیم). ربات با هشدار Telegram در ربات آربیتراژ ارز دیجیتال با Python ساخته می‌شود.

جای Genesis API کجاست

Genesis API همان REST API داده‌های Genesis Arbitrage است: CEX، DEX، آن‌چین، بازارهای پیش‌بینی و آربیتراژ شرط‌بندی در یک قالب JSON، با کلید در هدر X-API-Key. همان داده‌ای را می‌دهد که سایت منتشر می‌کند، از طریق 35+ endpoint (37 عملیات در spec) و فقط داده می‌خواند.

دادهنمونه endpointپلن‌های API
اسپردهای CEX/arbitrage/spot-spotهمه
DEX و کراس‌چین/arbitrage/dex-spotPro، Max
دفترهای سفارش/orderbooks/execPro، Max
فاندینگ و OI/funding/ratesهمه
آن‌چین/onchain/{section}Start، Pro، Max
بازارهای پیش‌بینی و آربیتراژ شرط‌بندی/predictions/arbitrageStart: exact، dutch؛ Pro، Max: llm، sport

پوشش: بیش از 20 صرافی CEX (Binance، OKX، Bybit، Bitget، MEXC، Gate، BingX، Kraken، WhiteBit، Coinbase، CoinW، edgeX، HTX، Hyperliquid و دیگران)، فاندینگ برای 1000+ کوین یکسان‌شده روی 8 ساعت، اوپن اینترست در 13+ صرافی فیوچرز. بازارهای پیش‌بینی Polymarket، Kalshi، Limitless، Predict.fun و Opinion‌اند؛ حالت sport آربیتراژ شرط‌بندی را در 13 پلتفرم می‌سازد، فقط پیش از بازی.

پلنفراخوانی در ماهدرخواست در ثانیهتازگی
Trial، 20 دلار/ماه500K160 ث
Start، 50 دلار2M230 ث
Pro، 100 دلار5M510 ث
Max، 200 دلار10M155 ث

پلن‌های API از اشتراک سایت جدایند؛ با ارز دیجیتال پرداخت می‌کنید، با 10% تخفیف برای 3 ماه و 20% برای 6 ماه. در صورت عبور از محدودیت‌ها سرور 429 برمی‌گرداند و چیزی کم نمی‌کند، و endpoint بیرون از پلن شما 403 plan_restricted می‌دهد. پلن‌ها را در قیمت‌های Genesis API مقایسه کنید؛ قواعد در پلن‌ها و محدودیت‌ها است.

هر بخش مستندات نشانی خودش را دارد، با پارامترها، فیلدها، نمونه curl و فرم امتحان درخواست. برای برنامه‌ها و عامل‌های هوش مصنوعی spec با قالب OpenAPI 3.1 و مرجع llms-full.txt هست؛ راه‌اندازی در Genesis API برای عامل‌های هوش مصنوعی آمده است. می‌توانید روی Genesis API سرویس، ربات و داشبورد خودتان را بسازید؛ داده خام را همان‌طور که هست نمی‌توان دوباره فروخت.

اولین درخواست — پلن، کلید در پروفایل و یک GET با X-API-Key — در شروع سریع آمده و مبانی در درس API ارز دیجیتال چیست و چه چیزی را می‌توان خودکار کرد. بدون کد، همین داده‌ها در جدول‌های سایت و در هشدارهای Telegram است.

پرسش و پاسخ

آیا API رایگان ارز دیجیتال وجود دارد؟

بله: APIهای عمومی صرافی‌ها قیمت، دفتر سفارش و معاملات را رایگان و بدون کلید می‌دهند (در Binance endpointهای NONE)، اما هر کدام یک صرافی را پوشش می‌دهند. Genesis API پلن رایگان ندارد: Trial ماهی 20 دلار برای 500K فراخوانی است.

برای استفاده از API ارز دیجیتال به SDK نیاز دارم؟

برای REST API یک کلاینت HTTP کافی است: curl، requests در Python یا fetch در JavaScript. Genesis API SDK رسمی ندارد و هر درخواست یک GET با یک هدر است؛ می‌توانید از spec با قالب OpenAPI 3.1 کلاینت تایپ‌دار تولید کنید.

می‌توانم از طریق API داده بازار معامله کنم؟

نه، اگر API فقط‌خواندنی باشد، مثل Genesis API: موقعیت‌ها را پیدا می‌کند اما سفارش ثبت نمی‌کند. سفارش‌ها از راه صرافی می‌روند، دستی یا با API معاملاتی آن با کلید و امضا (در Binance endpointهای TRADE)، که بیرون از Genesis API است و با مسئولیت خودتان.

چطور قیمت ارز دیجیتال را از API بگیرم؟

endpoint عمومی صرافی قیمت یک جفت‌ارز را در همان صرافی برمی‌گرداند: در Binance GET /api/v3/ticker/price است و قیمت به‌صورت رشته می‌آید. قیمت یک کوین در همه صرافی‌ها، با وضعیت واریز و برداشت، از /coins/search?query=BTC در Genesis API می‌آید (ببینید جست‌وجوی کوین).