CoinGecko
Cryptocurrency prices, market data and historical series.
بازارهای ارز
جدول بازار رتبه‌بندی‌شده که ارزهای متعدد را در یک فراخوانی پوشش می‌دهد: یک ردیف برای هر ارز با current_price، market_cap، market_cap_rank، total_volume، high_24h، low_24h، price_change_percentage_24h، circulating_supply، total_supply، max_supply، ath و atl با تاریخ‌هایشان، و image. با per_page و page صفحه‌بندی کنید، با order مرتب کنید (ارزش بازار، حجم یا شناسه، صعودی یا نزولی)، و با ids یا category محدود کنید. ارسال price_change_percentage فیلد متناظر price_change_percentage_24h_in_currency را اضافه می‌کند. از آن برای جدول‌های رتبه‌بندی و اسکن بخش‌ها استفاده کنید. برای قیمت چند ارز شناخته‌شده get_coingecko_simple_price بسیار سبک‌تر است؛ برای یک ارز به‌طور کامل از get_coingecko_coins_id استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: واحدهای منابع طرح.
- برآورد درخواست مرجع: 0.008 دلار آمریکا.
- مبنای هزینه واحد: 0.0 دلار آمریکا.
- واحد منبع:
provider_credit. - مبناهای هزینه، قیمت نهایی مشتری را تعیین نمی‌کنند، از جمله وقتی صفر باشند.
فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: stringcategory
فیلتر بر اساس دسته ارزها. *به
/coins/categories/listاشاره دارد - نوع: stringids
شناسه‌های ارزها، در صورت کوئری بیش از یک ارز با کاما جدا می‌شوند. *به
/coins/listاشاره دارد - نوع: booleaninclude
_rehypothecated شامل‌کردن توکن‌های بازرهن‌شده در نتایج. وقتی true باشد، فیلد
market_cap_rank_with_rehypothecatedبازگردانده می‌شود. پیش‌فرض: false - نوع: string فهرست مقادیرinclude
_tokens برای جستجوهای
symbols، مقدارallرا مشخص کنید تا همه توکن‌های منطبق گنجانده شوند. پیش‌فرضtopتوکن‌های برتر بر اساس ارزش بازار یا حجم را برمی‌گرداند.مقادیر- top
- all
- نوع: string فهرست مقادیرlocale
زبان پس‌زمینه. پیش‌فرض: en
مقادیر- ar
- bg
- cs
- da
- de
- نوع: stringnames
نام ارزها، در صورت کوئری بیش از یک ارز با کاما جدا می‌شوند.
- نوع: string فهرست مقادیرorder
مرتب‌سازی نتایج بر اساس فیلد. پیش‌فرض: market_cap_desc
مقادیر- market
_cap _asc - market
_cap _desc - volume
_asc - volume
_desc - id
_asc - id
_desc
- نوع: integerpage
پیمایش صفحه‌به‌صفحه نتایج. پیش‌فرض: 1
- نوع: integerper
_page کل نتایج در هر صفحه. پیش‌فرض: 100 مقادیر معتبر: 1...250
- نوع: string فهرست مقادیرprecision
تعداد رقم اعشار برای مقدار قیمت ارز
مقادیر- full
- 0
- 1
- 2
- 3
- نوع: stringprice
_change _percentage شامل‌کردن درصد تغییر قیمت در بازه زمانی، در صورت کوئری بیش از یک بازه با کاما جدا می‌شود. مقادیر معتبر:
1h،24h،7d،14d،30d،200d،1y - نوع: booleansparkline
شامل‌کردن داده‌های sparkline هفت‌روزه. پیش‌فرض: false
- نوع: stringsymbols
نمادهای ارزها، در صورت کوئری بیش از یک ارز با کاما جدا می‌شوند.
- نوع: stringvs
_currency الزامیارز هدف ارزها و داده‌های بازار. *به
/simple/supported_vs_currenciesاشاره دارد
- نوع: array object[] · Response860C3Ae68Ea5_CoinsMarkets200
فهرست ارزها با داده‌های بازار
- athنوع: number | nullالزامی
بالاترین قیمت تاریخ در واحد پول هدف
- athنوع: number | null
_change _percentage الزامیدرصد تغییر بالاترین قیمت تاریخی
- athنوع: string | null قالب: date-time
_date الزامیتاریخ بالاترین قیمت تاریخی
- atlنوع: number | nullالزامی
پایین‌ترین قیمت تاریخ در واحد پول هدف
- atlنوع: number | null
_change _percentage الزامیدرصد تغییر پایین‌ترین قیمت تاریخی
- atlنوع: string | null قالب: date-time
_date الزامیتاریخ پایین‌ترین قیمت تاریخی
- circulatingنوع: number | null
_supply الزامیعرضه در گردش
- currentنوع: number | null
_price الزامیقیمت فعلی در واحد پول هدف
- fullyنوع: number | null
_diluted _valuation الزامیارزش کاملاً رقیق‌شده در واحد پول هدف
- highنوع: number | null
_24h الزامیبالاترین قیمت 24 ساعته در واحد پول هدف
- idنوع: stringالزامی
شناسه ارز
- imageنوع: stringالزامی
نشانی URL تصویر ارز
- lastنوع: string قالب: date-time
_updated الزامیبرچسب زمان آخرین به‌روزرسانی
- lowنوع: number | null
_24h الزامیپایینترین قیمت 24 ساعته در واحد پول هدف
- marketنوع: number | null
_cap الزامیارزش بازار در واحد پول هدف
- marketنوع: number | null
_cap _change _24h الزامیتغییر ارزش بازار 24 ساعته در واحد پول هدف
- marketنوع: number | null
_cap _change _percentage _24h الزامیدرصد تغییر ارزش بازار 24 ساعته
- marketنوع: integer | null
_cap _rank الزامیرتبه ارزش بازار
- maxنوع: number | null
_supply الزامیحداکثر عرضه
- nameنوع: stringالزامی
نام کوین
- priceنوع: number | null
_change _24h الزامیتغییر قیمت 24 ساعته در واحد پول هدف
- priceنوع: number | null
_change _percentage _24h الزامیدرصد تغییر قیمت 24 ساعته
- roiنوع: object | nullالزامی
داده‌های بازده سرمایه‌گذاری
- currencyنوع: string
واحد پول ROI
- percentageنوع: number
درصد ROI
- timesنوع: number
ضریب ROI
- symbolنوع: stringالزامی
نماد کوین
- totalنوع: number | null
_supply الزامیکل عرضه
- totalنوع: number | null
_volume الزامیکل حجم معاملات در واحد پول هدف
- marketنوع: integer | null
_cap _rank _with _rehypothecated رتبه ارزش بازار با احتساب توکن‌های بازرهن‌شده
- priceنوع: number | null
_change _percentage _14d _in _currency درصد تغییر قیمت 14 روزه در واحد پول هدف
- priceنوع: number | null
_change _percentage _1h _in _currency درصد تغییر قیمت 1 ساعته در واحد پول هدف
- priceنوع: number | null
_change _percentage _1y _in _currency درصد تغییر قیمت 1 ساله در واحد پول هدف
- priceنوع: number | null
_change _percentage _200d _in _currency درصد تغییر قیمت 200 روزه در واحد پول هدف
- priceنوع: number | null
_change _percentage _24h _in _currency درصد تغییر قیمت 24 ساعته در واحد پول هدف
- priceنوع: number | null
_change _percentage _30d _in _currency درصد تغییر قیمت 30 روزه در واحد پول هدف
- priceنوع: number | null
_change _percentage _7d _in _currency درصد تغییر قیمت 7 روزه در واحد پول هدف
- sparklineنوع: object
_in _7d داده‌های قیمت اسپارکلاین برای 7 روز اخیر
- priceنوع: array number[]
آرایه مقادیر قیمت
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl 'https://openapi.felo.ai/v1/beta/coingecko/coins/markets?vs_currency=usd' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
[
{
"id": "bitcoin",
"symbol": "btc",
"name": "Bitcoin",
"image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
"current_price": 77671,
"market_cap": 1555886872303,
"market_cap_rank": 1,
"fully_diluted_valuation": 1555914058873,
"total_volume": 33235034316,
"high_24h": 78419,
"low_24h": 76696,
"price_change_24h": -747.3360347281705,
"price_change_percentage_24h": -0.95302,
"market_cap_change_24h": -15184401491.513184,
"market_cap_change_percentage_24h": -0.9665,
"circulating_supply": 20030493,
"total_supply": 20030843,
"max_supply": 21000000,
"ath": 126080,
"ath_change_percentage": -38.39571,
"ath_date": "2025-10-06T18:57:42.558Z",
"atl": 67.81,
"atl_change_percentage": 114443.23093,
"atl_date": "2013-07-06T00:00:00.000Z",
"roi": null,
"last_updated": "2026-05-18T12:49:21.599Z",
"market_cap_rank_with_rehypothecated": 1,
"sparkline_in_7d": {
"price": [
81045.84776489827,
81001.73089268175,
80898.20817826076
]
},
"price_change_percentage_1h_in_currency": 0.5823392426906319,
"price_change_percentage_24h_in_currency": -0.9530164743774191,
"price_change_percentage_7d_in_currency": -4.042267423689584,
"price_change_percentage_14d_in_currency": -1.5720857443461431,
"price_change_percentage_30d_in_currency": 1.9453890367549207,
"price_change_percentage_200d_in_currency": -29.452371850925864,
"price_change_percentage_1y_in_currency": -25.214612207475373
}
]