okx-market-api

OKX Web3 Wallet Market API 技能 - 用于查询加密货币代币价格、市场数据和交易信息。当用户需要以下功能时使用此技能： - 查询代币实时价格、K线数据、交易记录 - 获取综合币价（聚合多数据源的指数价格） - 搜索代币、获取代币详情、查看代币排行榜 - 获取持仓大户信息触发词包括：代币价格、币价、K线、candlestick、行情、market data、OKX API、DEX 数据、链上数据、token price、index price、token search、holder 等。支持 Solana、EVM、Sui 等多链生态，覆盖 100+ DEX 和 CEX 数据源。

跳到安装

仓库: johnalbertini14-glitch/openclaw-skills
最近来源活动: 2026年2月21日 15:09
检测到的 SKILL.md 语言: 中文
星标: 1
分支: 0

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/johnalbertini14-glitch/openclaw-skills --skill okx-market-api

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

文件资源管理器

9 个文件

SKILL.md

来源说明 · 只读预览

返回搜索返回安装

name

okx-market-api

description

OKX Web3 Wallet Market API

本技能用于调用 OKX Web3 Wallet 的 Market API，获取加密货币代币的价格、交易、K线等市场数据。

API 基础信息

Base URL: https://web3.okx.com
认证方式: 需要在 Header 中传入以下字段：
- OK-ACCESS-KEY: API Key
- OK-ACCESS-SIGN: 签名（HMAC SHA256）
- OK-ACCESS-PASSPHRASE: API 密码短语
- OK-ACCESS-TIMESTAMP: 请求时间戳（ISO 8601 格式）
- Content-Type: application/json（POST 请求）

签名生成方法

import hmac
import hashlib
import base64
from datetime import datetime

def generate_signature(timestamp, method, request_path, body, secret_key):
    """
    生成 OKX API 签名
    timestamp: ISO 8601 格式时间戳，如 '2023-10-18T12:21:41.274Z'
    method: HTTP 方法 (GET/POST)
    request_path: 请求路径，如 '/api/v6/dex/market/candles'
    body: 请求体（POST 时为 JSON 字符串，GET 时为空字符串）
    secret_key: API Secret
    """
    message = timestamp + method.upper() + request_path + body
    mac = hmac.new(
        secret_key.encode('utf-8'),
        message.encode('utf-8'),
        hashlib.sha256
    )
    return base64.b64encode(mac.digest()).decode('utf-8')

常用链标识 (chainIndex)

chainIndex	区块链
0	Bitcoin
1	Ethereum
10	Optimism
56	BSC (BNB Chain)
66	OKX Chain
137	Polygon
324	zkSync Era
501	Solana
42161	Arbitrum One
43114	Avalanche C-Chain

一、行情价格 API (Market Price API)

1.1 获取 K 线数据 (Get Candlesticks)

获取代币的 K 线图数据，最多返回 1,440 条记录。

请求

GET https://web3.okx.com/api/v6/dex/market/candles

请求参数

参数	类型	必填	说明
chainIndex	String	是	链标识，如 `1` 表示 Ethereum
tokenContractAddress	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 GET 'https://web3.okx.com/api/v6/dex/market/candles?chainIndex=66&tokenContractAddress=0x382bb369d343125bfb2117af9c149795c6c65c50' \
  -H 'OK-ACCESS-KEY: your-api-key' \
  -H 'OK-ACCESS-SIGN: your-signature' \
  -H 'OK-ACCESS-PASSPHRASE: your-passphrase' \
  -H 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'

1.2 获取历史 K 线 (Get Candlesticks History)

获取历史 K 线数据（不包含未完成的 K 线）。

请求

GET https://web3.okx.com/api/v6/dex/market/historical-candles

参数与 1.1 相同。

1.3 获取最近交易 (Get Trades)

获取代币的最近交易记录。

请求

GET https://web3.okx.com/api/v6/dex/market/trades

请求参数

参数	类型	必填	说明
chainIndex	String	是	链标识
tokenContractAddress	String	是	代币合约地址

响应字段

id: 交易 ID
txHashUrl: 交易哈希链接
userAddress: 用户地址
dexName: DEX 名称
type: 交易类型 (buy/sell)
changedTokenInfo: 交易代币信息数组

二、综合币价 API (Index Price API)

综合币价是通过聚合多个第三方数据源（CEX/DEX/Oracle）计算得出的指数价格。

2.1 获取代币指数价格 (Get Token Index Price)

批量查询代币指数价格，每次最多 100 个。

请求

POST https://web3.okx.com/api/v6/dex/index/current-price

请求体 (JSON 数组)

参数	类型	必填	说明
chainIndex	String	是	链标识
tokenContractAddress	String	是	代币地址。传空字符串 `""` 查询原生代币

响应字段

price: 代币价格
time: 价格时间戳（Unix 毫秒）
chainIndex: 链标识
tokenContractAddress: 代币地址

示例

curl -X POST 'https://web3.okx.com/api/v6/dex/index/current-price' \
  -H 'Content-Type: application/json' \
  -H 'OK-ACCESS-KEY: your-api-key' \
  -H 'OK-ACCESS-SIGN: your-signature' \
  -H 'OK-ACCESS-PASSPHRASE: your-passphrase' \
  -H 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \
  -d '[
    {"chainIndex": "1", "tokenContractAddress": "0xc18360217d8f7ab5e7c516566761ea12ce7f9d72"},
    {"chainIndex": "1", "tokenContractAddress": ""}
  ]'

2.2 获取历史指数价格 (Get Historical Index Price)

查询代币的历史价格。

请求

GET https://web3.okx.com/api/v6/dex/index/historical-price

请求参数

参数	类型	必填	说明
chainIndex	String	是	链标识
tokenContractAddress	String	否	代币地址
limit	String	否	返回数量
begin	String	否	开始时间（Unix 毫秒）
period	String	否	周期，如 `1m/5m/1H/1D`

三、代币 API (Token API)

3.1 代币搜索 (Token Search)

通过代币名称、符号或合约地址搜索代币。

请求

GET https://web3.okx.com/api/v6/dex/market/token/search

请求参数

参数	类型	必填	说明
chains	String	是	链标识，多个用逗号分隔，如 `1,10,56`
search	String	是	搜索关键词（名称/符号/地址）

响应字段

chainIndex: 链标识
tokenName: 代币名称
tokenSymbol: 代币符号
tokenContractAddress: 合约地址
tokenLogoUrl: 代币图标
decimal: 精度
price: 当前价格
marketCap: 市值
liquidity: 流动性
holders: 持有人数
change: 24H 涨跌幅
tagList.communityRecognized: 是否为社区认证代币

示例

curl -X GET 'https://web3.okx.com/api/v6/dex/market/token/search?chains=1,10&search=weth' \
  -H 'OK-ACCESS-KEY: your-api-key' \
  -H 'OK-ACCESS-SIGN: your-signature' \
  -H 'OK-ACCESS-PASSPHRASE: your-passphrase' \
  -H 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'

3.2 代币基本信息 (Token Basic Information)

获取指定代币的基本信息。

请求

POST https://web3.okx.com/api/v6/dex/market/token/basic-info

请求体 (JSON 数组)

参数	类型	必填	说明
chainIndex	String	是	链标识
tokenContractAddress	String	是	代币合约地址

响应字段

chainIndex: 链标识
tokenName: 代币名称
tokenSymbol: 代币符号
tokenLogoUrl: 图标 URL
decimal: 精度
tagList.communityRecognized: 是否社区认证

3.3 代币交易信息 (Token Trading Information)

获取代币的详细交易信息，包括价格、交易量、市值、流动性等。

请求

POST https://web3.okx.com/api/v6/dex/market/price-info

请求体 (JSON 数组，最多 100 个)

参数	类型	必填	说明
chainIndex	String	是	链标识
tokenContractAddress	String	是	代币合约地址

响应字段

price: 最新价格
marketCap: 市值
priceChange5M/1H/4H/24H: 价格变化百分比
volume5M/1H/4H/24H: 交易量
txs5M/1H/4H/24H: 交易笔数
maxPrice/minPrice: 24H 最高/最低价
circSupply: 流通供应量
liquidity: 流动性
holders: 持有人数
tradeNum: 24H 交易数量

示例

curl -X POST 'https://web3.okx.com/api/v6/dex/market/price-info' \
  -H 'Content-Type: application/json' \
  -H 'OK-ACCESS-KEY: your-api-key' \
  -H 'OK-ACCESS-SIGN: your-signature' \
  -H 'OK-ACCESS-PASSPHRASE: your-passphrase' \
  -H 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z' \
  -d '[
    {"chainIndex": "501", "tokenContractAddress": "5mbK36SZ7J19An8jFochhQS4of8g6BwUjbeCSxBSoWdp"}
  ]'

3.4 代币排行榜 (Token Ranking List)

获取代币排行榜列表。

请求

GET https://web3.okx.com/api/v6/dex/market/token/ranking

3.5 持仓大户 (Top Token Holder)

获取代币的持仓大户信息。

请求

GET https://web3.okx.com/api/v6/dex/market/token/holder

四、Websocket API

Websocket 服务仅对白名单用户开放。如需使用，请联系 dexapi@okx.com。

连接地址: 请参考官方文档

可用频道:

Price Channel: 实时价格数据
Candlesticks Channel: 实时 K 线数据
Trades Channel: 实时交易数据
Liquidity Channel: 流动性数据

五、错误码

错误码	说明
0	成功
50000	系统错误
50001	参数错误
50002	签名错误
50003	请求频率超限

六、Python 示例代码

import requests
import hmac
import hashlib
import base64
from datetime import datetime, timezone
import json

class OKXMarketAPI:
    def __init__(self, api_key, secret_key, passphrase):
        self.base_url = "https://web3.okx.com"
        self.api_key = api_key
        self.secret_key = secret_key
        self.passphrase = passphrase
    
    def _get_timestamp(self):
        return datetime.now(timezone.utc).strftime('%Y-%m-%dT%H:%M:%S.%f')[:-3] + 'Z'
    
    def _sign(self, timestamp, method, request_path, body=''):
        message = timestamp + method + request_path + body
        mac = hmac.new(
            self.secret_key.encode('utf-8'),
            message.encode('utf-8'),
            hashlib.sha256
        )
        return base64.b64encode(mac.digest()).decode('utf-8')
    
    def _headers(self, method, request_path, body=''):
        timestamp = self._get_timestamp()
        return {
            'OK-ACCESS-KEY': self.api_key,
            'OK-ACCESS-SIGN': self._sign(timestamp, method, request_path, body),
            : .passphrase,
            : timestamp,
            : 
        }
    
     ():
        
        path = 
        headers = ._headers(, path)
        response = requests.get(.base_url + path, headers=headers)
         response.json()
    
     ():
        
        path = 
        body = json.dumps(tokens)
        headers = ._headers(, path, body)
        response = requests.post(.base_url + path, headers=headers, data=body)
         response.json()
    
     ():
        
        path = 
        headers = ._headers(, path)
        response = requests.get(.base_url + path, headers=headers)
         response.json()
    
     ():
        
        path = 
        body = json.dumps(tokens)
        headers = ._headers(, path, body)
        response = requests.post(.base_url + path, headers=headers, data=body)
         response.json()



 __name__ == :
    api = OKXMarketAPI(
        api_key=,
        secret_key=,
        passphrase=
    )
    
    
    result = api.search_token(, )
    (json.dumps(result, indent=))
    
    
    result = api.get_index_price([
        {: , : }
    ])
    (json.dumps(result, indent=))

okx-market-api

来源信息

安装方式

检查来源文件

同仓库更多 Skills

同仓库更多 Skills

OKX Web3 Wallet Market API

API 基础信息

签名生成方法

常用链标识 (chainIndex)

一、行情价格 API (Market Price API)

1.1 获取 K 线数据 (Get Candlesticks)

1.2 获取历史 K 线 (Get Candlesticks History)

1.3 获取最近交易 (Get Trades)

二、综合币价 API (Index Price API)

2.1 获取代币指数价格 (Get Token Index Price)

2.2 获取历史指数价格 (Get Historical Index Price)

三、代币 API (Token API)

3.1 代币搜索 (Token Search)

3.2 代币基本信息 (Token Basic Information)

3.3 代币交易信息 (Token Trading Information)

3.4 代币排行榜 (Token Ranking List)

3.5 持仓大户 (Top Token Holder)

四、Websocket API

五、错误码

六、Python 示例代码

七、相关文档链接

OKX Web3 Wallet Market API

API 基础信息

签名生成方法

常用链标识 (chainIndex)

一、行情价格 API (Market Price API)

1.1 获取 K 线数据 (Get Candlesticks)

1.2 获取历史 K 线 (Get Candlesticks History)

1.3 获取最近交易 (Get Trades)

二、综合币价 API (Index Price API)

2.1 获取代币指数价格 (Get Token Index Price)

2.2 获取历史指数价格 (Get Historical Index Price)

三、代币 API (Token API)

3.1 代币搜索 (Token Search)

3.2 代币基本信息 (Token Basic Information)

3.3 代币交易信息 (Token Trading Information)

3.4 代币排行榜 (Token Ranking List)

3.5 持仓大户 (Top Token Holder)

四、Websocket API

五、错误码

六、Python 示例代码

七、相关文档链接