Check Trade Detail

Description

This interface is used to query the trade detail data of a security.

HTTP Request

• GET /api/v3/stockplus/market/trade
• Rate limit: 10 times/1s (UID), with up to 5 concurrent requests

Request

curl "https://api.bitget.com/api/v3/stockplus/market/trade?symbol=AAPL.US&count=10" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

Request Parameters

Parameters	Type	Required	Description
symbol	String	Yes	Symbol, using ticker.region format, e.g. AAPL.US
count	Integer	Yes	Number of trade records to request. Maximum: 1000

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": [
    {
      "price": 195.890,
      "volume": 100,
      "timestamp": "2024-10-16T09:30:00Z",
      "tradeType": "I",
      "direction": "Up",
      "tradeSession": "Intraday"
    },
    {
      "price": 195.880,
      "volume": 200,
      "timestamp": "2024-10-16T09:29:55Z",
      "tradeType": "I",
      "direction": "Neutral",
      "tradeSession": "Intraday"
    },
    {
      "price": 195.890,
      "volume": 150,
      "timestamp": "2024-10-16T09:29:50Z",
      "tradeType": "I",
      "direction": "Down",
      "tradeSession": "Intraday"
    }
  ]
}

Response Parameters

Parameters	Type	Description
data	List<Object>	Trade detail data
> price	String	Price
> volume	String	Volume
> timestamp	String	Trade time (ISO 8601)
> tradeType	String	Trade type. See Trade Type section below
> direction	String	Trade direction Up - Up Down - Down Neutral - Neutral
> tradeSession	String	Trade session Intraday - Regular Pre - Pre-market Post - After-hours Overnight - Overnight

Trade Type

US Trade Types

Type	Description
(space)	Regular sale
B	Average price trade
E	Automatic execution
H	Price variation trade
I	Odd lot trade