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-spot | Pro، Max |
| دفترهای سفارش | /orderbooks/exec | Pro، Max |
| فاندینگ و OI | /funding/rates | همه |
| آنچین | /onchain/{section} | Start، Pro، Max |
| بازارهای پیشبینی و آربیتراژ شرطبندی | /predictions/arbitrage | Start: 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 دلار/ماه | 500K | 1 | 60 ث |
| Start، 50 دلار | 2M | 2 | 30 ث |
| Pro، 100 دلار | 5M | 5 | 10 ث |
| Max، 200 دلار | 10M | 15 | 5 ث |
پلنهای 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 میآید (ببینید جستوجوی کوین).