掌握加密资产历史币价查询的完整指南

在数字货币领域，及时准确地获取加密资产的历史价格数据对于投资决策、策略回溯与市场分析至关重要。无论是主流币、代币，还是新兴的铭文资产，了解其价格变动轨迹都能为参与者提供关键参考。

历史币价查询的核心功能

通过专业的历史币价查询接口，用户可以获取多种类型的加密资产价格数据：

• 支持主流主链币与各类代币的历史价格回溯
• 兼容 Bitcoin 链上多种铭文代币，例如 BRC-20、Runes、ARC-20 及 SRC-20
• 覆盖 Fractal Bitcoin 链上的 BRC-20 铭文代币历史价格

这使得开发者与分析者能够构建更全面的数据视图，追踪各类资产的市场表现。

接口调用详解

请求路径

使用 GET 方法访问以下路径：
https://web3.okx.com/api/v5/wallet/token/historical-price

主要请求参数说明

调用接口时，需关注以下核心参数：

• chainIndex [字符串，必填]：用于标识目标区块链的唯一标识符

• tokenAddress [字符串，选填]：代币合约地址

  • 查询主链币时传入空字符串 ""
  • 查询代币时传入其合约地址
  • 查询铭文代币需使用特定格式（如 BRC-20 使用 btc-brc20-tick(name) 格式）

• period [字符串，选填]：指定价格数据的时间间隔，支持多种粒度：

  • 1m（1分钟）
  • 5m（5分钟）
  • 30m（30分钟）
  • 1h（1小时）
  • 1d（1天，默认值）

响应数据结构

接口返回标准化的价格数据：

• prices：历史价格数组

  • time：分钟级时间戳（整分钟）
  • price：美元计价价格（18位精度）
• cursor：分页游标，用于获取后续数据

高效查询策略与最佳实践

为了获得最佳查询效果，建议采用以下策略：

1. 合理设置时间范围：通过 begin 和 end 参数限定查询区间，提高查询效率
2. 选择适当时间粒度：根据分析需求选择合适的时间间隔，平衡数据密度与查询性能
3. 利用分页机制：使用 cursor 参数分批获取大量历史数据，避免单次请求数据过载

👉 获取实时币价查询工具 来进一步提升您的数据分析能力。

常见问题解答

历史币价数据包含哪些资产类型？

目前支持主流主链币、ERC-20 等标准代币，以及 Bitcoin 生态中的多种铭文代币，包括 BRC-20、Runes、ARC-20 和 SRC-20 等格式。

如何查询特定铭文代币的价格？

不同协议的铭文代币需要使用特定格式的参数值。例如，BRC-20 代币使用 btc-brc20- 前缀加上代币名称，Runes 代币使用 btc-runesMain- 前缀加上标识符。

数据更新的频率如何？

价格数据根据选择的 period 参数进行聚合，最小时间粒度为 1 分钟，确保数据的时效性和准确性。

最多可以获取多少条历史记录？

单次查询最多可获取 200 条记录，通过分页机制可以获取更长时间范围的历史数据。

通过掌握这些查询技巧，您将能够高效获取各类加密资产的历史价格信息，为投资分析和策略制定提供可靠数据支持。