مرجع API بازار CoinMarketCap

CMC Market API Reference

مرجع اندپوینت‌های بازارگسترده: شاخص‌های کلی، ترس و طمع، شاخص‌های CMC100 و CMC20، کندل و اخبار.

داده و API ترس و طمعشاخصنمودارAPI

این اسکیل چه می‌کند؟

این اسکیل سنجه‌های سطح بازار را پوشش می‌دهد، نه سطح توکن — چیزهایی مثل ارزش کل بازار، دامیننس بیت‌کوین، شاخص ترس و طمع و شاخص‌های CMC100 و CMC20.

برای ساخت داشبورد این مجموعه کامل‌ترین است: هم شاخص‌های احساسات را دارد، هم داده کندل برای رسم نمودار (/v1/k-line/candles)، هم موضوعات ترند جامعه، هم اندپوینت تبدیل ارز.

نکته کاربردی: اندپوینت /v1/key/info مصرف اعتبار و وضعیت پلن شما را برمی‌گرداند — برای ساخت هر سرویسی که قرار است مداوم کار کند، این اولین چیزی است که باید رصد شود.

قابلیت‌ها

  • شاخص‌های کلی بازار: ارزش کل، دامیننس، حجم، به‌صورت لحظه‌ای و تاریخی
  • شاخص ترس و طمع فعلی و تاریخی
  • شاخص‌های CMC100 و CMC20 برای سنجش عملکرد بازار
  • داده کندل و سری زمانی برای رسم نمودار
  • توکن‌ها و موضوعات ترند جامعه و آخرین اخبار
  • ابزارهای کمکی: تبدیل ارز، نگاشت ارزهای فیات، و بررسی مصرف اعتبار
تعریف اسکیل
این اسکیل، داده بازارگسترده کریپتو را پوشش می‌دهد: شاخص‌های کلی، سنجه‌های احساسات، شاخص‌های بازار، فعالیت جامعه، محتوای خبری، داده نمودار و اندپوینت‌های کمکی.

■ احراز هویت
همه درخواست‌ها هدر X-CMC_PRO_API_KEY می‌خواهند:
curl -X GET "https://pro-api.coinmarketcap.com/v1/global-metrics/quotes/latest" -H "X-CMC_PRO_API_KEY: کلید-شما"
کلید از https://pro.coinmarketcap.com/login

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

■ کاربردهای رایج
۱. احساسات فعلی بازار (ترس و طمع)
۲. ارزش کل بازار کریپتو
۳. دامیننس بیت‌کوین
۴. ردیابی تاریخچه ارزش بازار
۵. ردیابی تاریخچه ترس و طمع
۶. عملکرد شاخص CMC100
۷. مقایسه CMC100 با CMC20
۸. داده کندل OHLCV برای نمودار
۹. سری زمانی ساده قیمت
۱۰. توکن‌های ترند جامعه
۱۱. موضوعات داغ گفتگو
۱۲. آخرین اخبار کریپتو
۱۳. تبدیل مبالغ ارزی
۱۴. بررسی مصرف و محدودیت API
۱۵. شناسه ارزهای فیات

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

شاخص‌های کلی
| GET /v1/global-metrics/quotes/historical | شاخص‌های کلی تاریخی |
| GET /v1/global-metrics/quotes/latest | ارزش کل بازار و دامیننس بیت‌کوین |

شاخص ترس و طمع
| GET /v3/fear-and-greed/historical | مقادیر تاریخی |
| GET /v3/fear-and-greed/latest | امتیاز احساسات فعلی |

شاخص‌های بازار
| GET /v3/index/cmc100-historical | تاریخچه شاخص CMC100 |
| GET /v3/index/cmc100-latest | مقدار فعلی CMC100 |
| GET /v3/index/cmc20-historical | تاریخچه شاخص CMC20 |
| GET /v3/index/cmc20-latest | مقدار فعلی CMC20 |

جامعه
| GET /v1/community/trending/token | توکن‌های ترند بر اساس فعالیت جامعه |
| GET /v1/community/trending/topic | موضوعات داغ گفتگو |

محتوا
| GET /v1/content/latest | آخرین اخبار و مقالات |
| GET /v1/content/posts/comments | نظرات یک پست |
| GET /v1/content/posts/latest | آخرین پست‌های جامعه |
| GET /v1/content/posts/top | پست‌های برتر |

نمودار کندلی
| GET /v1/k-line/candles | داده کندل OHLCV |
| GET /v1/k-line/points | نقاط سری زمانی قیمت و ارزش بازار |

ابزارها
| GET /v1/fiat/map | نگاشت ارزهای فیات به شناسه CMC |
| GET /v1/key/info | مصرف کلید و جزئیات پلن |
| GET /v2/tools/price-conversion | تبدیل بین ارزها |

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

نمای کلی احساسات بازار:
۱. شاخص ترس و طمع: /v3/fear-and-greed/latest
۲. شاخص‌های کلی: /v1/global-metrics/quotes/latest
۳. ترکیب این دو برای تحلیل احساسات در بستر ارزش بازار

ردیابی عملکرد شاخص:
۱. مقدار فعلی CMC100: /v3/index/cmc100-latest
۲. تاریخچه برای مقایسه: /v3/index/cmc100-historical

ساخت نمودار:
۱. /v1/k-line/candles برای داده کندل
۲. /v1/k-line/points برای سری زمانی ساده

■ قاعده مهم برای مدل
پیش از ساخت هر سرویس مداوم، اندپوینت /v1/key/info را در رصد بگذار تا مصرف اعتبار از پلن جلو نزند.
هیچ اندپوینتی خارج از فهرست بالا نساز.

روش استفاده

برای ساخت داشبورد بازار یا سرویس رصد احساسات، این متن را به‌عنوان Skill یا دانش پروژه ذخیره کنید.

منبع: این اسکیل بر پایه «CoinMarketCap Skills for AI Agents» تدوین شده — منتشرشده تحت پروانه MIT. نسخه فارسی با بازنویسی و افزودن توضیحات بومی تهیه شده است. مشاهده منبع اصلی
یادآوری: این اسکیل چارچوب تحلیل می‌سازد و توصیه سرمایه‌گذاری ارائه نمی‌دهد. خروجی هر تحلیل را مستقل بازبینی کنید.

پرسش‌های پرتکرار

تفاوت اسکیل با پرامپت چیست؟
پرامپت را هر بار کپی و اجرا می‌کنید؛ اسکیل یک بار تعریف می‌شود و در تمام گفت‌وگوهای بعدی فعال می‌ماند. نتیجه، ثبات در تعاریف و قابل مقایسه بودن خروجی‌ها در طول زمان است.
چطور «مرجع API بازار CoinMarketCap» را فعال کنم؟
برای ساخت داشبورد بازار یا سرویس رصد احساسات، این متن را به‌عنوان Skill یا دانش پروژه ذخیره کنید.

پرامپت‌های مرتبط

Currency Correlation Analyst

ریسک پنهان پوزیشن‌های هم‌زمان را آشکار می‌کند: چند پوزیشن ظاهراً مستقل که عملاً یک شرط‌بندی هستند.

فارکس مدیریت ریسک متوسط
۲۶۹ کلمه ChatGPT · Claude
Dollar Index Impact Analyst

وضعیت شاخص دلار را تحلیل و اثر آن را روی جفت‌ارزها، طلا، نفت و کریپتو با مکانیزم انتقال مشخص می‌کند.

فارکسکالا، طلا و انرژی تحلیل بنیادی متوسط
۲۸۶ کلمه ChatGPT · Claude