Get Affiliate Deal Data

HTTP request Retrieve trading volume and rebate statistics for one or more direct customers.

• GET /api/v3/agency/getDealData

Weight(IP): 20, Weight(UID): 20

Request parameters

Parameter	Type	Required?	Description
userIds	List<Long>	No	Optional repeated query parameter (e.g. userIds=123&userIds=456). Defaults to all direct users
startTime	String	No	Filter start date (UTC, format yyyy-MM-dd)
endTime	String	No	Filter end date (UTC, format yyyy-MM-dd)

Request example

curl "https://api-spot.weex.com/api/v3/agency/getDealData?userIds=4667776811&startTime=2025-02-01&endTime=2025-03-01" \
  -H "ACCESS-KEY:*******" \
  -H "ACCESS-SIGN:*******" \
  -H "ACCESS-PASSPHRASE:*****" \
  -H "ACCESS-TIMESTAMP:1732972800000" \
  -H "Content-Type: application/json"

Response parameters

Field Name	Type	Description
data	Array	Trading statistics returned by the upstream service
userId	Long	UID of the queried customer
spotDealAmountUsdt	String	Spot trading volume (USDT)
futuresProDealAmountUsdt	String	Futures trading volume (USDT)
spotProDealAmountUsdtTemp	String	Spot trading volume (raw value returned by partner system)
startTime	String	Start date applied by the upstream service (yyyy-MM-dd)
endTime	String	End date applied by the upstream service (yyyy-MM-dd)

Response example

{
  "data": [
    {
      "futuresProDealAmountUsdt": "619659.79380470",
      "spotDealAmountUsdt": "75156.60000000",
      "spotProDealAmountUsdtTemp": "75156.6",
      "userId": 4667776811
    }
  ],
  "endTime": "2026-03-04",
  "startTime": "2025-12-03"
}