v0.2.0-beta

OpenAPI 3.1.0

代币市场

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

CoinGecko

Cryptocurrency prices, market data and historical series.

CoinGecko 操作

get/v1/beta/coingecko/coins/markets

代币市场

一次调用即可获取覆盖多个代币的排名市场表：每个代币一行，包含 current_price、market_cap、market_cap_rank、total_volume、high_24h、low_24h、price_change_percentage_24h、circulating_supply、total_supply、max_supply、ath 和 atl 及其日期，以及 image。可用 per_page 和 page 分页，order 排序（市值、成交量或 id，升序或降序），ids 或 category 收窄范围。传入 price_change_percentage 会增加对应的 price_change_percentage_24h_in_currency 字段。适用于排行榜和板块扫描。查询少量已知代币的价格时，get_coingecko_simple_price 轻量得多；查看单个代币的完整信息请使用 get_coingecko_coins_id。

计费参考

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

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

查询参数

category
类型: string

按代币类别筛选。 *参见 /coins/categories/list
ids
类型: string

代币 ID，查询多个代币时以逗号分隔。 *参见 /coins/list
include_rehypothecated
类型: boolean

在结果中包含再质押代币。为 true 时返回 market_cap_rank_with_rehypothecated 字段。默认：false
include_tokens
类型: string 枚举

使用 symbols 查询时，指定 all 可包含所有匹配的代币。默认的 top 返回按市值或成交量排名靠前的代币。
值
- top
- all
locale
类型: string 枚举

语言背景。默认：en
值
- ar
- bg
- cs
- da
- de
names
类型: string

代币名称，查询多个代币时以逗号分隔。
order
类型: string 枚举

按字段对结果排序。默认：market_cap_desc
值
- market_cap_asc
- market_cap_desc
- volume_asc
- volume_desc
- id_asc
- id_desc
page
类型: integer

分页浏览结果。默认：1
per_page
类型: integer

每页结果总数。默认：100 有效值：1...250
precision
类型: string 枚举

货币价格值的小数位数
值
- full
- 0
- 1
- 2
- 3
price_change_percentage
类型: string

包含价格变化百分比的时段，查询多个时段时以逗号分隔。有效值：1h、24h、7d、14d、30d、200d、1y
sparkline
类型: boolean

包含 7 天 sparkline 数据。默认：false
symbols
类型: string

代币符号，查询多个代币时以逗号分隔。
vs_currency
类型: string
必填

代币和市场数据的计价货币。 *参见 /simple/supported_vs_currencies

响应

200
类型: array object[] · Response860C3Ae68Ea5_CoinsMarkets

带市场数据的代币列表
ath
类型: number | null
必填

目标货币下的历史最高价

ath_change_percentage
类型: number | null
必填

历史最高价变化百分比

ath_date
类型: string | null 格式: date-time
必填

历史最高价日期

atl
类型: number | null
必填

目标货币下的历史最低价

atl_change_percentage
类型: number | null
必填

历史最低价变化百分比

atl_date
类型: string | null 格式: date-time
必填

历史最低价日期

circulating_supply
类型: number | null
必填

流通供应量

current_price
类型: number | null
必填

目标货币下的当前价格

fully_diluted_valuation
类型: number | null
必填

目标货币下的完全稀释估值

high_24h
类型: number | null
必填

目标货币下的 24 小时最高价

id
类型: string
必填

代币 ID

image
类型: string
必填

代币图片 URL

last_updated
类型: string 格式: date-time
必填

最后更新时间戳

low_24h
类型: number | null
必填

目标货币下的 24 小时最低价

market_cap
类型: number | null
必填

目标货币下的市值

market_cap_change_24h
类型: number | null
必填

目标货币下的 24 小时市值变动

market_cap_change_percentage_24h
类型: number | null
必填

24 小时市值变动百分比

market_cap_rank
类型: integer | null
必填

市值排名

max_supply
类型: number | null
必填

最大供应量

name
类型: string
必填

代币名称

price_change_24h
类型: number | null
必填

目标货币下的 24 小时价格变动

price_change_percentage_24h
类型: number | null
必填

24 小时价格涨跌幅

roi
类型: object | null
必填

投资回报率数据

currency
类型: string

投资回报率货币

percentage
类型: number

投资回报率百分比

times
类型: number

投资回报率倍数

symbol
类型: string
必填

代币符号

total_supply
类型: number | null
必填

总供应量

total_volume
类型: number | null
必填

目标货币下的总交易量

market_cap_rank_with_rehypothecated
类型: integer | null

包含再抵押代币的市值排名

price_change_percentage_14d_in_currency
类型: number | null

目标货币下的 14 天价格涨跌幅

price_change_percentage_1h_in_currency
类型: number | null

目标货币下的 1 小时价格涨跌幅

price_change_percentage_1y_in_currency
类型: number | null

目标货币下的 1 年价格涨跌幅

price_change_percentage_200d_in_currency
类型: number | null

目标货币下的 200 天价格涨跌幅

price_change_percentage_24h_in_currency
类型: number | null

目标货币下的 24 小时价格涨跌幅

price_change_percentage_30d_in_currency
类型: number | null

目标货币下的 30 天价格涨跌幅

price_change_percentage_7d_in_currency
类型: number | null

目标货币下的 7 天价格涨跌幅

sparkline_in_7d
类型: object

最近 7 天的 sparkline 价格数据

price
类型: array number[]

价格值数组
application/json
400

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

需要有效的 Felo API 密钥。
402

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

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

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

服务无法完成该请求。
503

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

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

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

application/json

get/v1/beta/coingecko/coins/markets

curl 'https://openapi.felo.ai/v1/beta/coingecko/coins/markets?vs_currency=usd' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

显示 Schema

[
  {
    "id": "bitcoin",
    "symbol": "btc",
    "name": "Bitcoin",
    "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
    "current_price": 77671,
    "market_cap": 1555886872303,
    "market_cap_rank": 1,
    "fully_diluted_valuation": 1555914058873,
    "total_volume": 33235034316,
    "high_24h": 78419,
    "low_24h": 76696,
    "price_change_24h": -747.3360347281705,
    "price_change_percentage_24h": -0.95302,
    "market_cap_change_24h": -15184401491.513184,
    "market_cap_change_percentage_24h": -0.9665,
    "circulating_supply": 20030493,
    "total_supply": 20030843,
    "max_supply": 21000000,
    "ath": 126080,
    "ath_change_percentage": -38.39571,
    "ath_date": "2025-10-06T18:57:42.558Z",
    "atl": 67.81,
    "atl_change_percentage": 114443.23093,
    "atl_date": "2013-07-06T00:00:00.000Z",
    "roi": null,
    "last_updated": "2026-05-18T12:49:21.599Z",
    "market_cap_rank_with_rehypothecated": 1,
    "sparkline_in_7d": {
      "price": [
        81045.84776489827,
        81001.73089268175,
        80898.20817826076
      ]
    },
    "price_change_percentage_1h_in_currency": 0.5823392426906319,
    "price_change_percentage_24h_in_currency": -0.9530164743774191,
    "price_change_percentage_7d_in_currency": -4.042267423689584,
    "price_change_percentage_14d_in_currency": -1.5720857443461431,
    "price_change_percentage_30d_in_currency": 1.9453890367549207,
    "price_change_percentage_200d_in_currency": -29.452371850925864,
    "price_change_percentage_1y_in_currency": -25.214612207475373
  }
]

带市场数据的代币列表

需要帮助？

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

代币市场

身份验证Required

CoinGecko

代币市场

计费参考

需要帮助？