Felo API PlatformFelo API Platform
همه endpointهای CoinGecko
v0.2.0-beta
OpenAPI 3.1.0

بازه نمودار بازار ارز

Felo API Support
MIT
سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت
Shell Curl

CoinGecko

​

Cryptocurrency prices, market data and historical series.

CoinGecko عملیات

بازه نمودار بازار ارز

​

سری تاریخی برای یک ارز بین دو نقطه زمانی صریح. from و to زمان‌های یونیکس بر حسب ثانیه‌اند، در حالی که زمان‌های داخل پاسخ بر حسب میلی‌ثانیه‌اند — این دو واحد یکسان نیستند و همین معمولاً منبع نتایج خالی یا ناهم‌تراز است. prices، market_caps و total_volumes را به‌صورت جفت‌های زمان و مقدار برمی‌گرداند؛ CoinGecko دقت را از طول بازه انتخاب می‌کند. از آن برای هم‌تراز کردن یک سری با بازه رویداد مشخص استفاده کنید. برای بازه گذشته‌ای که اکنون پایان می‌یابد، get_coingecko_coins_id_market_chart به‌جای آن تعداد days می‌گیرد.

مرجع قیمت‌گذاری

  • اندازه‌گیری: واحدهای منابع طرح.
  • برآورد درخواست مرجع: 0.008 دلار آمریکا.
  • مبنای هزینه واحد: 0.0 دلار آمریکا.
  • واحد منبع: provider_credit.
  • مبناهای هزینه، قیمت نهایی مشتری را تعیین نمی‌کنند، از جمله وقتی صفر باشند.

فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

پارامترهای مسیر
  • id
    نوع: string
    الزامی

    شناسه ارز. *به /coins/list اشاره دارد.

پارامترهای پرس‌وجو
  • from
    نوع: string
    الزامی

    تاریخ شروع به‌صورت رشته تاریخ ISO (YYYY-MM-DD یا YYYY-MM-DDTHH:MM) یا مهر زمانی UNIX. برای بهترین سازگاری از رشته تاریخ ISO استفاده کنید.

  • interval
    نوع: string فهرست مقادیر

    فاصله داده‌ها، برای دانه‌بندی خودکار خالی بگذارید.

    مقادیر
    • 1m
    • 5m
    • hourly
    • daily
  • precision
    نوع: string فهرست مقادیر

    تعداد رقم اعشار برای مقدار قیمت ارز.

    مقادیر
    • full
    • 0
    • 1
    • 2
    • 3
  • to
    نوع: string
    الزامی

    تاریخ پایان به‌صورت رشته تاریخ ISO (YYYY-MM-DD یا YYYY-MM-DDTHH:MM) یا مهر زمانی UNIX. برای بهترین سازگاری از رشته تاریخ ISO استفاده کنید.

  • vs_currency
    نوع: string
    الزامی

    ارز هدف داده‌های بازار. *به /simple/supported_vs_currencies اشاره دارد.

پاسخ‌ها
  • 200
    نوع: object · Response860C3Ae68Ea5_CoinsMarketChart

    داده‌های نمودار تاریخی ارز در بازه زمانی

    • market_caps
      نوع: array array number[][]
      الزامی

      نقاط داده ارزش بازار به‌صورت جفت‌های [timestamp, market_cap]

    • prices
      نوع: array array number[][]
      الزامی

      نقاط داده قیمت به‌صورت جفت‌های [timestamp, price]

    • total_volumes
      نوع: array array number[][]
      الزامی

      نقاط داده حجم کل به‌صورت جفت‌های [timestamp, volume]

    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for get/v1/beta/coingecko/coins/{id}/market_chart/range
curl 'https://openapi.felo.ai/v1/beta/coingecko/coins/bitcoin/market_chart/range?from=2025-12-22&to=2025-12-31&vs_currency=usd' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "prices": [
    [
      1779027899041,
      77953.82550382407
    ],
    [
      1779028199661,
      78052.87543398788
    ]
  ],
  "market_caps": [
    [
      1779027899041,
      1560631481361.8042
    ],
    [
      1779028199661,
      1562027330524.267
    ]
  ],
  "total_volumes": [
    [
      1779027899041,
      18688431751.857048
    ],
    [
      1779028199661,
      18974828816.446976
    ]
  ]
}

داده‌های نمودار تاریخی ارز در بازه زمانی

Coin Market Chart Range