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.

قیمت ارز بر اساس نشانی توکن

​

جستجوی قیمت با کلید نشانی قرارداد روی زنجیره به‌جای شناسه CoinGecko. id پلتفرم دارایی، contract_addresses فهرستی جداشده با کاما از نشانی‌های توکن، و vs_currencies ارز مبدأ است. نقشه‌ای با کلید نشانی قرارداد حروف کوچک برمی‌گرداند که نام فیلدهایش از ارز مبدأ ساخته می‌شود — usd، به‌همراه usd_market_cap، usd_24h_vol، usd_24h_change و last_updated_at وقتی پرچم‌های متناظر include_market_cap، include_24hr_vol، include_24hr_change و include_last_updated_at تنظیم شده باشند. وقتی نشانی دارید و شناسه ندارید از آن استفاده کنید. برای نمایه کامل توکن از get_coingecko_token_data؛ اگر شناسه CoinGecko را دارید از get_coingecko_simple_price استفاده کنید.

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

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

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

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

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

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

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

  • include_24hr_change
    نوع: boolean

    شامل درصد تغییر 24 ساعته. پیش‌فرض: false

  • include_24hr_vol
    نوع: boolean

    شامل حجم معاملات 24 ساعته. پیش‌فرض: false

  • include_last_updated_at
    نوع: boolean

    شامل زمان آخرین به‌روزرسانی قیمت به‌صورت مهر زمانی UNIX. پیش‌فرض: false

  • include_market_cap
    نوع: boolean

    شامل ارزش بازار. پیش‌فرض: false

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

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

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

    ارز هدف ارزها؛ اگر برای بیش از یک ارز پرس‌وجو می‌کنید، با ویرگول جدا شوند. *به /simple/supported_vs_currencies اشاره دارد

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

    قیمت توکن‌ها

    • propertyName
      نوع: object
      • last_updated_at
        نوع: number

        برچسب زمانی آخرین به‌روزرسانی به ثانیه UNIX

      • usd
        نوع: number

        قیمت در واحد پول هدف

      • usd_24h_change
        نوع: number

        درصد تغییر قیمت 24 ساعته در واحد پول هدف

      • usd_24h_vol
        نوع: number

        حجم معاملات 24 ساعته در واحد پول هدف

      • usd_market_cap
        نوع: number

        ارزش بازار در واحد پول هدف

    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for get/v1/beta/coingecko/simple/token_price/{id}
curl 'https://openapi.felo.ai/v1/beta/coingecko/simple/token_price/ethereum?contract_addresses=0x2260fac5e5542a773aa44fbcfedf7c193bc2c599&vs_currencies=usd' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": {
    "usd": 76721,
    "usd_market_cap": 9008047197.715635,
    "usd_24h_vol": 181232010.10689816,
    "usd_24h_change": -1.6069562341774564,
    "last_updated_at": 1779094527
  }
}
Coin Price by Token Address