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_address توکن است؛ هر دو الزامی‌اند و پارامتر دیگری وجود ندارد. همان شکلی را برمی‌گرداند که get_coingecko_coins_id برمی‌گرداند — description، links، image، categories، platforms، detail_platforms، market_cap_rank، بلوک market_data و آرایه tickers جاسازی‌شده — به‌همراه خود contract_address. از آن برای شناسایی توکن ناشناخته از روی نشانی استفاده کنید. اگر فقط قیمت فعلی لازم است، get_coingecko_simple_token_price_id بسیار سبک‌تر است.

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

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

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

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

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

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

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

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

    داده‌های ارز بر اساس نشانی قرارداد توکن

    • additional_notices
      نوع: array string[]
      الزامی

      اعلان‌های تکمیلی

    • asset_platform_id
      نوع: string | null
      الزامی

      شناسه پلتفرم دارایی ارز

    • block_time_in_minutes
      نوع: number
      الزامی

      زمان بلوک بلاک‌چین بر حسب دقیقه

    • categories
      نوع: array string[]
      الزامی

      دسته‌های ارز

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

      نشانی قرارداد ارز

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

      کشور مبدأ

    • description
      نوع: object
      الزامی

      توضیحات ارز

      • propertyName
        نوع: string
    • detail_platforms
      نوع: object
      الزامی

      پلتفرم دارایی ارز و نشانی قرارداد با جزئیات

      • propertyName
        نوع: object
        • contract_address
          نوع: string

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

        • decimal_place
          نوع: integer | null

          تعداد ارقام اعشار توکن

        • geckoterminal_url
          نوع: string

          نشانی URL GeckoTerminal

    • genesis_date
      نوع: string | null
      الزامی

      تاریخ پیدایش

    • has_supply_breakdown
      نوع: boolean
      الزامی

      اینکه داده‌های تفکیک عرضه دقیق از طریق /coins/supply_breakdown در دسترس است یا نه

    • hashing_algorithm
      نوع: string | null
      الزامی

      الگوریتم هش بلاک‌چین

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

      شناسه ارز

    • image
      نوع: object
      الزامی

      نشانی URL تصویر ارز

      • large
        نوع: string
      • small
        نوع: string
      • thumb
        نوع: string
    • last_updated
      نوع: string
      الزامی

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

    • نوع: object
      الزامی

      پیوندها

      • announcement_url
        نوع: array string[]

        نشانی URL اعلان

      • bitcointalk_thread_identifier
        نوع: integer | null

        شناسه رشته Bitcointalk

      • blockchain_site
        نوع: array string[]

        نشانی URL کاوشگر بلوک

      • chat_url
        نوع: array string[]

        نشانی URL چت

      • facebook_username
        نوع: string

        نام کاربری Facebook

      • homepage
        نوع: array string[]

        نشانی URL وب‌سایت

      • official_forum_url
        نوع: array string[]

        نشانی URL انجمن رسمی

      • repos_url
        نوع: object

        نشانی URL مخزن

        • bitbucket
          نوع: array string[]

          نشانی URL مخزن Bitbucket

        • github
          نوع: array string[]

          نشانی URL مخزن GitHub

      • snapshot_url
        نوع: string | null

        نشانی URL عکس فوری

      • subreddit_url
        نوع: string | null

        نشانی URL Subreddit

      • telegram_channel_identifier
        نوع: string

        شناسه کانال Telegram

      • twitter_screen_name
        نوع: string

        شناسه Twitter

      • whitepaper
        نوع: string

        نشانی URL وایت‌پیپر

    • market_cap_rank
      نوع: integer | null
      الزامی

      رتبه ارزش بازار

    • market_cap_rank_with_rehypothecated
      نوع: integer | null
      الزامی

      رتبه ارزش بازار با احتساب توکن‌های بازرهن‌شده

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

      نام کوین

    • platforms
      نوع: object
      الزامی

      پلتفرم دارایی و آدرس قرارداد کوین

      • propertyName
        نوع: string
    • preview_listing
      نوع: boolean
      الزامی

      کوین در پیش‌نمایش فهرست

    • public_notice
      نوع: string | null
      الزامی

      اطلاعیه عمومی

    • sentiment_votes_down_percentage
      نوع: number | null
      الزامی

      درصد رأی‌های احساسات منفی

    • sentiment_votes_up_percentage
      نوع: number | null
      الزامی

      درصد رأی‌های احساسات مثبت

    • status_updates
      نوع: array object[]
      الزامی

      به‌روزرسانی‌های وضعیت

      • category
        نوع: string

        دسته به‌روزرسانی وضعیت

      • created_at
        نوع: string

        زمان ایجاد به‌روزرسانی وضعیت

      • description
        نوع: string

        توضیحات به‌روزرسانی وضعیت

      • user
        نوع: string

        کاربر به‌روزرسانی وضعیت

      • user_title
        نوع: string

        عنوان کاربر در به‌روزرسانی وضعیت

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

      نماد کوین

    • watchlist_portfolio_users
      نوع: number
      الزامی

      تعداد کاربرانی که این کوین را در نمونه‌کار دنبال می‌کنند

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

      شناسه وب کوین

    • localization
      نوع: object

      بومی‌سازی نام ارز

      • propertyName
        نوع: string
    • market_data
      نوع: object

      داده‌های بازار

      • ath
        نوع: object

        بالاترین قیمت تاریخی به ارز هدف

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

        درصد تغییر بالاترین قیمت تاریخی

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

        تاریخ بالاترین قیمت تاریخی

        • propertyName
          نوع: string
      • atl
        نوع: object

        پایین‌ترین قیمت تاریخی به ارز هدف

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

        درصد تغییر پایین‌ترین قیمت تاریخی

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

        تاریخ پایین‌ترین قیمت تاریخی

        • propertyName
          نوع: string
      • circulating_supply
        نوع: number

        عرضه در گردش

      • current_price
        نوع: object

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

        • propertyName
          نوع: number
      • fdv_to_tvl_ratio
        نوع: number | null

        نسبت FDV به TVL

      • fully_diluted_valuation
        نوع: object

        ارزش کاملاً رقیق‌شده در واحد پول هدف

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

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

        • propertyName
          نوع: number
      • last_updated
        نوع: string

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

      • low_24h
        نوع: object

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

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

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

        • propertyName
          نوع: number
      • market_cap_change_24h
        نوع: number

        تغییر ارزش بازار 24 ساعته در واحد پول هدف

      • market_cap_change_24h_in_currency
        نوع: object

        تغییر ارزش بازار 24 ساعته در واحد پول هدف

        • propertyName
          نوع: number
      • market_cap_change_percentage_24h
        نوع: number

        درصد تغییر ارزش بازار 24 ساعته

      • market_cap_change_percentage_24h_in_currency
        نوع: object

        درصد تغییر ارزش بازار 24 ساعته به تفکیک واحد پول

        • propertyName
          نوع: number
      • market_cap_fdv_ratio
        نوع: number

        نسبت ارزش بازار به FDV

      • market_cap_rank
        نوع: integer | null

        رتبه ارزش بازار

      • market_cap_rank_with_rehypothecated
        نوع: integer | null

        رتبه ارزش بازار با احتساب توکن‌های بازرهن‌شده

      • max_supply
        نوع: number | null

        حداکثر عرضه

      • max_supply_infinite
        نوع: boolean

        حداکثر عرضه نامحدود

      • mcap_to_tvl_ratio
        نوع: number | null

        نسبت ارزش بازار به TVL

      • outstanding_supply
        نوع: number | null

        توکن‌های در گردش در بازار

      • outstanding_token_value_usd
        نوع: number | null

        ارزش توکن‌های در گردش به دلار آمریکا

      • price_change_24h
        نوع: number

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

      • price_change_24h_in_currency
        نوع: object

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

        • propertyName
          نوع: number
      • price_change_percentage_14d
        نوع: number

        درصد تغییر قیمت 14 روزه

      • price_change_percentage_14d_in_currency
        نوع: object

        درصد تغییر قیمت 14 روزه به تفکیک واحد پول

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

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

        • propertyName
          نوع: number
      • price_change_percentage_1y
        نوع: number

        درصد تغییر قیمت 1 ساله

      • price_change_percentage_1y_in_currency
        نوع: object

        درصد تغییر قیمت 1 ساله به تفکیک واحد پول

        • propertyName
          نوع: number
      • price_change_percentage_200d
        نوع: number

        درصد تغییر قیمت 200 روزه

      • price_change_percentage_200d_in_currency
        نوع: object

        درصد تغییر قیمت 200 روزه به تفکیک واحد پول

        • propertyName
          نوع: number
      • price_change_percentage_24h
        نوع: number

        درصد تغییر قیمت 24 ساعته

      • price_change_percentage_24h_in_currency
        نوع: object

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

        • propertyName
          نوع: number
      • price_change_percentage_30d
        نوع: number

        درصد تغییر قیمت 30 روزه

      • price_change_percentage_30d_in_currency
        نوع: object

        درصد تغییر قیمت 30 روزه به تفکیک واحد پول

        • propertyName
          نوع: number
      • price_change_percentage_60d
        نوع: number

        درصد تغییر قیمت 60 روزه

      • price_change_percentage_60d_in_currency
        نوع: object

        درصد تغییر قیمت 60 روزه به تفکیک واحد پول

        • propertyName
          نوع: number
      • price_change_percentage_7d
        نوع: number

        درصد تغییر قیمت 7 روزه

      • price_change_percentage_7d_in_currency
        نوع: object

        درصد تغییر قیمت 7 روزه به تفکیک واحد پول

        • propertyName
          نوع: number
      • roi
        نوع: object | null

        بازده سرمایه‌گذاری

        • currency
          نوع: string

          واحد پول ROI

        • percentage
          نوع: number

          درصد ROI

        • times
          نوع: number

          ضریب ROI

      • sparkline_7d
        نوع: array number[]

        داده‌های قیمت اسپارکلاین 7 روزه

      • total_supply
        نوع: number

        کل عرضه

      • total_value_locked
        نوع: number | null

        کل ارزش قفل‌شده

      • total_volume
        نوع: object

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

        • propertyName
          نوع: number
    • tickers
      نوع: array object[]

      تیکرها

      • base
        نوع: string

        واحد پول پایه تیکر

      • bid_ask_spread_percentage
        نوع: number

        درصد اسپرد خرید و فروش تیکر

      • coin_id
        نوع: string

        شناسه کوین واحد پول پایه تیکر

      • coin_mcap_usd
        نوع: number

        ارزش بازار به دلار آمریکا

      • converted_last
        نوع: object

        آخرین قیمت تبدیل‌شده تیکر

        • btc
          نوع: number
        • eth
          نوع: number
        • usd
          نوع: number
      • converted_volume
        نوع: object

        حجم تبدیل‌شده تیکر

        • btc
          نوع: number
        • eth
          نوع: number
        • usd
          نوع: number
      • is_anomaly
        نوع: boolean

        ناهنجاری تیکر

      • is_stale
        نوع: boolean

        کهنگی تیکر

      • last
        نوع: number

        آخرین قیمت تیکر

      • last_fetch_at
        نوع: string

        برچسب زمانی آخرین واکشی تیکر

      • last_traded_at
        نوع: string

        برچسب زمانی آخرین معامله تیکر

      • market
        نوع: object

        صرافی تیکر

        • has_trading_incentive
          نوع: boolean

          مشوق معاملاتی صرافی

        • identifier
          نوع: string

          شناسه صرافی

        • name
          نوع: string

          نام صرافی

      • target
        نوع: string

        واحد پول هدف تیکر

      • target_coin_id
        نوع: string

        شناسه کوین واحد پول هدف تیکر

      • timestamp
        نوع: string

        برچسب زمانی تیکر

      • token_info_url
        نوع: string | null

        نشانی URL اطلاعات توکن تیکر

      • trade_url
        نوع: string

        نشانی URL معامله تیکر

      • trust_score
        نوع: string | null

        امتیاز اعتماد تیکر

      • volume
        نوع: number

        حجم تیکر

    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}
curl https://openapi.felo.ai/v1/beta/coingecko/coins/ethereum/contract/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": "weth",
  "symbol": "weth",
  "name": "WETH",
  "web_slug": "weth",
  "asset_platform_id": "ethereum",
  "platforms": {
    "ethereum": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "terra-2": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674",
    "tron": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF"
  },
  "detail_platforms": {
    "ethereum": {
      "decimal_place": 18,
      "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "geckoterminal_url": "https://www.geckoterminal.com/eth/tokens/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    },
    "terra-2": {
      "decimal_place": 18,
      "contract_address": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674"
    },
    "tron": {
      "decimal_place": 18,
      "contract_address": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF",
      "geckoterminal_url": "https://www.geckoterminal.com/tron/tokens/THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF"
    }
  },
  "block_time_in_minutes": 0,
  "hashing_algorithm": null,
  "categories": [
    "Crypto-Backed Tokens",
    "Wrapped-Tokens",
    "Terra Ecosystem",
    "Ethereum Ecosystem",
    "FTX Holdings",
    "Tron Ecosystem",
    "Index Coop Defi Index"
  ],
  "preview_listing": false,
  "public_notice": null,
  "additional_notices": [],
  "has_supply_breakdown": false,
  "localization": {
    "en": "WETH",
    "de": "",
    "es": "",
    "fr": "",
    "it": "",
    "pl": "",
    "ro": "",
    "hu": "",
    "nl": "",
    "pt": ""
  },
  "description": {
    "en": "What is WETH (Wrapped ETH)?\nWETH is the tokenized/packaged form of ETH..."
  },
  "links": {
    "homepage": [
      "https://ethereum.org/en/wrapped-eth"
    ],
    "whitepaper": "",
    "blockchain_site": [
      "https://etherscan.io/token/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "https://intel.arkm.com/explorer/token/weth"
    ],
    "official_forum_url": [],
    "chat_url": [],
    "announcement_url": [],
    "snapshot_url": null,
    "twitter_screen_name": "",
    "facebook_username": "",
    "bitcointalk_thread_identifier": null,
    "telegram_channel_identifier": "",
    "subreddit_url": null,
    "repos_url": {
      "github": [],
      "bitbucket": []
    }
  },
  "image": {
    "thumb": "https://coin-images.coingecko.com/coins/images/2518/thumb/weth.png?1696503332",
    "small": "https://coin-images.coingecko.com/coins/images/2518/small/weth.png?1696503332",
    "large": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332"
  },
  "country_origin": "",
  "genesis_date": "2016-06-17",
  "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "sentiment_votes_up_percentage": null,
  "sentiment_votes_down_percentage": null,
  "watchlist_portfolio_users": 34782,
  "market_cap_rank": null,
  "market_cap_rank_with_rehypothecated": 30,
  "market_data": {
    "current_price": {
      "btc": 0.02728343,
      "eth": 0.99972363,
      "usd": 2115.04
    },
    "total_value_locked": null,
    "mcap_to_tvl_ratio": null,
    "fdv_to_tvl_ratio": null,
    "roi": null,
    "ath": {
      "btc": 0.14280504,
      "eth": 3.614831,
      "usd": 4950.08
    },
    "ath_change_percentage": {
      "btc": -80.89678,
      "eth": -72.33124,
      "usd": -57.2622
    },
    "ath_date": {
      "btc": "2018-09-02T00:00:00.000Z",
      "eth": "2018-09-13T00:00:00.000Z",
      "usd": "2025-08-24T19:28:11.411Z"
    },
    "atl": {
      "btc": 0.00890197,
      "eth": 0.22395179,
      "usd": 82.1
    },
    "atl_change_percentage": {
      "btc": 206.45314,
      "eth": 346.6045,
      "usd": 2476.69436
    },
    "atl_date": {
      "btc": "2025-09-02T07:56:48.935Z",
      "eth": "2025-09-02T07:56:48.935Z",
      "usd": "2018-12-15T00:00:00.000Z"
    },
    "market_cap": {
      "btc": 61868,
      "eth": 2267403,
      "usd": 4793905266
    },
    "market_cap_rank": null,
    "outstanding_token_value_usd": null,
    "market_cap_rank_with_rehypothecated": 30,
    "fully_diluted_valuation": {
      "btc": 61868,
      "eth": 2267403,
      "usd": 4793905266
    },
    "market_cap_fdv_ratio": 1,
    "total_volume": {
      "btc": 107.294,
      "eth": 3931,
      "usd": 8317546
    },
    "high_24h": {
      "btc": 0.02756131,
      "eth": 1.00272,
      "usd": 2125.08
    },
    "low_24h": {
      "btc": 0.02717062,
      "eth": 0.99799697,
      "usd": 2068.79
    },
    "price_change_24h": -3.316519511214,
    "price_change_percentage_24h": -0.15656,
    "price_change_percentage_7d": -0.0669,
    "price_change_percentage_14d": -9.45938,
    "price_change_percentage_30d": -8.82256,
    "price_change_percentage_60d": 1.63545,
    "price_change_percentage_200d": -37.57849,
    "price_change_percentage_1y": -14.56267,
    "market_cap_change_24h": -12121742.79577,
    "market_cap_change_percentage_24h": -0.25222,
    "price_change_24h_in_currency": {
      "btc": -0.000274386252168236,
      "eth": -0.000212661454704888,
      "usd": -3.3165195112137553
    },
    "price_change_percentage_1h_in_currency": {
      "btc": -0.19183,
      "eth": 0.00019,
      "usd": -0.00865
    },
    "price_change_percentage_24h_in_currency": {
      "btc": -0.99568,
      "eth": -0.02127,
      "usd": -0.15656
    },
    "price_change_percentage_7d_in_currency": {
      "btc": -0.89914,
      "eth": -0.05304,
      "usd": -0.0669
    },
    "price_change_percentage_14d_in_currency": {
      "btc": -5.49184,
      "eth": -0.04201,
      "usd": -9.45938
    },
    "price_change_percentage_30d_in_currency": {
      "btc": -8.68383,
      "eth": -0.02751,
      "usd": -8.82256
    },
    "price_change_percentage_60d_in_currency": {
      "btc": -8.8249,
      "eth": 0.0505,
      "usd": 1.63545
    },
    "price_change_percentage_200d_in_currency": {
      "btc": -17.15793,
      "eth": -0.10813,
      "usd": -37.57849
    },
    "price_change_percentage_1y_in_currency": {
      "btc": 18.09057,
      "eth": 0.19761,
      "usd": -14.56267
    },
    "market_cap_change_24h_in_currency": {
      "btc": -635.7460114267669,
      "eth": -986.7877555103041,
      "usd": -12121742.795770645
    },
    "market_cap_change_percentage_24h_in_currency": {
      "btc": -1.01713,
      "eth": -0.0435,
      "usd": -0.25222
    },
    "total_supply": 2267926.915444636,
    "max_supply": null,
    "max_supply_infinite": true,
    "circulating_supply": 2267926.915444636,
    "outstanding_supply": null,
    "last_updated": "2026-05-25T10:09:02.821Z"
  },
  "status_updates": [],
  "last_updated": "2026-05-25T10:09:02.821Z",
  "tickers": [
    {
      "base": "WETH",
      "target": "USDC",
      "market": {
        "name": "Native",
        "identifier": "native",
        "has_trading_incentive": false
      },
      "last": 2114.7318378964214,
      "volume": 2999.739679821518,
      "converted_last": {
        "btc": 0.02728106,
        "eth": 1.000065,
        "usd": 2114.1
      },
      "converted_volume": {
        "btc": 81.256,
        "eth": 2979,
        "usd": 6296774
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.04287,
      "timestamp": "2026-05-25T10:04:42+00:00",
      "last_traded_at": "2026-05-25T10:04:42+00:00",
      "last_fetch_at": "2026-05-25T10:04:42+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://native.org/app/swap/",
      "token_info_url": null,
      "coin_id": "weth",
      "target_coin_id": "usd-coin",
      "coin_mcap_usd": 4793905265.563903
    }
  ]
}
Coin Data by Token Address