WhaleAPI（Public）
  1. Accounts
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
    • Update Client Trading PI Status
      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 Client Trading PI Status
      GET
  • Asset
    • Query Total Holdings（查询全量股票持仓）
      GET
    • Query Account Cash Balance（账户现金查询）
      GET
    • Query Company Total Finance Amount(公司级融资额度查询接口)
      POST
    • Account Stock Transfer In（账户股票转入，只支持多头）
      POST
    • Account Stock Freeze（账户股票冻结，只支持多头）
      POST
    • Account Stock Unfreeze（账户股票解冻，只支持多头）
      POST
    • Account Stock Unfreeze Debit（账户股票解冻出账，只支持多头）
      POST
    • Query Total Cash（查询全量现金）
      GET
    • Query Account Position（账户持仓查询）
      GET
    • Account Cash Balance Adjustment（账户资金调账）
      POST
    • Account Position Adjustment（账户持仓调账,只支持股票）
      POST
    • Account Cash Balance Freeze（账户资金冻结）
      POST
    • Account Cash Balance Unfreeze（账户资金解冻）
      POST
    • Account Cash Balance Unfreeze Debit（账户资金解冻扣款）
      POST
    • Account Stock Transaction History（账户股票流水）
      POST
    • Account Cash Transaction History（账户资金流水）
      POST
    • Account Stock Freeze Transaction History（账户股票冻结流水）
      GET
    • Account Cash Freeze Transaction History（账户资金冻结流水）
      GET
    • Query Limited Amount Information（限额信息查询）
      GET
    • Query Buy Power（购买力查询）
      GET
    • Query Short Sellable Quantity（可卖空数量查询）
      GET
    • Query OB Account Cash Balance（账户现金详情查询）【定制非通用】
      POST
    • Query Account Total Asset（账户资产查询）
      POST
    • Query account risk limit config（查询用户限额信息）
      GET
    • Query Account Total Asset OverView（账户资产总览）
      GET
    • Query HashKey Cash List（查询hashkey的现金列表）
      GET
    • Create account risk limit config（创建用户限额信息）
      POST
    • Update account risk limit config（更新用户限额信息）
      POST
    • Temp Adjust 临时调账新增
      POST
    • Temp Adjust Expire 临时调账手动失效
      POST
    • Get All Users Cash Balance (获取所有用户现金信息)
      GET
    • Temporary Adjustment（临时调账）
      POST
  • 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 Client Market PI Status
    • Query Client Market 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)
    • Trade Detail Inquiry V3(成交明细查询V3)
    • Withdraw User Orders (批量撤销用户订单)
    • Batch Replenishment (批量补单)
    • Submit Mutileg Order(委托多腿期权)
    • Historical Order Inquiry (历史订单查询)
    • Place Order (委托下单)
    • Modify Order (修改订单)
    • Withdraw Order (撤销订单)
    • Order Details (订单详情)
    • Today's Order Inquiry (当日订单查询)
    • Estimated Maximum Purchase Quantity (预估最大购买数量)
    • Today's Trade Detail Inquiry (当日成交明细查询)
    • Historical Trade Detail Inquiry (历史成交明细查询)
  • Message
    • Global Push Templates（全局推送模板）
    • Device Logout (设备登出解绑)
  • Search
    • Search Stock
  • Reward Center
    • 奖励中心- 发放奖励（Reward Center - Send Reward）
    • 奖励中心 - 查询奖励状态信息（Reward Center - Get Reward Status Info）
  • 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. Accounts

Update Client Trading PI Status

POST
/v1/whaleapi/account/update_trading_pi_status
按 member_id 回写终端客户的交易 PI，即证监会（SFC）口径的专业投资者认定。写入后立即生效，不需要人工审核。交易 PI 和行情 PI 是两套独立的认定，本接口只影响交易 PI。写入结果可以通过「Query Client Trading PI Status」查询。
Updates an end client's Trading PI status, i.e. Professional Investor status as defined by the SFC, by member_id. The update takes effect immediately and requires no manual review. Trading PI and Market Data PI are two independent statuses; this API affects Trading PI only. The result can be retrieved via "Query Client Trading PI Status".
error_code
0 Success, including when the submitted status matches the current status
400 Invalid parameters: a required parameter is missing, is_pi is not a boolean, pi_expire_time is not in YYYY-MM-DD format, or pi_expire_time is earlier than the current date (UTC+8)
401011 Member not found: member_id does not exist, has been closed, or does not belong to the calling tenant
404613 User not registered: the user has not started account opening with Whale
403025 The client has a Professional Investor application under review
500 Internal error; the request can be retried

Request

Authorization
Body Params application/json
member_id
string 
required
用户注册唯一识别id
is_pi
boolean 
required
布尔值：true / false（与交易PI查询接口返回的 is_pi 类型一致）
false 表示不是pi
true表示是pi
pi_expire_time
string 
required
I过期时间
格式：YYYY-MM-DD
is_pi=true 时必填；is_pi=false 时忽略
按香港时间（UTC+8）当天 23:59:59 换算为 Unix 时间戳存储，查询接口按时间戳返回
不能早于调用当天，否则返回参数错误
Example
{
  "member_id": "1111",
  "is_pi": true,
  "pi_expire_time": "2027-12-31"
}

Responses

🟢200Success
application/json
Body
code
integer 
optional
message
string 
optional
Example
{
  "data": {
    "pi_info": {
      "is_pi": false,
      "pi_expire_time": 1768200639
    },
    "rpq_info": {
      "risk_level": "A4",
      "score": 22,
      "product": "fund"
    }
  }
}
🟠400Invalid input
Modified at 2026-10-26 03:41:35
Previous
Update User Risk Assessment Results（用户风险测评结果更新）
Next
Retrieve Account Application Information(获取证券账户开户资料信息)