python okx 持仓查询
发表于 2026年7月24日 · 阅读 12,394

Python 在加密货币领域的应用非常广泛,特别是对于数字资产交易平台而言。OKX 作为全球知名的数字资产交易平台之一,提供各种服务如币币交易、杠杆、期权合约等,用户自然希望可以方便地查询自己的持仓情况。本文将介绍如何使用 Python 进行 OKX 的持仓查询,实现这一功能可以帮助用户自动化跟踪账户状态和投资组合的变化。


首先,需要确保你有 OKX API 的访问权限。为了获取 API 密钥,你需要登录到 OKX 账户并进入“API 管理”页面。在这里,你可以创建一个新的 API 密钥,这将是后端程序进行交易查询的凭证。


接下来,我们使用 Python 的 requests 库来与 OKX API 交互。以下是一个简单的 Python 脚本来演示如何获取你的持仓信息:


python


import requests


import json


替换为你的 API Key 和 Secret


api_key = 'your_api_key'


secret = 'your_secret'


请求的 URL,这个 URL 是 OKX 的 API 接口地址


url = 'https://www.okx.com/api/v5'


发送请求的时间戳


timestamp = int(round(time() * 1000))


生成签名(Signature),使用 HS256 和 Secret Key


sign = hmac_sha256(secret, str(timestamp).encode())


构建请求的参数


params = {


'api-key': api_key,


'version': 'v5',


'app-id': 0, # app-id 为 0 意味着客户端,其他值可以用于区分不同的应用场景


'sign': sign,


'timestamp': timestamp,


}


发送请求


response = requests.get(url, params=params)


解析响应内容


data = json.loads(response.text)


打印持仓信息,这里只展示部分字段


print('Account Info:')


for asset in data['result']['acctInfo']['assets']:


symbol = asset['info']['symbol']


positionAmt = float(asset['posAmt'])


avgPrice = float(asset['avgPrice'])


locked = bool(asset['locked']) # 是否被冻结


print(f'Symbol: {symbol}, Position Amount: {positionAmt}, Average Price: {avgPrice}, Locked: {locked}')



在上面的代码中,我们首先替换了 API Key 和 Secret,然后生成了一个签名(signature)并构建了请求参数。通过 `requests.get()` 方法向 OKX 的 API 发送请求,并将响应解析为 JSON 格式。最后,我们遍历返回的账户信息中的资产列表,打印出每个资产的符号、持仓数量和平均买入价格。


请注意,这个脚本假设你的 API 密钥和 Secret 在代码中正确设置。在实际操作中,这些敏感信息应该通过环境变量或者其他安全的方式进行管理,而不是直接在源代码中暴露。


通过运行上述 Python 脚本来获取持仓信息,用户可以实现实时监控自己的投资情况,包括但不限于资产价值变动、盈利或亏损计算等。这对于跟踪投资表现和做出决策非常有用。同时,这个脚本也可以作为更复杂自动化交易策略的基础,帮助用户更有效地管理其加密货币仓位。


最后,需要注意的是,根据 OKX 的 API 政策,频繁调用 API 可能会受到限制。因此,在设计和使用此类自动化工具时,应该考虑到合规性和对平台规则的尊重。

作者简介:本文作者为财经观察专栏撰稿人,长期关注宏观经济、区块链及资本市场动态,致力于提供深度解读与前沿观点。