核心功能概述
okx-dex-token是OKX官方提供的多链代币数据分析技能，覆盖XLayer、Solana、Ethereum、Base、BSC、Arbitrum、Polygon等25+主流公链。该技能定位为代币发现与深度分析入口，区别于okx-dex-market的实时价格流与K线数据，专注于代币层面的投研需求。
五大核心能力
| 能力 | 端点 | 典型场景 |
|------|------|---------|
| **代币搜索** | GET /market/token/search | 通过名称/符号/合约地址查找代币，返回价格、24h涨跌、市值、流动性、社区认证状态 |
| **批量基础信息** | POST /market/token/basic-info | 批量获取代币名称、符号、精度、Logo、社区认证状态 |
| **深度价格分析** | POST /market/price-info | 获取市值、流动性、持仓人数、多时间维度价格变化(5m/1h/4h/24h)、交易量、24h高低价 |
| **热度排行榜** | GET /market/token/toplist | 按价格涨幅、交易量、市值排序，支持多时间窗口筛选 |
| **持仓分布** | GET /market/token/holder | 查询Top 20持仓地址及持仓量，评估筹码集中度与鲸鱼风险 |
显著优势
- 官方数据源权威性：直接接入OKX Web3基础设施，数据覆盖CEX上市标准，社区认证标记(
communityRecognized)明确区分主流代币与高风险资产 - 多链统一接口：单一API支持25+链，无需切换不同浏览器或数据源
- 批量查询效率：
/basic-info与/price-info支持JSON数组批量请求，适合投资组合分析 - 安全风控内置：文档明确提示低流动性(<$10K高滑点、<$1K不建议交易)、未认证代币风险、持仓集中度分析，适合交易前尽调
- 生态联动设计：与
okx-dex-market(图表/交易)、okx-dex-swap(兑换)、okx-wallet-portfolio(余额)形成完整DeFi工作流
潜在局限与风险
- 认证门槛：需HMAC-SHA256签名认证，开发者需申请OKX API Key并妥善保管密钥
- 速率限制严格：试用档仅1 RPS，创业档2-50 RPS，跨技能调用需300-500ms延迟，高频场景需企业级方案
- 数据非实时：价格数据存在延迟，不适合高频套利；原始实时价格需切换至
okx-dex-market - 功能边界明确：无K线、无逐笔交易、无原始价格流——这些需配合其他技能
- 地域合规限制：OKX服务受监管政策影响，部分国家/地区用户可能无法使用
适合人群
- DeFi投资者：代币发现、热度追踪、持仓风险评估、交易前流动性检查
- 量化研究员：批量获取多代币基础数据与历史指标，构建筛选策略
- 钱包/应用开发者：集成代币搜索与认证状态，提升用户安全体验
- 社区运营者：监控项目持仓分布与热度变化
常规风险提示
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 合约风险 | `communityRecognized=false`的未认证代币 | 强制风险提示，建议用户自行审计合约 |
| 流动性风险 | 流动性<$10K导致高滑点，<$1K极难成交 | 交易前强制检查`liquidity`字段 |
| 集中度风险 | Top持仓占比过高，存在砸盘可能 | 调用`/holder`分析筹码分布 |
| 速率限制 | 429错误导致服务中断 | 指数退避重试，生产环境使用企业级Key |
| 密钥泄露 | API Key/Secret暴露至日志或前端 | 严格环境变量管理，禁止输出至任何界面 |
典型工作流示例
搜索→分析→交易验证：
1. /token/search发现BONK代币 → 获取合约地址与链ID
2. /price-info分析市值$1.5B、流动性$45M、24h涨幅+12.8%
3. /holder检查Top 20持仓占比，评估鲸鱼风险
4. 切换okx-dex-market查看K线趋势
5. 调用okx-dex-swap执行兑换
该技能是DeFi投研的标准入口工具，数据权威、风控明确，但需注意与其他技能的分工协作及认证合规要求。