下单

POST/api/v1/ordersBearer

Trading API价 E4 · 量 E2 · 金额 E6（整数）YES | NO

202 = 命令已持久 ≠ 已成交。响应体没有撮合结果，拿 cursor 去 GET /markets/{marketId}/orders/{orderId}?minCursor=… 轮询。

clientOrderId（可选）是幂等键：传入后重试同一笔不会再产生第二条命令（按 (trader, clientOrderId) 去重，回放返回首次的原始响应）；不传则重试可能重复下单，风险原样保留。clientOrderId 与响应里的 orderId 是两个值域，不能混用——orderId 永远由服务端生成。

带 auth（链上订单签名）时做字节级一致性校验，失败 400 且 命令未落日志、资金未冻结，修好装配再发，重试无意义。503 的 error ∈ command_log_unavailable / seq_unavailable / duplicate_in_flight（均可恢复重试）。

`tif: FOK` 与 `auth` 不能同时用。 链下引擎完整支持 FOK（全量成交否则整单拒绝），但链上结算合约把 FOK 的 order_type 当作保留值直接 abort（unsupported_order_type）。链下这一层不会替你拦：签名 FOK 单会被正常受理、返回 202、冻结资金，最后卡在结算。签名单请用 GTC 或 GTD。

请求头 Authorization: Bearer <token>。token 由 POST /api/v1/auth/verify 签发，24h 空闲或签发满 7d 后失效。

请求体

marketIdstring必填
引擎市场 id
示例"mkt-0001"
clientOrderIdstring可选
调用方自选幂等键；不传则重试可能重复下单
示例"mm-btc-2026-09-19-0001"
outcomeYES | NO必填
结算方向
示例"YES"
sideBUY | SELL必填
买卖方向
示例"BUY"
priceE4integer必填
1e-4 USD；须为市场 tickE4 整数倍
范围1 – 9999示例5200
sizeE2int64必填
1e-2 份
范围≥ 1示例1000
tifGTC | GTD | FAK | FOK可选
不传等同 GTC。GTD 必须同时给 expiration。FAK 立即成交可成交部分、剩余撤销；FOK 全量成交否则整单拒绝（拒绝理由 FOK 无法全量成交）。`FOK` 只在不带 `auth` 的链下单上可用——带链上签名时它在结算阶段必定失败，见本接口说明
默认"GTC"示例"GTC"
expirationint64可选
Unix 秒；GTD 必填，带 auth 的签名单必填
示例1758243600
postOnlyboolean可选
true = 只挂不吃；若会立即成交则整单拒绝。不传等同 false
默认false示例false
authobject可选
链上订单签名载荷（不传则走无签名路径，链上模式市场会拒）
orderBytesstring必填
OrderV1 字节（hex;market_id 必须是链上 Market 对象 id）
signaturestring必填
订单签名（hex）
accountEpochinteger可选
前端直接读链获得（TradingAccount.order_epoch），后端不代理
示例0

响应

202命令已持久化（未撮合）

orderIdstring
服务端生成的订单 id，用于后续查询与撤单
示例"ord_01K5H2M3N7Q8R9S0"
clientOrderIdstring可为空
请求传入的幂等键原样回显；未传为 null
示例"mm-btc-2026-09-19-0001"
cursorstring
读己之写续读点，原样传给状态查询的 minCursor
示例"c1:mkt-0001:184"
commandIdstring
命令标识
示例"cmd_01K5H2M3N7Q8R9S1"

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X POST "$BASE_URL/api/v1/orders" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "marketId": "mkt-0001",
    "outcome": "YES",
    "side": "BUY",
    "priceE4": 5200,
    "sizeE2": 1000,
    "tif": "GTC",
    "postOnly": false
  }'

响应

命令已持久化（未撮合）

{
  "orderId": "ord_01K5H2M3N7Q8R9S0",
  "clientOrderId": "mm-btc-2026-09-19-0001",
  "cursor": "c1:mkt-0001:184",
  "commandId": "cmd_01K5H2M3N7Q8R9S1"
}

下单

POST/api/v1/ordersBearer

Trading API价 E4 · 量 E2 · 金额 E6（整数）YES | NO

202 = 命令已持久 ≠ 已成交。响应体没有撮合结果，拿 cursor 去 GET /markets/{marketId}/orders/{orderId}?minCursor=… 轮询。

请求头 Authorization: Bearer <token>。token 由 POST /api/v1/auth/verify 签发，24h 空闲或签发满 7d 后失效。

请求体

marketIdstring必填

引擎市场 id

示例"mkt-0001"

clientOrderIdstring可选

调用方自选幂等键；不传则重试可能重复下单

示例"mm-btc-2026-09-19-0001"

outcomeYES | NO必填

结算方向

示例"YES"

sideBUY | SELL必填

买卖方向

示例"BUY"

priceE4integer必填

1e-4 USD；须为市场 tickE4 整数倍

范围1 – 9999示例5200

sizeE2int64必填

1e-2 份

范围≥ 1示例1000

tifGTC | GTD | FAK | FOK可选

不传等同 GTC。GTD 必须同时给 expiration。FAK 立即成交可成交部分、剩余撤销；FOK 全量成交否则整单拒绝（拒绝理由 FOK 无法全量成交）。`FOK` 只在不带 `auth` 的链下单上可用——带链上签名时它在结算阶段必定失败，见本接口说明

默认"GTC"示例"GTC"

expirationint64可选

Unix 秒；GTD 必填，带 auth 的签名单必填

示例1758243600

postOnlyboolean可选

true = 只挂不吃；若会立即成交则整单拒绝。不传等同 false

默认false示例false

authobject可选

链上订单签名载荷（不传则走无签名路径，链上模式市场会拒）

orderBytesstring必填

OrderV1 字节（hex;market_id 必须是链上 Market 对象 id）

signaturestring必填

订单签名（hex）

accountEpochinteger可选

前端直接读链获得（TradingAccount.order_epoch），后端不代理

示例0