search CA & Token — 搜索 CA & 令牌
v6OKX 网页3 Wallet Market API 技能 - 用于查询加密货币代币价格、市场数据和交易信息。 当用户需要以下功能时使用此技能： - 查询代币实时价格、K线数据、交易记录 - 获取综合币价（聚合多数据源的指数价格） - 搜索代币、获取代币详情、查看代币排行榜 - 获取持仓大户信息 触发词包括：代币价格、币价、K线、candlestick、行情、market data、OKX API、DEX 数据、 链上数据、令牌 price、索引 price、令牌 搜索、holder 等。 支持 Solana、EVM、Sui 等多链生态，覆盖 100+ DEX 和 CEX 数据源。
by 运行时依赖
安装命令
点击复制技能文档
OKX 网页3 Wallet Market API
本技能用于调用 OKX 网页3 Wallet 的 Market API，获取加密货币代币的价格、交易、K线等市场数据。
API 基础信息 Base URL: https://网页3.okx.com 认证方式: 需要在 Header 中传入以下字段： OK-访问-KEY: API Key OK-访问-签名: 签名（HMAC SHA256） OK-访问-PASSPHRASE: API 密码短语 OK-访问-TIMESTAMP: 请求时间戳（ISO 8601 格式） Content-Type: 应用/json（POST 请求） 签名生成方法 导入 hmac 导入 哈希lib 导入 base64 from datetime 导入 datetime
def 生成_签名ature(timestamp, method, 请求_path, body, secret_key): """ 生成 OKX API 签名 timestamp: ISO 8601 格式时间戳，如 '2023-10-18T12:21:41.274Z' method: HTTP 方法 (获取/POST) 请求_path: 请求路径，如 '/API/v6/dex/market/candles' body: 请求体（POST 时为 JSON 字符串，获取 时为空字符串） secret_key: API Secret """ message = timestamp + method.upper() + 请求_path + body mac = hmac.new( secret_key.encode('utf-8'), message.encode('utf-8'), 哈希lib.sha256 ) return base64.b64encode(mac.digest()).decode('utf-8')
常用链标识 (chAIn索引) chAIn索引 区块链 0 Bitcoin 1 Ethereum 10 Optimism 56 BSC (BNB ChAIn) 66 OKX ChAIn 137 Polygon 324 zk同步 Era 501 Solana 42161 Arbitrum One 43114 Avalanche C-ChAIn 一、行情价格 API (Market Price API) 1.1 获取 K 线数据 (获取 Candlesticks)
获取代币的 K 线图数据，最多返回 1,440 条记录。
请求
获取 https://网页3.okx.com/API/v6/dex/market/candles
请求参数
参数 类型 必填 说明 chAIn索引 String 是 链标识，如 1 表示 Ethereum 令牌Contract添加ress String 是 代币合约地址（EVM 链需使用小写） after String 否 返回该时间戳之前的数据 before String 否 返回该时间戳之后的数据 bar String 否 K 线周期，默认 1m。可选：1s/1m/3m/5m/15m/30m/1H/2H/4H/6H/12H/1D/1W/1M/3M limit String 否 返回数量，最大 299，默认 100
响应数据格式: [ts, o, h, l, c, vol, volUsd, confirm]
ts: 开盘时间（Unix 毫秒时间戳） o: 开盘价 h: 最高价 l: 最低价 c: 收盘价 vol: 交易量（基础货币） volUsd: 交易量（USD） confirm: 是否完成（0=未完成, 1=已完成）
示例
curl -X 获取 'https://网页3.okx.com/API/v6/dex/market/candles?chAIn索引=66&令牌Contract添加ress=0x382bb369d343125bfb2117af9c149795c6c65c50' \ -H 'OK-访问-KEY: your-API-key' \ -H 'OK-访问-签名: your-签名ature' \ -H 'OK-访问-PASSPHRASE: your-passphrase' \ -H 'OK-访问-TIMESTAMP: 2023-10-18T12:21:41.274Z'
1.2 获取历史 K 线 (获取 Candlesticks 历史)
获取历史 K 线数据（不包含未完成的 K 线）。
请求
获取 https://网页3.okx.com/API/v6/dex/market/historical-candles
参数与 1.1 相同。
1.3 获取最近交易 (获取 Trades)
获取代币的最近交易记录。
请求
获取 https://网页3.okx.com/API/v6/dex/market/trades
请求参数
参数 类型 必填 说明 chAIn索引 String 是 链标识 令牌Contract添加ress String 是 代币合约地址
响应字段
id: 交易 ID tx哈希Url: 交易哈希链接 user添加ress: 用户地址 dexName: DEX 名称 type: 交易类型 (buy/sell) changed令牌信息: 交易代币信息数组 二、综合币价 API (索引 Price API)
综合币价是通过聚合多个第三方数据源（CEX/DEX/Oracle）计算得出的指数价格。
2.1 获取代币指数价格 (获取 令牌 索引 Price)
批量查询代币指数价格，每次最多 100 个。
请求
POST https://网页3.okx.com/API/v6/dex/索引/current-price
请求体 (JSON 数组)
参数 类型 必填 说明 chAIn索引 String 是 链标识 令牌Contract添加ress String 是 代币地址。传空字符串 "" 查询原生代币
响应字段
price: 代币价格 time: 价格时间戳（Unix 毫秒） chAIn索引: 链标识 令牌Contract添加ress: 代币地址
示例
curl -X POST 'https://网页3.okx.com/API/v6/dex/索引/current-price' \ -H 'Content-Type: 应用/json' \ -H 'OK-访问-KEY: your-API-key' \ -H 'OK-访问-签名: your-签名ature' \ -H 'OK-访问-PASSPHRASE: your-passphrase' \ -H 'OK-访问-TIMESTAMP: 2023-10-18T12:21:41.274Z' \ -d '[ {"chAIn索引": "1", "令牌Contract添加ress": "0xc18360217d8f7ab5e7c516566761ea12ce7f9d72"}, {"chAIn索引": "1", "令牌Contract添加ress": ""} ]'
2.2 获取历史指数价格 (获取 Historical 索引 Price)
查询代币的历史价格。
请求
获取 https://网页3.okx.com/API/v6/dex/索引/historical-price
请求参数
参数 类型 必填 说明 chAIn索引 String 是 链标识 令牌Contract添加ress String 否 代币地址 limit String 否 返回数量 begin String 否 开始时间（Unix 毫秒） period String 否 周期，如 1m/5m/1H/1D 三、代币 API (令牌 API) 3.1 代币搜索 (令牌 搜索)
通过代币名称、符号或合约地址搜索代币。
请求
获取 https://网页3.okx.com/API/v6/dex/market/令牌/搜索
请求参数
参数 类型 必填 说明 chAIns String 是 链标识，多个用逗号分隔，如 1,10,56 搜索 String 是 搜索关键词（名称/符号/地址）
响应字段
chAIn索引: 链标识 令牌Name: 代币名称 令牌Symbol: 代币符号 令牌Contract添加ress: 合约地址 令牌记录oUrl: 代币图标 decimal: 精度 price: 当前价格 marketCap: 市值 liquidity: 流动性 holders: 持有人数 change: 24H 涨跌幅 tag列出.communityRecognized: 是否为社区认证代币
示例
curl -X 获取 'https://网页3.okx.com/API/v6/dex/market/令牌/搜索?chAIns=1,10&搜索=weth' \ -H 'OK-访问-KEY: your-API-key' \ -H 'OK-访问-签名: your-签名ature' \ -H 'OK-访问-PASSPHRASE: your-passphrase' \ -H 'OK-访问-TIMESTAMP: 2023-10-18T12:21:41.274Z'
3.2 代币基本信息 (令牌 Basic In格式化ion)
获取指定代币的基本信息。
请求
POST https://网页3.okx.com/API/v6/dex/market/令牌/basic-信息
请求体 (JSON 数组)
参数 类型 必填 说明 chAIn索引 String 是 链标识 令牌Contract添加ress String 是 代币合约地址
响应字段
chAIn索引: 链标识 令牌Name: 代币名称 令牌Symbol: 代币符号 令牌记录oUrl: 图标 URL decimal: 精度 tag列出.communityRecognized: 是否社区认证 3.3 代币交易信息 (令牌 Trading In格式化ion)
获取代币的详细交易信息，包括价格、交易量、市值、流动性等。
请求
POST https://网页3.okx.com/API/v6/dex/market/price-信息
请求体 (JSON 数组，最多 100 个)
参数 类型 必填 说明 chAIn索引 String 是 链标识 令牌Contract添加ress String 是 代币合约地址
响应字段
price: 最新价格 marketCap: 市值 priceChange5M/1H/4H/24H: 价格变化百分比 volume5M/1H/4H/24H: 交易量 txs5M/1H/4H/24H: 交易笔数 max