Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ 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

        نسبة تغيّر السعر خلال ساعة واحدة لكل عملة

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

        نسبة تغيّر السعر خلال سنة واحدة

      • price_change_percentage_1y_in_currency
        النوع: object

        نسبة تغيّر السعر خلال سنة واحدة لكل عملة

        • 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[]

        بيانات أسعار المخطط المصغّر لسبعة أيام

      • 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