WhaleAPI(Public)
  1. Trade
WhaleAPI(Public)
  • Account Trade Auth
    • Trade Password Auth(交易密码校验)
      POST
    • Trade Password Set(交易密码设置)
      POST
    • Trade Password Reset(交易密码修改/重置)
      POST
    • Account No. Login Password Auth 证券帐号登录密码校验
      POST
  • Accounts
    • Get Account Request List(获取用户开户申请列表)
      GET
    • Retrieve Account Application Information(获取证券账户开户资料信息)
      GET
    • Get Account Contact Info(获取账户联系方式)
      GET
    • Get Account List(获取用户账户列表)
      GET
    • Get Account Status(获取账户状态)
      POST
    • Get Account Bcan Information(获取账户 Bcan 信息)
      GET
    • Query Account List V2(获取账户列表V2)
      GET
    • Update Application(修改开户资料)
      POST
    • Submit Application(提交开户申请资料)
      POST
    • Update Account State/Disable Account
      POST
    • Submit Application V2(提交开户申请资料)
      POST
    • Update Application V2(修改开户资料)
      POST
    • Close Account(注销账户)
      POST
    • Open additional account(增开账户)
      POST
    • get account opening application information (开户申请信息获取)
      POST
    • Query Account Risk And Pi Info(获取用户风险测评以及Pi信息)
      GET
  • Asset
    • Temporary Adjustment(临时调账)
    • Account Cash Balance Unfreeze Debit(账户资金解冻扣款)
    • Get All Users Cash Balance (获取所有用户现金信息)
    • Query Account Cash Balance(账户现金查询)
    • Query Account Position(账户持仓查询)
    • Account Cash Balance Adjustment(账户资金调账)
    • Account Position Adjustment(账户持仓调账,只支持股票)
    • Account Cash Balance Freeze(账户资金冻结)
    • Account Cash Balance Unfreeze(账户资金解冻)
    • Account Stock Transaction History(账户股票流水)
    • Account Cash Transaction History(账户资金流水)
    • Account Stock Freeze Transaction History(账户股票冻结流水)
    • Account Cash Freeze Transaction History(账户资金冻结流水)
    • Query Limited Amount Information(限额信息查询)
    • Query Buy Power(购买力查询)
    • Query Short Sellable Quantity(可卖空数量查询)
    • Query OB Account Cash Balance(账户现金详情查询)【定制非通用】
    • Query Account Total Asset(账户资产查询)
    • Query account risk limit config(查询用户限额信息)
    • Query Account Total Asset OverView(账户资产总览)
    • Query HashKey Cash List(查询hashkey的现金列表)
    • Create account risk limit config(创建用户限额信息)
    • Update account risk limit config(更新用户限额信息)
    • Temp Adjust 临时调账新增
    • Temp Adjust Expire 临时调账手动失效
  • Billing
    • Fee estimate
  • Cash And Stocks Transfer
    • Add Bank Card
    • Delete Bank Card
    • Region Bank
    • Get User Bank Card List
    • User Card Detail
    • Deposit Detail
    • Submit Deposit Application
    • Deposit Application List
    • Update Bank Card
    • Obtain the deposit information
    • Withdraw Records
    • Withdraw Detail
    • Cancel Withdraw Application
    • Get Exchange
    • Cancel Deposit
    • Submit Withdrawal Applylication
    • Information acquisition before withdrawal v3 (提现前信息获取V3)
    • Update Bank Card
    • Submit Files For Review Withdraw Card
    • Currency List
    • Exchange records(兑换记录)
  • File
    • Get Tenant File Upload URL(获取租户文件上传链接)
  • IPO
    • Get Available IPO List(查詢可申购IPO列表)
    • Get IPO Detail Info(查詢IPO详情)
    • Get IPO Payable List(查詢申购股数单位等限制)
    • Get IPO Margin List(查詢IPO认购方式及费率方案)
    • Get Order List (查询IPO历史订单)
    • Submit New IPO Order(提交IPO申购)
    • Withdraw IPO Order(撤销IPO申请)
    • Amend IPO Order(修改IPO申购订单)
    • Get IPO Order Detail(获取IPO订单的详细信息)
    • Buy Limit (持仓打新购买力获取接口)
  • Member Core
    • Change Member Mobile Phone(修改用户登录手机号)
    • Get Member Information by Mobile Phone(登录手机号查询用户信息)
    • Login (New user registration by default for the first login).(OpenId 注册登录接口,首次登录即注册)
    • Get Member Information by Login Email(登录邮箱查询用户信息)
    • Change Member Login Email(修改用户登录邮箱)
  • Trade
    • Trade Websocket Notification
    • Historical Order Inquiry (历史订单查询)
      GET
    • Place Order (委托下单)
      POST
    • Modify Order (修改订单)
      PUT
    • Withdraw Order (撤销订单)
      DELETE
    • Order Details (订单详情)
      GET
    • Today's Order Inquiry (当日订单查询)
      GET
    • Estimated Maximum Purchase Quantity (预估最大购买数量)
      GET
    • Today's Trade Detail Inquiry (当日成交明细查询)
      GET
    • Historical Trade Detail Inquiry (历史成交明细查询)
      GET
    • Query User Trade Credit(查询客户交易额度v1)
      GET
  • Message
    • Device Logout (设备登出解绑)
  1. Trade

Place Order (委托下单)

POST
/v1/whaleapi/trade/order
Trade
Place Order (委托下单)

Request

Body Params application/json
symbol
string 
required
Stock Symbol (股票代码,使用 ticker.region 格式)
Example:
AAPL.US
side
string 
required
Side (买卖方向)
Example:
Sell
order_type
string 
required
Order Type (订单类型)
Example:
LO
submitted_price
string 
optional
Submitted Price (下单价格)
Example:
88.5
submitted_quantity
string 
required
Submitted Quantity (下单数量)
Example:
100
time_in_force
string 
required
Time in Force (订单有效期类型)
Example:
Day
expire_date
string 
optional
Long-term Order Expiration Time (长期单过期时间,格式为 YYYY-MM-DD)
Example:
2022-12-05
outside_rth
string 
optional
Outside Regular Trading Hour (是否允许盘前盘后,美股必填)
trigger_price
string 
optional
Trigger Price (触发价格)
Example:
388.5
tailing_amount
string 
optional
Trailing Amount (跟踪金额)
tailing_percent
string 
optional
Trailing Percent (跟踪涨跌幅 %)
limit_offset
string 
optional
Order Target Price Spread (指定价差)
remark
string 
optional
Remark (备注)
<= 64 characters
account_no
string 
required
Account Profile (账户信息)
Example:
L6VQEU00121996
Example
{
  "symbol": "AAPL.US",
  "side": "Sell",
  "order_type": "LO",
  "submitted_price": "88.5",
  "submitted_quantity": "100",
  "time_in_force": "Day",
  "expire_date": "2022-12-05",
  "outside_rth": "string",
  "trigger_price": "388.5",
  "tailing_amount": "string",
  "tailing_percent": "string",
  "limit_offset": "string",
  "remark": "string",
  "account_no": "L6VQEU00121996"
}

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 2025-04-23 09:07:05
Previous
Historical Order Inquiry (历史订单查询)
Next
Modify Order (修改订单)