راهنمای استفاده از CoinGecko API؛ دریافت رایگان قیمت ارزهای دیجیتال

دسترسی به داده‌های دقیق و لحظه‌ای بازار ارزهای دیجیتال یکی از اصلی‌ترین نیازهای طراحران داشبوردهای مالی، توسعه‌دهندگان اپلیکیشن‌های وب۳ و تحلیلگران بازار است. اگر برای پروژه‌ی خود به یک منبع معتبر و پایدار نیاز دارید که هزینه‌ای به شما تحمیل نکند، رابط برنامه‌نویسی CoinGecko API گزینه‌ای ایده‌آل است. این ابزار به شما امکان می‌دهد به اطلاعات قیمت، حجم معاملات، داده‌های آن‌چین و تاریخچه‌ی دارایی‌های دیجیتال دسترسی داشته باشید.

آشنایی با قابلیت‌ها و پوشش داده‌های CoinGecko API

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

پوشش داده‌های این ابزار شامل موارد زیر است:

• سکه‌ها و توکن‌ها (/coins/*): قیمت لحظه‌ای، تاریخچه، حجم بازار، اطلاعات متا دیتا، تصاویر و شبکه‌های اجتماعی.
• دارایی‌های دنیای واقعی یا RWA (/rwas/*): داده‌های بازار سهام توکنیزه‌شده، کالاها و صندوق‌های قابل معامله (ETF).
• صرافی‌ها و بازار مشتقات (/exchanges/* و /derivatives/*): اطلاعات صرافی‌های متمرکز، حجم معاملات و تیکرها.
• داده‌های آن‌چین DEX (/onchain/*): دسترسی به استخرهای نقدینگی و توکن‌ها در GeckoTerminal با پوشش بیش از ۳۶۰ شبکه.

شروع به کار و نمونه درخواست اطلاعات قیمت

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

# نمونه درخواست برای دریافت قیمت تاریخی بیت‌کوین با استفاده از دستورات شبکه
curl -X GET "https://api.coingecko.com/api/v3/coins/bitcoin/history?date=31-10-2026" \
  -H "accept: application/json"

پس از ارسال این درخواست، سرور پاسخ خود را در قالب یک ساختار JSON بازمی‌گرداند که نمونه‌ای از آن را در بخش زیر مشاهده می‌کنید:

{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "image": {
    "thumb": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400"
  },
  "market_data": {
    "current_price": {
      "usd": 77223.17102624816
    },
    "market_cap": {
      "usd": 1552600039940.144
    },
    "total_volume": {
      "usd": 201306723185.97467
    }
  }
}

این ساختار به برنامه‌نویس اجازه می‌دهد فیلدهای دلخواه مانند قیمت لحظه‌ای (current_price) یا حجم کل بازار (market_cap) را مستقیماً استخراج کرده و در رابط کاربری خود نمایش دهد. اگر به حوزه‌ی طراحی وب و توسعه ابزارها علاقه‌مندید، پیشنهاد می‌کنیم مقاله‌ی ساخت ابزار تخمین زمان مطالعه و تحلیل متن با HTML و JS را نیز مطالعه کنید.

قوانین لایسنس و شرایط استفاده تجاری

استفاده از پلن رایگان (Demo) و حتی پلن‌های تجاری پایه‌ی CoinGecko قوانین مشخصی دارد. اگر از این داده‌ها در اپلیکیشن یا وب‌سایت تجاری خود استفاده می‌کنید، موظف به رعایت نکات زیر هستید:

• نمایش انتساب (Attribution): پروژه‌ی شما باید به شکل مناسبی عبارت «Data provided by CoinGecko» را همراه با یک لینک به وب‌سایت رسمی نمایش دهد.
• ممنوعیت بازفروش: شما حق ندارید دسترسی به API یا داده‌های خام آن را به شکل پکیج‌شده، اجاره‌ای یا سرویس‌های واسط (White-label) به دیگران بفروشید؛ هرچند دریافت هزینه از کاربران نهایی برای اپلیکیشنِ ساخته‌شده توسط خودتان کاملاً مجاز است.

نکات پنهان، محدودیت‌ها و اشتباهات رایج

هنگام کار با این رابط برنامه‌نویسی، بهتر است مراقب چند نکته‌ی فنی باشید تا با خطای مسدود شدن موقت یا محدودیت نرخ مواجه نشوید:

• مدیریت Rate Limit: پلن رایگان اجازه ارسال حداکثر ۱۰۰ درخواست در دقیقه را می‌دهد. اگر داشبوردی با کاربران زیاد دارید، حتماً از مکانیزم Caching (ذخیره‌سازی موقت داده‌ها روی سرور خودتان) استفاده کنید تا هر بار برای یک کاربر درخواست جدیدی به سرور اصلی ارسال نشود.
• پارامترهای تاریخ: در اندروید یا وب، فرمت تاریخ در برخی اندپوینت‌ها حساس است و باید دقیقاً مطابق الگوی استاندارد (مانند DD-MM-YYYY) ارسال شود.

پرسش‌های متداول

جمع‌بندی

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

ورود به سایت رسمی