Place Order (委托下单)

POST

/v1/whaleapi/trade/order

Trade

该接口用于为指定证券账号提交股票买卖订单。通过传入证券账号 account_no、股票代码 symbol、市场 market、买卖方向 side（buy：买入 / sell：卖出）、订单类型 order_type、订单数量 quantity、价格 price 及有效期类型 time_in_force 等参数，完成订单的创建并返回订单编号 order_id。支持限价单、市价单等多种订单类型，同时支持盘前盘后交易标识及备注信息。

This interface is used to submit a stock buy or sell order for a specified securities account. By providing the account number account_no, stock symbol symbol, market market, trade direction side (buy / sell), order type order_type, quantity quantity, price price, and time-in-force time_in_force, it creates an order and returns the order ID order_id. It supports multiple order types including limit orders and market orders, as well as pre/post-market trading flags and remarks.

Request

Authorization

Body Params application/json

symbol

string

required

Stock Symbol, in ticker.region format (股票代码，使用 ticker.region 格式)

Example:

AAPL.US

side

enum<string>

required

Side (买卖方向)

Allowed values:

BuySell

Example:

Sell

order_type

enum<string>

required

Order Type (订单类型)

Allowed values:

LOMOLITMITTSLPAMTTSLPPCT

Example:

submitted_price

string

optional

Submitted Price (下单价格，LO / ELO / ALO / ODD / LIT 订单必填)

Example:

88.5

submitted_quantity

string

required

Submitted Quantity (下单数量)

Example:

100

time_in_force

enum<string>

required

Time in Force (订单有效期类型)

Allowed values:

DayGTCGTD

Example:

Day

expire_date

string

optional

Long-term Order Expiration Time (长期单过期时间，格式为 YYYY-MM-DD，time_in_force 为 GTD 时必填)

Example:

2022-12-05

outside_rth

enum<string>

optional

Outside Regular Trading Hour (是否允许盘前盘后，美股必填)

Allowed values:

RTH_ONLYANY_TIMEOVERNIGHT

trigger_price

string

optional

Trigger Price (触发价格，LIT / MIT 订单必填)

Example:

388.5

trailing_amount

string

optional

Trailing Amount (跟踪金额，TSLPAMT 订单必填)

trailing_percent

string

optional

Trailing Percent (跟踪涨跌幅，单位为百分比，例如 "2.5" 表示 "2.5%"，TSLPPCT 订单必填)

limit_offset

string

optional

Order Target Price Spread (指定价差)

remark

string

optional

Remark (备注)

<= 64 characters

account_no

string

required

Account Number（证券账号）

Example:

L6VQEU00121996

limit_depth_level

number

required

Specifies the bid/ask depth level（指定买卖档位，取值范围为 -5 ～ 0 ～ 5，负数代表买盘档位（如 -1 表示买一），正数代表卖盘档位（如 1 表示卖一），为 0 时 limit_offset 参数生效 TSLPAMT / TSLPPCT 订单有效）

monitor_price

string

required

Monitoring price（监控价格，需要达到该价格才会开始监控，更新参考价TSLPAMT / TSLPPCT 订单有效）

trigger_count

number

required

Number of triggers（触发次数，取值范围 0 ~ 3, 表示在 1 分钟内触发多次才会触发订单 LIT / MIT / TSLPAMT / TSLPPCT 订单有效）

Example

{
  "symbol": "AAPL.US",
  "side": "Buy",
  "order_type": "LO",
  "submitted_price": "88.5",
  "submitted_quantity": "100",
  "time_in_force": "Day",
  "expire_date": "2022-12-05",
  "outside_rth": "RTH_ONLY",
  "trigger_price": "388.5",
  "trailing_amount": "string",
  "trailing_percent": "string",
  "limit_offset": "string",
  "remark": "string",
  "account_no": "L6VQEU00121996",
  "limit_depth_level": 0,
  "monitor_price": "string",
  "trigger_count": 0
}

Responses

🟢200OK

*/*

success

Body

code

integer <int32>

required

Error Code (错误码)

message

string

required

Reponse Data (请求信息)

data

object

required

order_id

string

required

Order ID (订单 id)

Example

{
  "code": 0,
  "message": "string",
  "data": {
    "order_id": "string"
  }
}

🟠400Bad Request

Modified at 2026-06-02 07:37:04

Historical Order Inquiry (历史订单查询)

Modify Order (修改订单)