DEX代币数据入门（免费版）

概述

本工具为个人加密货币投资者提供DEX（去中心化交易所）代币数据查询能力。通过OKX DEX聚合器API，用户可以获取多链代币的实时价格、流动性池信息和基础链上数据。适合DeFi代币研究与投资决策辅助.

核心能力

数据查询功能

功能	说明	免费版支持
代币价格	实时价格与24h变化	支持
流动性池	池子规模与组成	支持
代币信息	合约地址/精度/总量	支持
交易历史	最近交易记录	基础查询
多链支持	支持的区块链	主流5条链
批量查询	多代币并行	不支持
价格告警	阈值通知	不支持
链上分析	深度分析	不支持

处理: 解析数据查询功能的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回数据查询功能的响应数据,包含状态码、结果和日志.

支持的区块链

链名称	Chain ID	支持状态
Ethereum	1	支持
BSC	56	支持
Polygon	137	支持
Arbitrum	42161	支持
Optimism	10	支持

处理: 解析支持的区块链的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回支持的区块链的响应数据,包含状态码、结果和日志.

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

执行此能力时使用input_params参数,支持创建/查询/导出操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：OKX、DEX、API、查询链上代币信息、支持价格、流动性与基础交易、数据获取、面向个人加密货币、投资者的、代币数据查询工具、聚合器、获取多链代币的实、流动性池信息和基、础交易数据、Use、when、需要数据分析、报表生成、统计洞察、数据可视化时使用、不适用于实时流数、据处理、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一：查询代币价格

用户输入："查一下Uniswap代币的价格"

输入格式

参数名	类型	必填	说明
input	string	是	DEX代币数据入门处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

# 查询代币价格
python3 （请参考skill目录中的脚本文件） --token UNIS --chain ethereum
# ..
# 输出：
# === UNIS 代币信息 ===
# 链: Ethereum
# 合约地址: 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984
# 当前价格: $6.85 (+2.3%)
# 24h交易量: $45,230,000
# 流动性: $120,500,000

场景二：流动性池查询

用户输入："看看USDC/WETH池子的流动性"

# 查询流动性池
python3 （请参考skill目录中的脚本文件） \
  --token-a USDC \
  --token-b WETH \
  --chain ethereum
# ..
# 输出池子信息

场景三：代币基础尽调

用户输入："这个代币合约地址是0x..，帮我查查"

# 通过合约地址查询
python3 （请参考skill目录中的脚本文件） \
  --address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 \
  --chain ethereum
# ..
# 输出代币完整信息

快速开始

阅读## 核心能力章节了解skill功能
按## 依赖说明配置环境
执行所需能力对应的命令
参考## 错误处理章节处理异常
查看## FAQ解答常见疑问

环境准备

# 依赖说明
pip install requests web3
# ..
# 配置API（可选，免费版无需API Key）
# 如有OKX API Key可获得更高频率
export OKX_API_KEY="your_api_key"  # 可选

常用命令

# 查询代币
python3 （请参考skill目录中的脚本文件） --token UNIS --chain ethereum
python3 （请参考skill目录中的脚本文件） --token CAKE --chain bsc
# ..
# 流动性池
python3 （请参考skill目录中的脚本文件） --token-a USDC --token-b WETH --chain ethereum
# ..
# 代币列表
python3 （请参考skill目录中的脚本文件） --chain ethereum --top 20
# ..
# 价格历史
python3 （请参考skill目录中的脚本文件） --token UNIS --days 7

示例

查询配置

query_config:
  api:
    endpoint: "https://www.okx.com/dex-api"
    api_key: "${OKX_API_KEY}"      # 可选，无Key使用公共接口
    timeout: 30
    rate_limit: 10                 # 每分钟请求上限
# ..
  chains:
    supported:
      - ethereum
      - bsc
      - polygon
      - arbitrum
      - optimism
# ..
  cache:
    ttl: 60                        # 价格缓存60秒
    storage: "./cache/"

最佳实践

合约地址优先：使用合约地址查询比代币符号更准确
多链验证：同一代币可能在不同链上有不同合约
流动性关注：低流动性代币滑点大，交易需谨慎
安全第一：投资前验证合约地址，防范假冒代币

实践要点	说明
数据时效	DEX价格实时变化，查询结果仅供参考
合约验证	务必通过官方渠道核实合约地址
流动性风险	流动性低于100万美元的池子风险较高
免责声明	数据仅供参考，不构成投资建议

常见问题

Q1：免费版需要OKX API Key吗？

免费版使用公共接口，无需API Key。如有OKX API Key可获得更高请求频率和更多数据维度.

Q2：支持哪些区块链？

免费版支持以太坊、BSC、Polygon、Arbitrum和Optimism五条主流链。如需更多链支持，建议升级PRO版.

Q3：可以执行交易吗？

免费版仅提供数据查询，不支持交易执行。如需通过DEX进行代币兑换，建议使用OKX DEX前端或其他DEX界面.

Q4：数据更新频率如何？

价格数据通过公共接口获取，延迟约1-5分钟。启用缓存后，相同代币的重复查询会命中缓存.

依赖说明

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux
Python版本: 3.8+

第三方依赖

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供
Python	运行时	必需	系统安装或conda环境
requests	Python库	必需	`pip install requests`
web3	Python库	可选	`pip install web3`（链上交互）

API Key 配置

服务	环境变量	是否必需	用途
OKX API	`OKX_API_KEY`	可选	提高请求频率，获取更多数据

未配置API Key时使用公共接口，频率较低
API Key存储在本地环境变量，不会上传

可用性分类

分类: MD+EXEC（Markdown指令+Python脚本执行）
说明: 通过OKX DEX API查询多链代币数据
免费版限制: 基础数据查询、5条链支持、不支持批量与交易执行

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

免费版API调用频率受限（通常10次/分钟），高频数据拉取需配合本地缓存
仅支持OKX DEX支持的区块链网络，不支持中心化交易所（CEX）的代币数据
不提供历史K线数据回测，仅支持当前快照数据查询

DEX代币数据入门

安装到 Tokeny（自动）

SKILL.md