Today's Trade Detail Inquiry

This interface is used to retrieve the trade execution records for a specified securities account on the current trading day. By providing the account number account_no and optional filter conditions such as stock symbol symbol and order ID order_id, it returns all matching trade execution records for the current day. Each trade record includes order ID order_id, trade ID trade_id, executed quantity quantity, executed price price, execution time trade_done_at, and stock symbol symbol. Compared to the historical trade query interface, this interface only returns today's execution data without requiring a time range.

GEThttps://b-api.longbridge.xyz/v1/whaleapi/trade/execution/today

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Parameters

symbolstringOptional

Stock Symbol, in ticker.region format

order_idstringOptional

Order ID

account_nostringRequired

Account Number

Responses

HTTP 200Fields are taken from the real responses definition for this operation in the published Whale OpenAPI spec (whale-openapi/Whale-openapi.json).

Standard response envelopecodemessagedata

dataobjectdata structure

tradesarray<object>

trades

Child attributes

order_idstringrequired

Order ID. Order ID

trade_idstringrequired

Trade ID. Trade ID

quantitystringrequired

Executed Quantity. Executed Quantity

pricestringrequired

Executed Price. Executed Price

trade_done_atstringrequired

Executed Time (成交时间，格式为时间戳

symbolstringrequired

Stock Symbol. Stock Symbol

HTTP 400Bad request. Check the business error code in code and the error details in message.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

Request

curl --request GET \
  --url 'https://b-api.longbridge.xyz/v1/whaleapi/trade/execution/today' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "trades": [
      {
        "order_id": "string",
        "trade_id": "string",
        "quantity": "string",
        "price": "string",
        "trade_done_at": "string",
        "symbol": "string"
      }
    ]
  }
}