获取热门符文资产系列：API 使用指南与数据分析

在 Web3 和 NFT 领域，及时获取热门资产系列的实时交易数据对于投资者、开发者和市场分析师至关重要。本文详细介绍如何通过专业的 API 接口，高效获取热门符文（Runes）系列的市场数据，包括交易量、市值、持有者数量等关键指标，助您快速把握市场动态。

API 接口概述

该 API 主要用于获取热门符文资产系列的实时交易数据，支持按不同时间范围筛选，并返回排序后的项目列表。通过此接口，用户可以访问包括交易量、市值、地板价等在内的全面市场信息。

核心功能特性

多时间维度筛选：支持 24 小时、7 天、30 天及全部时间范围的数据查询。
分页查询支持：可通过游标（cursor）和分页大小（limit）参数灵活控制返回结果。
丰富的数据字段：涵盖交易量、市值、持有者数、销售笔数、价格增长等关键指标。
多币种计价：同时提供以 BTC 和 USD 计价的交易量、市值及地板价数据。

请求详情

请求地址

GET https://web3.okx.com/api/v5/mktplace/nft/runes/get-hot-collection

请求参数

参数名	类型	是否必填	说明
`timeType`	Integer	否	返回指定时间范围内按交易量排序的项目数据。可选值：1（24小时）、2（7天）、3（30天）、4（全部）。默认值为 1。
`cursor`	String	否	分页游标，用于翻页查询，默认为空。
`limit`	Integer	否	每页返回结果数量，默认为 10。

响应参数

参数名	类型	说明
`cusor`	String	分页游标
`runesId`	String	符文 ID
`name`	String	符文名称
`spaceName`	String	带有点号的符文名称
`maxMintNumber`	String	最大铸造数量
`mintedNumber`	String	已铸造数量
`limitPerMint`	String	每次铸造限制
`deployedTime`	Long	部署时间
`startBlock`	String	起始区块
`endBlock`	String	结束区块
`symbol`	String	符号
`divisibility`	Integer	精度
`collectionUrl`	String	资产系列链接
`totalVolume`	String	交易量（BTC 和 USD）
`usdTotalVolume`	String	交易量（USD）
`marketCap`	String	市值（BTC）
`usdMarketCap`	String	市值（USD）
`floorprice`	String	地板价（Sats）
`usdFloorPrice`	String	地板价（USD）
`holders`	Integer	持有者数量
`salesCount`	Integer	销售笔数
`volumeGains`	String	交易量增长率

使用示例

请求示例

以下示例展示了如何请求过去 24 小时内交易量最高的前 10 个符文资产系列：

curl -X GET "https://web3.okx.com/api/v5/mktplace/nft/runes/get-hot-collection?timeType=1&limit=10"

响应示例

成功的响应将返回一个包含热门系列数据的 JSON 对象，结构如下：

{
  "code": "0",
  "msg": "",
  "data": [
    {
      "cusor": "example_cursor",
      "runesId": "12345",
      "name": "Example Rune",
      "spaceName": "example.rune",
      "maxMintNumber": "10000",
      "mintedNumber": "8500",
      "limitPerMint": "10",
      "deployedTime": 1712345678901,
      "startBlock": "825000",
      "endBlock": "825100",
      "symbol": "EXR",
      "divisibility": 8,
      "collectionUrl": "https://okxdog.com/...",
      "totalVolume": "1.25 BTC / $65,000",
      "usdTotalVolume": "65000",
      "marketCap": "125 BTC",
      "usdMarketCap": "6500000",
      "floorprice": "2500 sats",
      "usdFloorPrice": "0.13",
      "holders": 1200,
      "salesCount": 450,
      "volumeGains": "+15.5%"
    }
  ]
}

👉 查看实时市场数据与更多 API 工具

常见问题

1. 什么是符文（Runes）资产系列？

符文是在比特币区块链上发行的一种可替代代币协议。它允许用户创建和管理独特的数字资产，具有固定的供应量和可定制的属性。每个符文系列包含多个代币，其市场数据反映了该系列的交易活跃度和价值表现。

2. 如何选择合适的时间范围参数？

24小时（1）：适合追踪极短期的市场波动和最新趋势。
7天（2）：平衡了短期噪音和中期趋势，是较常用的选择。
30天（3）：适用于分析中长期的市场表现和周期变化。
全部（4）：提供自部署以来的全部历史数据，适合全面分析。

3. 分页参数 `cursor` 和 `limit` 应如何使用？

当返回数据量较大时，响应中会包含 cursor 字段。将上次响应的 cursor 值填入下一次请求的 cursor 参数中即可获取后续数据。limit 参数则用于控制单次返回的项目数量，可根据实际需求调整。

4. 交易量增长率（volumeGains）是如何计算的？

该字段表示指定时间范围内（与 timeType 一致）交易量相对于上一个相同时间周期的百分比变化。正值为增长，负值为下降，是衡量市场热度变化的重要指标。

5. 市值（Market Cap）和地板价（Floor Price）有什么作用？

市值：由当前地板价与总供应量计算得出，反映了整个资产系列的总估值。
地板价：是该系列中挂牌出售的最低价格，是衡量流动性和入门成本的关键指标。

6. 如何获取某个特定符文系列的详细信息？

本接口返回的是热门系列的聚合列表数据。如需获取某一特定系列的详细 metadata、所有挂牌信息或历史交易记录，需要调用其他专用的系列详情或项目接口。

通过本文介绍的 API，开发者可以高效集成热门符文市场的实时数据，为投资分析、策略制定或应用开发提供坚实的数据支撑。正确理解并运用各项参数与返回字段，是有效利用该接口的关键。