本文档详细介绍了如何通过 API 接口获取特定符文（Runes）系列的详细信息，包括持有人数、系列链接、交易量、交易次数以及地板价等关键数据。无论您是开发者、研究者还是数字资产爱好者，都能通过此接口高效地获取所需的链上数据。
接口基本信息
请求地址
GET https://web3.okx.com/api/v5/mktplace/nft/runes/detail请求参数
调用此接口时，需在请求中提供以下参数：
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| runesId | 字符串 | 是 | 符文ID，支持批量查询，多个ID之间用英文逗号分隔，例如：840000:3,840000:28 |
返回参数说明
接口调用成功后，将返回一个包含以下字段的JSON对象：
| 参数名 | 类型 | 说明 |
|---|---|---|
| runesId | 字符串 | 符文唯一标识ID |
| name | 字符串 | 符文名称 |
| spacename | 字符串 | 带有点号的符文名称 |
| maxMintNumber | 字符串 | 最大铸造数量 |
| mintedNumber | 字符串 | 已铸造数量 |
| limitPerMint | 字符串 | 每次铸造限制数量 |
| deployedTime | 长整型 | 部署时间（时间戳） |
| startBlock | 字符串 | 开始区块高度 |
| endBlock | 字符串 | 结束区块高度 |
| symbol | 字符串 | 符文符号 |
| divisibility | 整数 | 精度（可分割位数） |
| collectionUrl | 字符串 | 符文系列收藏链接 |
| totalVolume | 字符串 | 总交易量（以BTC计价） |
| usdTotalVolume | 字符串 | 总交易量（以USD计价） |
| marketCap | 字符串 | 总市值（以BTC计价） |
| usdMarketCap | 字符串 | 总市值（以USD计价） |
| floorprice | 字符串 | 地板价（以Sats计价） |
| usdFloorPrice | 字符串 | 地板价（以USD计价） |
| holders | 整数 | 持有人数量 |
| salesCount | 整数 | 销售交易次数 |
如何调用此接口
调用此接口非常简单，只需向指定的请求地址发送一个GET请求，并在查询参数中带上需要查询的runesId即可。支持批量查询的功能让您能一次性获取多个符文系列的数据，极大提升了数据获取的效率。
常见问题
什么是符文（Runes）？
符文是比特币区块链上的一种新型可替代代币协议，由开发者Casey Rodarmor提出。它旨在通过UTXO模型发行和管理代币，具有高效、简洁的特点，是BRC-20等标准的潜在竞争者。
如何获取某个符文系列的ID？
符文ID通常在其部署时生成，可以在相关的区块链浏览器、符文市场平台或项目官方渠道中找到。ID的格式通常为“区块高度:索引号”（例如：840000:3）。
返回数据中的“地板价”是什么？
地板价（Floor Price）指的是该符文系列在市场上当前列出的最便宜的单个代币的售价。它是衡量一个收藏品系列市场价值和流动性的重要指标，通常以聪（Sats）或美元（USD）计价。
支持一次查询多少个符文ID？
接口支持批量查询，但出于性能和稳定性的考虑，单次请求的ID数量可能存在上限。建议根据实际需求合理控制批量查询的数量，如需查询大量ID，可考虑分多次请求。
数据是实时的吗？
返回的数据是基于区块链状态和市场信息的最新数据，可视为准实时数据。但请注意，在极端网络条件下或市场剧烈波动时，可能存在微小延迟。
如果查询不存在的符文ID会怎样？
如果请求的runesId不存在或格式错误，接口通常会返回一个错误代码或空数据。建议在调用前确保ID的正确性，并在代码中做好异常处理。
通过本文介绍的API，您可以轻松集成强大的符文数据查询功能，为您的分析、监控或交易策略提供坚实的数据支撑。