核心功能
okx-dex-market 是OKX官方提供的链上市场数据查询工具，专注于实时价格 feeds 与图表分析。核心能力包括：
- 实时价格查询 (
POST /market/price)：获取指定代币的当前美元价格，支持批量查询 - K线/蜡烛图数据 (
GET /market/candles,GET /market/historical-candles)：提供多时间维度（1秒至3月）的OHLCV数据，适用于技术分析 - 交易历史 (
GET /market/trades)：链上买卖流水，含DEX名称、价格、成交量、交易哈希 - 指数价格 (
POST /index/current-price,GET /index/historical-price)：多源聚合价格指数，用于衍生品定价参考
显著优点
1. 官方数据源权威性：直接来自OKX Web3基础设施，与交易所级数据同源
2. 多链覆盖全面：支持XLayer、Solana、Ethereum、Base、BSC、Arbitrum、Polygon等20+公链
3. 细粒度时间周期：K线支持从1秒到3月的15种时间维度，含UTC对齐选项
4. 低延迟实时性：链上价格毫秒级更新，适合量化策略与实时监控
5. 标准化响应：统一{code, data, msg}信封格式，错误码体系完善
局限性与风险
| 维度 | 说明 |
|------|------|
认证门槛 | 需HMAC-SHA256签名，4个头部必填，对新手有一定开发成本 |
| **速率限制** | Trial tier仅1 RPS，跨技能调用需手动添加300-500ms延迟避免触发50011错误 |
| **数据边界** | 不包含市值、流动性、持仓分布等** enriched analytics**，需配合`okx-dex-token`使用 |
| **地址格式敏感** | EVM地址必须全小写，Solana需区分wSOL合约地址与系统程序地址 |
| **新币数据缺失** | 低流动性或新上线代币可能无K线数据 |
适用人群
- 量化交易者：需要程序化获取OHLCV数据进行策略回测
- DeFi开发者：集成实时价格喂价到DApp或监控面板
- 套利策略团队：对比DEX价格与指数价格寻找套利机会
- 投资组合管理：构建多链资产的价格追踪与告警系统
常规风险提示
- API密钥安全：内置测试密钥仅供开发，生产环境务必通过环境变量配置专属密钥
- 超时控制：必须设置10秒请求超时，避免阻塞
- 精度处理：价格字段为字符串，避免浮点精度丢失
- 沙盒限制：共享测试密钥可能触发速率限制，建议尽早申请独立API tier