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

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

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

CoinGecko

​

Cryptocurrency prices, market data and historical series.

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

​

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

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

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

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

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

    نشانی قرارداد توکن.

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

    شناسه پلتفرم دارایی. *به /asset_platforms اشاره دارد.

پارامترهای پرس‌وجو
  • 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}/contract/{contract_address}/market_chart/range
curl 'https://openapi.felo.ai/v1/beta/coingecko/coins/ethereum/contract/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/market_chart/range?from=2025-12-22&to=2025-12-31&vs_currency=usd' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "prices": [
    [
      1735689600000,
      1.000540738607754
    ],
    [
      1735776000000,
      0.9995995563541714
    ]
  ],
  "market_caps": [
    [
      1735689600000,
      43945617394.42927
    ],
    [
      1735776000000,
      43740787028.36501
    ]
  ],
  "total_volumes": [
    [
      1735689600000,
      6544488766.849924
    ],
    [
      1735776000000,
      5447401746.320422
    ]
  ]
}
Coin Market Chart Range by Contract