欧易OKX模拟盘API完全指南:入门、实战与进阶

·

本指南将带你快速找到欧易模拟盘入口,深度拆解 API 各项功能,同时提供上手案例与常见问题解答,助你 零成本 打磨 程序化交易 策略。

目录

  1. 什么是欧易模拟盘
  2. 如何一键进入模拟盘
  3. 模拟盘核心功能全景
  4. API 接口速通
  5. 从 Hello World 到策略实盘
  6. 常见问题 FAQ

什么是欧易模拟盘

欧易模拟盘(官方命名「模拟交易」)是欧易 OKX 为交易者提供的 零风险 虚拟资金环境。你可以用它:

无论你是 现货永续合约 还是 期权 交易者,都能在模拟盘内获得与正式盘 1:1 深度 的实时行情。


如何一键进入模拟盘

操作路径只需 三步

  1. 打开官网并登录账户
    访问 👉 立即体验免手续费的欧易模拟交易 → 页面右上角 「资产」「模拟交易」
  2. 切换至 「模拟盘」
    你会看到 10,000 USDT 的初始虚拟资金,已经可用了。
  3. 创建 API Key
    在个人账户下拉菜单 「API 管理」 中,选择 「模拟盘」 标签,生成专属 API Key
小贴士:建议同时勾选「读取」「交易」权限,并限定 IP,以降低 潜在风险

模拟盘核心功能全景

维度现货永续合约期权
委托类型限价、市价、止盈止损限价、市价、条件单、跟踪止损限价
杠杆倍数最大 125×
资金费率每 8 小时一次模拟结算
数据延迟零延迟,与正式盘同步同左同左

此外,模拟盘保留了 深度图、K 线、持仓盈亏曲线 等关键信息,确保你在测试策略时能完整感受到 滑点流动性冲击


API 接口速通

官方文档虽全,但太多版本容易劝退。这里提炼最实用的 4 大高频调用

1. 获取实时行情

GET /api/v5/market/ticker

核心参数

2. 下单

POST /api/v5/trade/order

报文示例(限价买入 0.1 BTC)

{
  "instId": "BTC-USDT",
  "tdMode": "cash",
  "side": "buy",
  "ordType": "limit",
  "px": "27000",
  "sz": "0.1"
}

3. 查询持仓

GET /api/v5/account/positions

可一次返回 全部衍生品 仓位,方便循环风险管理。

4. 资产信息

GET /api/v5/account/balance

便于 净值回撤 统计或 回测基准 设定。

提示:模拟盘的 base URL 为 https://www.okx.com(与正式盘相同),区别在于须使用 模拟盘 API Key 并在请求头内增加 x-simulated-trading: 1

从 Hello World 到策略实盘

以下示例基于 Python,使用官方 lightweight SDK:

from okx_v5_api import Client

client = Client(
    api_key="YOUR_SIM_KEY",
    secret="YOUR_SECRET",
    passphrase="YOUR_PASSPHRASE",
    test=True  # 关键:开启模拟盘
)

# 1. 获取行情
ticker = client.market.get_ticker("BTC-USDT")
print(ticker['data']['last'])

# 2. 下限价单
order = client.trade.place_order("BTC-USDT", "buy", "limit", price=27000, size=0.01)
print(order)

下一步进阶思路


常见问题 FAQ

Q1:模拟盘实力和正式盘账户资金共享吗?
A:不共享。模拟盘资金为虚拟 USDT,可无限重置,与真实资金安全隔离。

Q2:API 有频率限制吗?
A:单 IP 每 2 秒 20 次,量化使用者建议用批量接口减少请求数。

Q3:模拟盘手续费如何计算?
A:与正式盘一致,现货 0.08 % – 0.1 %,合约 0.02 % – 0.05 %,但扣的是虚拟资金。

Q4:能否同时运行多个策略?
A:可以。不同 API Key 井水不犯河水,注意独立日志,防止 信号冲突

Q5:模拟盘的成交逻辑跟正式盘有没有差异?
A:撮合算法相同,但 深度时间切片 为毫秒级;真实盘存在 网络延迟 可能使滑点略高。

Q6:模拟盘的行情会不会偶尔假数据?
A:不会,行情数据与正式盘共享同一源,可放心用作 回测基准


写在最后

欧易 OKX 模拟盘把 行情、深度、API 全部搬到了 零风险 的沙箱环境:

立即点击 👉 30 秒开通欧易模拟盘,零成本验证你的量化灵感,把 交易梦想 先跑起来吧!