v0.2.0-beta

OpenAPI 3.1.0

按 ID 获取代币数据

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

CoinGecko

Cryptocurrency prices, market data and historical series.

CoinGecko 操作

get/v1/beta/coingecko/coins/{id}

按 ID 获取代币数据

通过 id 选择并返回 CoinGecko 关于单个代币的全部信息：description、links、image、categories、platforms 和 detail_platforms（各链上的合约地址）、market_cap_rank，以及包含 current_price、market_cap、total_volume、fully_diluted_valuation、ath 和 atl（带日期与涨跌百分比）的 market_data 块。较大的部分需通过 market_data、community_data、developer_data、tickers、sparkline 和 localization 主动开启——除非确有需要，否则请保持关闭，完整负载很大。适用于代币概况。需要跨多个代币的价格表时，请使用 get_coingecko_coins_markets；需要按合约地址查询同一个代币时，请使用 get_coingecko_token_data。

计费参考

计量方式：套餐资源单位。
参考请求估算：0.008 美元。
单位成本基准：0.0 美元。
资源单位：provider_credit。
成本基准不构成最终客户价格，即使为零也不例外。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

路径参数

id
类型: string
必填

代币 ID。 *参见 /coins/list

查询参数

community_data
类型: boolean
已弃用

包含社区数据。已弃用：自 2026 年 8 月 28 日起不再生效；不再返回 community_data 对象。
developer_data
类型: boolean
已弃用

包含开发者数据。已弃用：自 2026 年 8 月 28 日起不再生效；不再返回 developer_data 对象。
dex_pair_format
类型: string 枚举

设为 symbol 可将 DEX 交易对的基础货币和目标货币显示为符号。默认：contract_address
值
- contract_address
- symbol
include_categories_details
类型: boolean

包含类别详情。默认：false
localization
类型: boolean

在响应中包含所有本地化语言。默认：true
market_data
类型: boolean

包含市场数据。默认：true
sparkline
类型: boolean

包含 7 天 sparkline 数据。默认：false
tickers
类型: boolean

包含交易对数据。默认：true

响应

200
类型: object · Response860C3Ae68Ea5_CoinsID

代币数据
additional_notices
类型: array string[]
必填

附加声明

asset_platform_id
类型: string | null
必填

代币资产平台 ID

block_time_in_minutes
类型: number
必填

区块链出块时间（分钟）

categories
类型: array string[]
必填

代币类别

country_origin
类型: string
必填

原产国

description
类型: object
必填

代币描述

propertyName
类型: string
detail_platforms
类型: object
必填

详细的代币资产平台和合约地址

propertyName
类型: object
contract_address
类型: string

代币合约地址

decimal_place
类型: integer | null

代币小数位数

genesis_date
类型: string | null
必填

创世日期

has_supply_breakdown
类型: boolean
必填

是否可通过 /coins/supply_breakdown 获取详细的供应量明细数据

hashing_algorithm
类型: string | null
必填

区块链哈希算法

id
类型: string
必填

代币 ID

image
类型: object
必填

代币图片 URL

large
类型: string
small
类型: string
thumb
类型: string
last_updated
类型: string
必填

最后更新时间戳

links
类型: 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[]

Bitbucket 仓库 URL

github
类型: array string[]

GitHub 仓库 URL

snapshot_url
类型: string | null

快照 URL

subreddit_url
类型: string

Subreddit 的 URL

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
必填

代币网页 slug

categories_details
类型: array object[]

代币详细分类

id
类型: string

类别 ID

name
类型: string

类别名称

ico_data
类型: object | null

ICO 数据

accepting_currencies
类型: string

接受的货币

amount_for_sale
类型: number

出售数量

base_pre_sale_amount
类型: number

基础货币预售数量

base_public_sale_amount
类型: number

基础货币公开发售数量

bounty_detail_url
类型: string

赏金详情 URL

country_origin
类型: string

原产国

description
类型: string

详细描述

hardcap_amount
类型: number

硬顶金额

hardcap_currency
类型: string

硬顶货币

ico_end_date
类型: string

ICO 结束日期

ico_start_date
类型: string

ICO 开始日期

kyc_required
类型: boolean

需要 KYC

links
类型: object

ICO 相关链接

propertyName
类型: string
pre_sale_available
类型: boolean

可预售

pre_sale_end_date
类型: string

预售结束日期

pre_sale_ended
类型: boolean

预售已结束

pre_sale_start_date
类型: string

预售开始日期

quote_pre_sale_amount
类型: number

计价货币预售数量

quote_pre_sale_currency
类型: string

预售计价货币

quote_public_sale_amount
类型: number

计价货币公开发售数量

quote_public_sale_currency
类型: string

公开发售计价货币

short_desc
类型: string

简短描述

softcap_amount
类型: number

软顶金额

softcap_currency
类型: string

软顶货币

total_raised
类型: number

募资总额

total_raised_currency
类型: string

募资总额货币

whitelist_available
类型: boolean

可加入白名单

whitelist_end_date
类型: string

白名单结束日期

whitelist_start_date
类型: string

白名单开始日期

whitelist_url
类型: string

白名单 URL

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

完全稀释估值与总锁定价值之比

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

市值与完全稀释估值之比

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

市值与总锁定价值之比

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

投资回报率货币

percentage
类型: number

投资回报率百分比

times
类型: number

投资回报率倍数

sparkline_7d
类型: array number[]

7 天 sparkline 价格数据

total_supply
类型: number

总供应量

total_value_locked
类型: number | null

总锁定价值

total_volume
类型: object

目标货币下的总交易量

propertyName
类型: number
tickers
类型: array object[]

Ticker 数据

base
类型: string

Ticker 基础货币

bid_ask_spread_percentage
类型: number

Ticker 买卖价差百分比

coin_id
类型: string

Ticker 基础货币代币 ID

coin_mcap_usd
类型: number

市值（美元）

converted_last
类型: object

Ticker 换算后最新价

btc
类型: number
eth
类型: number
usd
类型: number
converted_volume
类型: object

Ticker 换算后交易量

btc
类型: number
eth
类型: number
usd
类型: number
is_anomaly
类型: boolean

Ticker 异常

is_stale
类型: boolean

Ticker 数据陈旧

last
类型: number

Ticker 最新价

last_fetch_at
类型: string

Ticker 最后抓取时间戳

last_traded_at
类型: string

Ticker 最后成交时间戳

market
类型: object

Ticker 交易所

has_trading_incentive
类型: boolean

交易所交易激励

identifier
类型: string

交易所标识符

name
类型: string

交易所名称

target
类型: string

Ticker 目标货币

target_coin_id
类型: string

Ticker 目标货币代币 ID

timestamp
类型: string

Ticker 时间戳

token_info_url
类型: string | null

Ticker 代币信息 URL

trade_url
类型: string

Ticker 交易 URL

trust_score
类型: string | null

Ticker 信任评分

volume
类型: number

Ticker 交易量
application/json
400

无法处理该请求。请检查请求参数。
401

需要有效的 Felo API 密钥。
402

由于未满足计费要求，请求无法继续。
403

该账户无权执行此操作。
429

已达到请求或支出限额。
502

服务无法完成该请求。
503

API 或计费服务暂时不可用。
504

服务在处理请求时超时。
default

错误响应；上游透传响应可能采用提供方格式

application/json

get/v1/beta/coingecko/coins/{id}

curl https://openapi.felo.ai/v1/beta/coingecko/coins/bitcoin \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

显示 Schema

{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "web_slug": "bitcoin",
  "asset_platform_id": null,
  "platforms": {
    "": ""
  },
  "detail_platforms": {
    "": {
      "decimal_place": null,
      "contract_address": ""
    }
  },
  "block_time_in_minutes": 10,
  "hashing_algorithm": "SHA-256",
  "categories": [
    "Cryptocurrency",
    "Layer 1 (L1)"
  ],
  "preview_listing": false,
  "public_notice": null,
  "additional_notices": [],
  "has_supply_breakdown": false,
  "description": {
    "en": "Bitcoin is the first successful internet money based on peer-to-peer technology..."
  },
  "links": {
    "homepage": [
      "http://www.bitcoin.org",
      "",
      ""
    ],
    "whitepaper": "https://bitcoin.org/bitcoin.pdf",
    "blockchain_site": [
      "https://mempool.space/",
      "https://blockchair.com/bitcoin/"
    ],
    "official_forum_url": [
      "https://bitcointalk.org/"
    ],
    "chat_url": [
      ""
    ],
    "announcement_url": [
      "",
      ""
    ],
    "snapshot_url": null,
    "twitter_screen_name": "bitcoin",
    "facebook_username": "bitcoins",
    "bitcointalk_thread_identifier": null,
    "telegram_channel_identifier": "",
    "subreddit_url": "https://www.reddit.com/r/Bitcoin/",
    "repos_url": {
      "github": [
        "https://github.com/bitcoin/bitcoin",
        "https://github.com/bitcoin/bips"
      ],
      "bitbucket": []
    }
  },
  "image": {
    "thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400",
    "small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
    "large": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1696501400"
  },
  "country_origin": "",
  "genesis_date": "2009-01-03",
  "sentiment_votes_up_percentage": 84.07,
  "sentiment_votes_down_percentage": 15.93,
  "watchlist_portfolio_users": 1541900,
  "market_cap_rank": 1,
  "market_cap_rank_with_rehypothecated": 1,
  "status_updates": [],
  "last_updated": "2024-04-07T15:24:51.021Z",
  "market_data": {
    "current_price": {
      "btc": 1,
      "eur": 64375,
      "usd": 69840
    },
    "total_value_locked": null,
    "mcap_to_tvl_ratio": null,
    "fdv_to_tvl_ratio": null,
    "roi": null,
    "ath": {
      "btc": 1.003301,
      "eur": 67405,
      "usd": 73738
    },
    "ath_change_percentage": {
      "btc": -0.32896,
      "eur": -4.54383,
      "usd": -5.33399
    },
    "ath_date": {
      "btc": "2024-03-02T16:05:19.446Z",
      "eur": "2024-03-14T07:10:36.635Z",
      "usd": "2024-03-14T07:10:36.635Z"
    },
    "atl": {
      "btc": 0.99895134,
      "eur": 51.3,
      "usd": 67.81
    },
    "atl_change_percentage": {
      "btc": 0.10408,
      "eur": 125385.41242,
      "usd": 102882.36498
    },
    "atl_date": {
      "btc": "2019-10-21T00:00:00.000Z",
      "eur": "2013-07-05T00:00:00.000Z",
      "usd": "2013-07-06T00:00:00.000Z"
    },
    "market_cap": {
      "btc": 19675377,
      "eur": 1265825267281,
      "usd": 1373296629498
    },
    "fully_diluted_valuation": {
      "btc": 21000000,
      "eur": 1351831155,
      "usd": 1466577759
    },
    "market_cap_fdv_ratio": 1,
    "market_cap_rank": 1,
    "outstanding_token_value_usd": null,
    "market_cap_rank_with_rehypothecated": 1,
    "total_volume": {
      "btc": 270165,
      "eur": 17368113665,
      "usd": 18867210007
    },
    "high_24h": {
      "btc": 1,
      "eur": 64343,
      "usd": 69805
    },
    "low_24h": {
      "btc": 1,
      "eur": 62695,
      "usd": 67985
    },
    "price_change_24h": 1619,
    "price_change_percentage_24h": 2.37311,
    "price_change_percentage_7d": -0.89706,
    "price_change_percentage_14d": 6.36178,
    "price_change_percentage_30d": 1.81171,
    "price_change_percentage_60d": 62.54292,
    "price_change_percentage_200d": 157.51875,
    "price_change_percentage_1y": 149.76989,
    "market_cap_change_24h": 31172487848,
    "market_cap_change_percentage_24h": 2.32219,
    "price_change_24h_in_currency": {
      "btc": 0,
      "eur": 1461.64,
      "usd": 1618.95
    },
    "price_change_percentage_1h_in_currency": {
      "btc": 0,
      "eur": 0.79523,
      "usd": 0.79523
    },
    "price_change_percentage_24h_in_currency": {
      "btc": 0,
      "eur": 2.32219,
      "usd": 2.37311
    },
    "price_change_percentage_7d_in_currency": {
      "btc": 0,
      "eur": -1.01955,
      "usd": -0.89706
    },
    "price_change_percentage_14d_in_currency": {
      "btc": 0,
      "eur": 5.84662,
      "usd": 6.36178
    },
    "price_change_percentage_30d_in_currency": {
      "btc": 0,
      "eur": 2.28048,
      "usd": 1.81171
    },
    "price_change_percentage_60d_in_currency": {
      "btc": 0,
      "eur": 60.98834,
      "usd": 62.54292
    },
    "price_change_percentage_200d_in_currency": {
      "btc": 0,
      "eur": 148.68948,
      "usd": 157.51875
    },
    "price_change_percentage_1y_in_currency": {
      "btc": 0,
      "eur": 138.20277,
      "usd": 149.76989
    },
    "market_cap_change_24h_in_currency": {
      "btc": -49432,
      "eur": 28668703539,
      "usd": 31172487848
    },
    "market_cap_change_percentage_24h_in_currency": {
      "btc": -0.25084,
      "eur": 2.31801,
      "usd": 2.32219
    },
    "total_supply": 21000000,
    "max_supply": 21000000,
    "max_supply_infinite": false,
    "circulating_supply": 19675377,
    "outstanding_supply": null,
    "last_updated": "2024-04-07T15:24:51.021Z"
  },
  "tickers": [
    {
      "base": "BTC",
      "target": "USDT",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false
      },
      "last": 69816,
      "volume": 19988.82111,
      "converted_last": {
        "btc": 0.99999255,
        "eth": 20.441016,
        "usd": 69835
      },
      "converted_volume": {
        "btc": 19783,
        "eth": 404380,
        "usd": 1381537193
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.010014,
      "timestamp": "2024-04-07T15:23:02+00:00",
      "last_traded_at": "2024-04-07T15:23:02+00:00",
      "last_fetch_at": "2024-04-07T15:24:00+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
      "token_info_url": null,
      "coin_id": "bitcoin",
      "target_coin_id": "tether",
      "coin_mcap_usd": 230926944910.5146
    }
  ]
}

代币数据

需要帮助？

API、计费或账号问题，请联系支持。
在 Discord 上与 Felo 开发者交流。
查看我们的更新日志。
需要批量定价或采购支持？联系销售。
正在使用 LLM 构建？阅读 llms.txt。

按 ID 获取代币数据

身份验证Required

CoinGecko

按 ID 获取代币数据

计费参考

需要帮助？