Felo API PlatformFelo API Platform
全部 CoinGecko 端点
v0.2.0-beta
OpenAPI 3.1.0

按代币地址获取代币价格

服务器:https://openapi.felo.ai
客户端库

CoinGecko

​

Cryptocurrency prices, market data and historical series.

按代币地址获取代币价格

​

以链上合约地址而非 CoinGecko id 为键进行价格查询。id 是资产平台,contract_addresses 是逗号分隔的代币地址列表,vs_currencies 是计价货币。返回以小写合约地址为键的映射,其字段名由计价货币构成——usd,并在设置对应的 include_market_cap、include_24hr_vol、include_24hr_change 和 include_last_updated_at 标志后,额外得到 usd_market_cap、usd_24h_vol、usd_24h_change 和 last_updated_at。当你持有地址而没有 id 时使用。代币的完整概况请使用 get_coingecko_token_data;如果已有 CoinGecko id,请使用 get_coingecko_simple_price。

计费参考

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

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

路径参数
  • id
    类型: string
    必填

    资产平台 ID。 *参见 /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

    需要有效的 Felo API 密钥。

  • 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

需要帮助?