所有值均为小写字符串，除非另有说明。后端会拒绝大写变体——例如 tif=GTC 将返回 400 invalid tif。
订单方向 (side)
| 值 | 含义 |
|---|
buy | 买入基础资产，支付报价资产。 |
sell | 卖出基础资产，收取报价资产。 |
订单类型 (type)
| 值 | 含义 |
|---|
limit | 以指定 price 挂单。需同时提供 price 和 quantity。 |
market | 立即成交的市价单。买入时使用 quote_quantity（花费的 USDT 金额）；卖出时使用 quantity（出售的 DF 数量）。 |
有效期类型 (tif)
| 值 | 含义 |
|---|
gtc | Good-Til-Canceled（撤销前有效）。未成交部分持续挂单，直至被撤销或完全成交。（limit 订单的默认值。） |
ioc | Immediate-Or-Cancel（立即成交或撤销）。立即撮合当前可成交部分，剩余部分撤销。若有剩余数量未成交，状态变为 canceled；filled_qty > 0 表示发生了部分成交。（market 订单的默认值。） |
post_only | 仅限限价单。若订单在下单时将立即撮合，则以 POST_ONLY_REJECT 拒绝，不产生任何成交；否则行为与 gtc 相同。 |
订单状态 (status)
| 值 | 是否终态 | 含义 |
|---|
open | 否 | 挂单中，尚无成交。 |
partially_filled | 否 | 挂单中，filled_qty > 0，已有部分成交。 |
filled | 是 | 已完全成交。 |
canceled | 是 | 已由用户撤销、IOC 剩余撤销、市价单剩余撤销，或因市场 delisted 而撤销。 |
rejected | 是 | 在撮合引擎接受前校验失败（例如 SELF_TRADE、POST_ONLY_REJECT）。 |
expired | 是 | 保留字段；MVP 阶段现货不使用。 |
提币状态 (status)
| 值 | 含义 |
|---|
signed | 后端已签署 EIP-712 释放消息；用户尚未在链上提交。资金已被冻结。 |
confirmed | 链上 SpotWithdrawal 事件已被观察到。资金已离开金库。 |
expired | 签名在使用前已超过 deadline。资金已退还至 available。 |
市场状态 (status)
| 值 | 效果 |
|---|
listed | 交易已开放。接受新订单。 |
halted | 新订单以 409 MARKET_HALTED 拒绝。已有挂单继续保留在订单簿上。 |
delisted | 终态。已有订单被清空（撤销并退款），新订单以 410 MARKET_DELISTED 拒绝。 |
成交角色 (role，出现于 GET /spot/trades/me)
| 值 | 含义 |
|---|
maker | maker（做市方）：调用方的订单挂在订单簿上被对方命中。 |
taker | taker（吃单方）：调用方的订单主动发起撮合。 |
K 线周期 (interval)
| 值 | 时间窗口 |
|---|
1m | 1 分钟 |
5m | 5 分钟 |
15m | 15 分钟 |
1h | 1 小时 |
4h | 4 小时 |
1d | 1 天 |
WebSocket 频道前缀
| 前缀 | 是否需要鉴权 | 格式 |
|---|
spot:depth: | — | spot:depth:{symbol} |
spot:trade: | — | spot:trade:{symbol} |
spot:ticker: | — | spot:ticker:{symbol} |
spot:kline: | — | spot:kline:{symbol}:{interval} |
spot:user:orders | 必须 | 固定频道名（不含 symbol，服务端按用户过滤） |
spot:user:balances | 必须 | 固定频道名（服务端按用户过滤） |
代币（MVP）
| 符号 | 精度 | 网络 |
|---|
DF | 18 | BSC 测试网 |
USDT | 6 | Arbitrum Sepolia（永续合约抵押品侧） |