欧易 API · 下单报错
欧易现货单数量低于 minSz、不合 lotSz 被拒时怎么改 sz
网格脚本挂到一半,有几格没挂上,下单返回的 data 里 sCode 是 51121,sMsg 是 Order quantity must be a multiple of the lot size.;换成每格资金更少的小交易对,同一个位置又变成 51020 或 51120。三个码针对的都是 sz 这个数本身,签名、余额和限速这时都不用动。
现货和币币杠杆的数量要同时过两道关:不小于该交易对的 minSz,并且是 lotSz 的整数倍。两个值都能从公开接口 GET /api/v5/public/instruments 查到,不需要 API Key。下单前把 sz 向下取整到 lotSz 的倍数,取整后小于 minSz 的那一格不下(或者和相邻格合并),数量这一项就合规了。
报 51020、51120、51121 时该改 sz 的哪一处
下单接口的返回分两层:外层 code 是整个请求的结果码,data 里每一笔订单各带一个 sCode(0 表示成功)和 sMsg(拒绝或成功的信息)。单子为什么被拒,看的是 sCode 和 sMsg,拿到之后对下表:
| 来源:欧易 API v5 文档(Error Code 表与 Get instruments 字段说明),提示原文按 2026 年 11 月 10 日的页面摘录 | |||
|---|---|---|---|
| 返回码 | 提示原文 | 为什么被拒 | sz 怎么改 |
| 51020 | Your order should meet or exceed the minimum order amount. | 这笔单的数量没达到最小下单量 | 查这个交易对的 minSz,把 sz 提到 minSz 及以上;资金不够就少分几格 |
| 51120 | Order amount is less than {param0}, please try again. | 数量低于提示里 {param0} 位置的那个值 | 把 sMsg 整句记进日志,拿里面的数和你发出去的 sz 对比,再按 minSz 调高 |
| 51121 | Order quantity must be a multiple of the lot size. | sz 不是 lotSz 的整数倍,lotSz 的字段说明里写着违反这条返回 51121 | 按 lotSz 向下取整,小数位不要超过 lotSz 的位数 |
从提示的写法看,51120 里的 {param0} 是运行时填进去的下限值,所以排查时别只记一个错误码,把 sMsg 原样存下来更省事。帮助中心的错误排查问答也是这个思路:报错原因不清楚时,要提供完整的错误码、sCode/sMsg、发生时间,以及脱敏后的请求和响应。
minSz、lotSz、tickSz 在现货单上怎么读
这三个值都在 instruments 接口的返回里,类型是字符串。文档对它们的定义如下:
| 字段 | 含义 | 现货 / 币币杠杆 | 交割 / 永续等衍生品 |
|---|---|---|---|
| minSz | 最小下单数量;sz 要同时满足 sz ≥ minSz 且是 lotSz 的整数倍 | 交易货币数量 | 合约张数 |
| lotSz | 下单数量的最小增量,所有 sz 必须是它的整数倍 | 交易货币数量 | 合约张数 |
| tickSz | 价格的最小变动单位 | 按价格计,期权和事件合约另有分档接口 | |
在 BTC-USDT 上,交易货币是 BTC,所以拿来和 minSz、lotSz 比的是 BTC 的个数。网格脚本通常是先定每格投多少 USDT,再除以挂单价得到币数,这一步除出来的小数很难恰好落在 lotSz 的格子上,不取整直接发,就会撞上 51121。
市价买单要另外留意:tgtCcy 只适用于币币市价单,买单默认 quote_ccy,也就是 sz 填的是要花多少 USDT。sz 填币数还是填金额,换算和参数写法见欧易 API 市价单 sz 填币数还是 USDT。
帮助中心《欧易 API 常见问题》里也有一问解释 51121,答案是按合约讲的:合约订单以张为单位,要求是最小委托数量的整数倍。现货单按上表 lotSz 的定义处理就行;合约单的张数怎么算,见欧易 API 合约下单 sz 怎么填,posSide 报 51000 怎么改。
下单前用 Decimal 把 sz 向下取整到 lotSz 倍数
脚本启动时查一次规格并缓存;每次下单前用 Decimal 算数量并向下取整;取整后低于 minSz 的直接跳过。浮点数在这里不好用,0.1 这类小数在二进制下存不准,除完再取整容易差一位,所以全程用字符串构造 Decimal。
from decimal import Decimal, ROUND_DOWN
import requests
BASE = "https://www.okx.com"
def get_spec(inst_id):
r = requests.get(BASE + "/api/v5/public/instruments",
params={"instType": "SPOT", "instId": inst_id},
timeout=10).json()
if r.get("code") != "0" or not r.get("data"):
raise RuntimeError(r)
d = r["data"][0]
return Decimal(d["minSz"]), Decimal(d["lotSz"]), Decimal(d["tickSz"])
def fit_size(quote_amt, price, min_sz, lot_sz):
raw = Decimal(str(quote_amt)) / Decimal(str(price))
sz = (raw / lot_sz).to_integral_value(rounding=ROUND_DOWN) * lot_sz
return format(sz, "f") if sz >= min_sz else None
def fit_price(px, tick_sz):
p = (Decimal(str(px)) / tick_sz).to_integral_value(rounding=ROUND_DOWN) * tick_sz
return format(p, "f")
fit_size 返回 None 的那一格,脚本应该记一条日志然后跳过,不要原样重发。价格那一侧同理,挂单价按 tickSz 取整再发。账户在 EEA 或美国站点的,帮助中心给的 API 域名分别是 eea.okx.com 和 us.okx.com,把 BASE 换成对应域名。
代入一组数:假设 BTC-USDT 的 minSz 是 0.00001、lotSz 是 0.00000001(这两个是文档响应示例里 BTC-USDT 的值,实际以你调接口拿到的为准),挂单价假设是 75,000 USDT:
- 每格 5 USDT:5 ÷ 75,000 = 0.0000666666…,按 lotSz 向下取整得 0.00006666,大于 minSz,可以下。要是直接把 0.0000666666 发出去,小数位比 lotSz 多两位,对应的就是 51121。
- 每格 0.5 USDT:0.5 ÷ 75,000 = 0.0000066666…,取整后 0.00000666,小于 0.00001,这一格不下。
- 在这个价格上,一格至少要 0.00001 × 75,000 = 0.75 USDT 才够到 minSz。
用 ccxt 还是自己写请求都一样,最终发到交易所的那个 sz 要满足这两条。拿不准库替你做了什么处理,就把实际发出的请求体打印出来看一眼。
网格每格资金太小时先算最低投入
走官方网格策略接口的,不必自己一格格去凑。文档里有一个公开接口 POST /api/v5/tradingBot/grid/min-investment(Compute min investment),不需要鉴权,限速 20 次 / 2 秒(按 IP)。请求里填:
instId:交易对,比如 ETH-USDT;algoOrdType:grid是现货网格,contract_grid是合约网格;maxPx/minPx:区间上限和下限;gridNum:格数;runType:1 是等差,2 是等比;investmentData:打算投入的币种和数量(可选)。
返回的 minInvestmentData 是这组区间和格数下的最低投入,singleAmt 是单格交易数量:现货网格按计价货币计,合约网格按张计。手上的资金够不到这个最低值,调少 gridNum 再算一次,直到两边对得上。区间、格数怎么定,方法在欧易网格机器人怎么设置:区间、格数、每格资金怎么定;用接口创建、查询和停止网格的参数,见欧易 API 怎么创建网格策略:下单参数、查询运行状态与停止方式。
自己写网格的,可以把上面的 fit_size 放在建格子的循环里:先按格数算每格资金,任何一格返回 None,就说明格数分得太细,减格数重算,比开跑后一格格报错再补要干净。
把这套取整搬到合约单和常驻脚本上
欧易合约下单报 51121 怎么改?
合约的 minSz 和 lotSz 按张数计,sz 填的也是张数,同样要是 lotSz 的整数倍。先用 instruments 接口查出这个合约的 lotSz 和面值 ctVal,把按币数或 USDT 算出的数量换成张数,再向下取整到 lotSz 的倍数后下单。
交易对的 minSz 和 lotSz 会变吗?
会调整,instruments 返回里有 upcChg 字段,列出即将调整的参数(tickSz、minSz、maxMktSz)、新值和生效时间,没有调整时是空数组。WebSocket 的 instruments 频道在这几个交易参数变化时也会推送。长期运行的脚本不要把规格写死在代码里。
欧易下单的 sz 传字符串还是数字?
传字符串,文档里 sz 的类型是 String。Python 里用 Decimal 算完,用 format(sz, 'f') 转成字符串,别直接 str(),很小的数会被写成 6.66E-7 这样的科学计数法,发出去就不是你想要的格式了。
查交易对规格的接口需要 API Key 吗?
不需要 Key,GET /api/v5/public/instruments 属于公开数据接口,不用鉴权,限速是 20 次 / 2 秒,按 IP 加产品类型计。脚本启动时按交易对查一次、缓存起来就够了,不必每下一单都查一遍。
sz 改对之后如果换成了别的报错码,去欧易 API 常见报错与排查清单:照着这张表修里按码查;下单节奏太快被拒的,看欧易 API 限速是多少?下单频率怎么算、报 50061 怎么办。网格的区间和格数还没定的,可以先用欧易网格区间参考器:用最近 K 线算区间、格数和市场状态按最近一段日 K 估一遍,再回来算每格资金够不够 minSz。