Skip to main content
POST
/
info
curl --request POST \
  --url https://api.hotstuff.trade/info \
  --header 'Content-Type: application/json' \
  --data '{
    "method": "referral_summary",
    "params": {
        "user": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    }
}'

{
  "address": "0x42C183edba036906447372a7c81Eb89D0B9f2175",
  "referrer": "0x944Aa860FA3402bC93401c177ce255494b2C0C86",
  "referrer_code": "",
  "refer_timestamp": 1765207493207,
  "codes": [
    "HELLO"
  ],
  "is_affiliate": false,
  "referred_users": {
    "0x6829204052161334C2dfE35FED55920Ce9EF9845": {
      "code": "",
      "joined_at": 1768305356993,
      "referred_volume": 0,
      "perp_volume": {
        "maker_volume": 0,
        "taker_volume": 0
      },
      "spot_volume": {
        "maker_volume": 0,
        "taker_volume": 0
      },
      "stable_spot_volume": {
        "maker_volume": 0,
        "taker_volume": 0
      },
      "referred_perp_rewards": 0,
      "referred_spot_rewards": 0
    }
  },
  "to_claim_perp_rewards": 0,
  "to_claim_spot_rewards": 0,
  "claimed_perp_rewards": 1.056674,
  "claimed_spot_rewards": 0,
  "total_referred_volume": 269870,
  "rolling_referred_volume": 0,
  "referral_tier": {
    "total_referred_volume": 500000,
    "fee_discount_rate": 0.05,
    "referrer_commission": 0.1
  },
  "updated_at": 1770139462693
}
Retrieve referral summary including referrer information, referral codes, rewards, and referral tier details for a user. 
curl --request POST \
  --url https://api.hotstuff.trade/info \
  --header 'Content-Type: application/json' \
  --data '{
    "method": "referral_summary",
    "params": {
        "user": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    }
}'

Body

application/json
​
method
string
required
​
params
object
required

Response

Successful response

​
address
string
​
referrer
string
​
referrer_code
string
​
refer_timestamp
integer
​
codes
string[]
​
is_affiliate
boolean
​
referred_users
object
​
to_claim_perp_rewards
integer
​
to_claim_spot_rewards
integer
​
claimed_perp_rewards
number
​
claimed_spot_rewards
integer
​
total_referred_volume
integer
​
rolling_referred_volume
integer
​
referral_tier
object
​
updated_at
integer