通用枚举定义
本页列出股票交易模块所有接口使用的枚举值。
全局约定: 所有枚举字符串值在请求与响应中一律 UPPERCASE。
side
用于 /order/place 请求、/order/history 过滤参数,以及每条订单 / 成交响应记录。
| 值 | 说明 |
|---|---|
BUY | 买入 |
SELL | 卖出 |
orderType
用于 /order/place 请求、/order/history 过滤参数,以及每条订单 / 成交响应记录。
| 值 | 说明 |
|---|---|
MARKET | 市价单 |
LIMIT | 限价单 |
timeInForce
用于 /order/place 请求;可选,默认 DAY。
| 值 | 说明 |
|---|---|
DAY | 当日有效(默认),收盘时自动失效 |
GTC | 一直有效直至撤销。仅支持 LIMIT 订单;分数股 GTC 必须同时设置 tradingSession = EXTENDED 或 24H |
tradingSession / session
请求端在 /order/place 里叫 tradingSession,响应端在订单 / 成交记录里叫 session。LIMIT
必填;MARKET 禁传。
| 值 | 说明 |
|---|---|
RTH | 常规交易时段(09:30–16:00 ET) |
EXTENDED | 盘前 + RTH + 盘后(04:00–20:00 ET) |
24H | 夜盘 + 盘前 + RTH + 盘后(20:00 → 次日 20:00 ET) |
walletType
用于 /order/place 请求(仅 BUY 方向);可选,默认 CARD。SELL 方向始终使用 CARD,忽略传入值。
| 值 | 说明 |
|---|---|
CARD | 资金钱包(默认) |
MAIN | 现货钱包 |
orderStatus(过滤器)
用于 /order/history
的逗号分隔多值过滤参数。仅接受以下终态值;进行中状态(NEW、ACCEPTED)不是有效过滤输入。
| 值 | 说明 |
|---|---|
FILLED | 全部成交 |
PARTIALLY_FILLED | 部分成交 |
CANCELED | 已撤销 |
EXPIRED | 已过期 |
REJECTED | 已拒绝 |
status(订单 / 成交响应)
每条订单 / 成交记录的生命周期状态,涵盖进行中与终态。
| 值 | 说明 |
|---|---|
NEW | 本地已接受,待上游确认 |
ACCEPTED | 上游券商已接受 |
PARTIALLY_FILLED | 部分成交 |
FILLED | 全部成交 |
CANCELED | 已撤销 |
EXPIRED | 已过期(DAY 订单收盘自动撤销等场景) |
REJECTED | 已拒绝 |
注意: 下单响应(
/order/place)和撤单响应(/order/cancel)中的status字段是独立的请求确认码,不是订单生命周期状态,仅携带S(已接受)或F(失败)。
tradability(交易规则)
由 /market/exchangeInfo → symbols[].tradability 返回,表示当前 symbol 允许的交易方向。
| 值 | 说明 |
|---|---|
BUY_SELL | 买卖双向均允许 |
BUY | 仅允许买入(仅可建新多仓) |
SELL | 仅允许卖出(仅可平仓) |
NONE | 禁止交易(已停牌 / 已暂停) |
convertType(代币化)
用于 /tokenized/convert-status 请求,以及 /tokenized/history 和 /tokenized/convert-status
响应中返回。
| 值 | 说明 |
|---|---|
MINT | 从标的股票铸造代币化资产 |
REDEEM | 将代币化资产赎回为标的股票 |
status(代币化转换响应)
由 /tokenized/mint、/tokenized/redeem、/tokenized/convert-status 以及 /tokenized/history
每行返回。此状态码独立于订单生命周期 status——铸造 / 赎回是异步流程,有自己的三态机。
| 值 | 说明 |
|---|---|
P | 处理中(异步进行) |
S | 成功 |
F | 失败 |