WhaleAPI(Public)
  1. Trade
WhaleAPI(Public)
  • Passthrough Headers
  • Generate signature
  • Account Trade Auth
    • Trade Password Auth(交易密码校验)
      POST
    • Trade Password Set(交易密码设置)
      POST
    • Trade Password Reset(交易密码修改/重置)
      POST
    • Account No. Login Password Auth 证券帐号登录密码校验
      POST
  • Accounts
    • Whale Record Agreement(同步签署协议状态)
      POST
    • Get Account Trade Permission(获取账户交易权限)
      GET
    • Update Account Trade Permission(更新账户权限)
      POST
    • Update User Risk Assessment Results(用户风险测评结果更新)
      POST
    • Retrieve Account Application Information(获取证券账户开户资料信息)
      GET
    • Get Account List(获取用户账户列表)
      GET
    • Get Account Request List(获取用户开户申请列表)
      GET
    • Get Account Contact Info(获取账户联系方式)
      GET
    • Get Account Status(获取账户状态)
      POST
    • Get Account Bcan Information(获取账户 Bcan 信息)
      GET
    • Query Account List V2(获取账户列表V2)
      GET
    • Update Application(修改开户资料)
      POST
    • Update Account State/Disable Account(修改账户状态 / 冻结账户)
      POST
    • Submit Application V2(提交开户申请资料 V2)
      POST
    • Update Application V2(修改开户资料 V2)
      POST
    • Close Account(注销账户)
      POST
    • Open additional account(增开账户)
      POST
    • get account opening application information (开户申请信息获取)
      POST
    • Query Account Risk And Pi Info(获取用户风险测评以及Pi信息)
      GET
  • Asset
    • Query Total Holdings(查询全量股票持仓)
    • Query Account Cash Balance(账户现金查询)
    • Query Company Total Finance Amount(公司级融资额度查询接口)
    • Account Stock Transfer In(账户股票转入,只支持多头)
    • Account Stock Freeze(账户股票冻结,只支持多头)
    • Account Stock Unfreeze(账户股票解冻,只支持多头)
    • Account Stock Unfreeze Debit(账户股票解冻出账,只支持多头)
    • Query Total Cash(查询全量现金)
    • Query Account Position(账户持仓查询)
    • Account Cash Balance Adjustment(账户资金调账)
    • Account Position Adjustment(账户持仓调账,只支持股票)
    • Account Cash Balance Freeze(账户资金冻结)
    • Account Cash Balance Unfreeze(账户资金解冻)
    • Account Cash Balance Unfreeze Debit(账户资金解冻扣款)
    • 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 临时调账手动失效
    • Get All Users Cash Balance (获取所有用户现金信息)
    • Temporary Adjustment(临时调账)
  • 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(兑换记录)
    • Stock transfer out detail (查看转出详情)
    • Stock transfer out records (查询转出记录)
    • Transfer in detail (查看转入详情)
    • Transfer in records (查询转入记录)
    • Query Stock Transfer Market (查询转仓股票市场)
    • Query Broker List (查询转仓券商列表)
    • Stock Search (转入股票搜索)
    • Apply Stock Transfer In (提交转入申请)
    • Cancel Transfer In Application (取消转入申请)
    • Query Transfer Stock Position (查询可转股票持仓)
    • Apply Stock Transfer Out (提交转出申请)
    • Cancel Transfer Out Application (取消转出申请)
    • User Name Combination List(用户姓名列表)
  • 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
    • Update PI Status
    • 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(修改用户登录邮箱)
    • Logout By Session ID
  • Trade
    • Trade Websocket Notification
    • Historical Trade Detail Inquiry V2(历史成交明细查询V2)
      GET
    • Trade Detail Inquiry V3(成交明细查询V3)
      GET
    • Withdraw User Orders (批量撤销用户订单)
      POST
    • Batch Replenishment (批量补单)
      POST
    • Submit Mutileg Order(委托多腿期权)
      POST
    • 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
  • Message
    • Global Push Templates(全局推送模板)
    • Device Logout (设备登出解绑)
  • Search
    • Search Stock
  • Reward Center
    • 奖励中心- 发放奖励
    • 奖励中心 - 查询奖励状态
  • OpenAPI
    • Create Access Key
    • GetAccessKey
    • List Access Keys
    • Update Access Key
    • Disable Access Key
    • Enable Access Key
    • Renew Access Token
    • Revoke Access Token
  • Bind the invitation code for the specified stage (绑定指定阶段的邀请码)
    POST
  1. Trade

Submit Mutileg Order(委托多腿期权)

Developing
POST
/v1/whaleapi/trade/order/multileg
Trade
该接口用于为指定证券账号提交多腿组合期权订单,与普通委托下单接口相互独立,仅支持两腿及以上的组合策略,单腿委托请继续使用原委托下单接口。调用方通过传入策略类型 strategy(备兑、垂直价差、领式、跨式、宽跨式)、组合腿列表 legs(每条腿含合约代码 counter_id 及腿比例 ratio_quantity)、组合买卖方向 side、订单类型 order_type、组合份数 quantity、价格 price 及结算货币 settlement_currency 等参数,由接口完成组合订单的创建并返回订单编号 order_id。组合整体报价、整体成交,支持限价单、市价单,同时支持幂等标识及备注信息。
This interface is used to submit a multi-leg options combination order for a specified securities account. It is independent of the regular place-order interface and supports combination strategies with two or more legs only; for single-leg orders, please continue to use the existing place-order interface. The caller provides the strategy type strategy (covered, vertical spread, collar, straddle, strangle), the leg list legs (each leg containing contract code counter_id and leg ratio ratio_quantity), the combination-level trade direction side, order type order_type, combination quantity quantity, price price, and settlement currency settlement_currency, and the interface creates the combination order and returns the order ID order_id. The combination is quoted and filled as a single unit. It supports limit orders and market orders, as well as an idempotency key and remarks.

Request

Authorization
Body Params application/json
side
enum<string> 
required
Side (买卖方向)
Allowed values:
BuySell
Example:
Sell
order_type
enum<string> 
required
Order Type (订单类型)
Allowed values:
LOMO
Example:
LO
submitted_price
string 
optional
Submitted Price (下单价格,LO / ELO / ALO / ODD / LIT 订单必填)
Example:
88.5
submitted_quantity
string 
required
Submitted Quantity (下单数量)
Example:
100
remark
string 
optional
Remark (备注)
<= 64 characters
account_no
string 
required
Account Number(证券账号)
Example:
L6VQEU00121996
strategy
enum<string> 
required
Mutileg Strategy(多腿策略)
Allowed values:
CoveredCallCoveredPutVerticalCallSpreadVerticalPutSpreadCollarStraddleStrangle
Example:
CoveredCall
legs
object 
required
组合期权各腿信息
symbol
string 
required
Stock Symbol, in ticker.region format (股票代码,使用 ticker.region 格式)
Example:
QQQ260731C764000.US
ratio_quantity
string 
required
Ratio Quantity(该腿比例数量)
Example:
1
Example
{
  "side": "Buy",
  "order_type": "LO",
  "submitted_price": "88.5",
  "submitted_quantity": "100",
  "remark": "string",
  "account_no": "L6VQEU00121996",
  "strategy": "CoveredCall",
  "legs": {
    "symbol": "QQQ260731C764000.US",
    "ratio_quantity": "1"
  }
}

Responses

🟢200OK
application/json
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-09-01 09:38:00
Previous
Batch Replenishment (批量补单)
Next
Historical Order Inquiry (历史订单查询)