Skip to main content
POST
https://api.hotstuff.trade
/
info
curl --request POST \
  --url https://api.hotstuff.trade/info \
  --header 'Content-Type: application/json' \
  --data '{
    "method": "referralSummary",
    "params": {
        "user": "0xxxx"
    }
}'
{
    "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": "referralSummary",
    "params": {
        "user": "0xxxx"
    }
}'
{
    "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
}

Request Body

method
string
default:"referralSummary"
required
Must be “referralSummary” for this endpoint
params
object
required