مرجع API صرافی CoinMarketCap

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

■ احراز هویت
۱. کلید API را از https://pro.coinmarketcap.com/login بگیرید.
۲. هدر X-CMC_PRO_API_KEY را در همه درخواست‌ها قرار دهید.

curl -X GET "https://pro-api.coinmarketcap.com/v1/exchange/map" -H "X-CMC_PRO_API_KEY: کلید-شما"

■ آدرس پایه
https://pro-api.coinmarketcap.com

■ کاربردهای رایج
۱. اطلاعات صرافی با نام
۲. یافتن شناسه CMC یک صرافی
۳. صرافی‌های برتر بر اساس حجم
۴. فقط صرافی‌های اسپات (یا فقط مشتقات)
۵. حجم فعلی یک صرافی مشخص
۶. مقایسه حجم چند صرافی
۷. حجم تاریخی یک صرافی
۸. همه جفت‌های معاملاتی یک صرافی
۹. یافتن جفت‌های بیت‌کوین در یک صرافی
۱۰. جفت‌های پرپچوال و فیوچرز یک صرافی
۱۱. بررسی ذخایر صرافی (اثبات ذخایر)
۱۲. یافتن صرافی‌هایی که یک ارز مشخص را فهرست کرده‌اند

■ فهرست اندپوینت‌ها

| اندپوینت | توضیح |
| GET /v1/exchange/map | نگاشت نام صرافی به شناسه CMC |
| GET /v1/exchange/info | متادیتای صرافی (لوگو، لینک‌ها، توضیح) |
| GET /v1/exchange/listings/latest | فهرست همه صرافی‌ها با داده بازار |
| GET /v1/exchange/quotes/latest | آخرین حجم و سنجه‌های صرافی |
| GET /v1/exchange/quotes/historical | داده حجم تاریخی صرافی |
| GET /v1/exchange/market-pairs/latest | جفت‌های معاملاتی یک صرافی |
| GET /v1/exchange/assets | دارایی‌های نگهداری‌شده توسط صرافی |

■ گردش کارهای رایج

گرفتن اطلاعات صرافی
چرا: بیشتر اندپوینت‌ها شناسه عددی می‌خواهند نه نام. اندپوینت map اسلاگ خوانا را به شناسه تبدیل می‌کند.
۱. /v1/exchange/map با slug=binance برای گرفتن شناسه
۲. /v1/exchange/info با آن شناسه برای متادیتای کامل

مقایسه حجم صرافی‌ها
چرا: حجم، نشانه نقدشوندگی و اعتماد است. حجم بالاتر یعنی اجرای بهتر قیمت و لغزش کمتر.
۱. /v1/exchange/listings/latest برای همه صرافی‌ها به ترتیب حجم
۲. با sort=volume_24h و sort_dir=desc برای ترتیب نزولی

تحلیل جفت‌های معاملاتی
چرا: فهم جفت‌های موجود کمک می‌کند بفهمید یک دارایی کجا قابل معامله است و نقدشوندگی در کدام صرافی بهتر است.
۱. شناسه صرافی را از /v1/exchange/map بگیر
۲. /v1/exchange/market-pairs/latest با همان شناسه
۳. با category=spot یا category=derivatives فیلتر کن

ردیابی تاریخچه حجم
چرا: حجم تاریخی روند را نشان می‌دهد. افت مستمر ممکن است نشانه خروج کاربران باشد و جهش ناگهانی ممکن است نشانه معاملات صوری یا یک رویداد خبری باشد.
۱. شناسه صرافی را از /v1/exchange/map بگیر
۲. /v1/exchange/quotes/historical با بازه تاریخ

■ پارامترهای مشترک
| پارامتر | نوع | توضیح |
| id | رشته | شناسه صرافی در CMC (چندتایی با کاما) |
| slug | رشته | اسلاگ صرافی (مثلاً binance) |
| convert | رشته | ارز تبدیل قیمت (پیش‌فرض USD) |
| aux | رشته | فیلدهای اضافی در پاسخ |

■ قالب پاسخ
{ "status": { "timestamp": "...", "error_code": 0, "error_message": null, "credit_count": 1 }, "data": { } }

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