Get referral summary
curl --request GET \
--url https://api.unitedmarket.ai/referral/summary \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <api-key>'const options = {
method: 'GET',
headers: {'x-api-key': '<api-key>', Authorization: 'Bearer <token>'}
};
fetch('https://api.unitedmarket.ai/referral/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.unitedmarket.ai/referral/summary"
headers = {
"x-api-key": "<api-key>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"code": "<string>",
"rewardBps": 3000,
"refereeCount": 123,
"referees": [
{
"address": "<string>",
"username": "<string>",
"referredAt": "2023-11-07T05:31:56Z",
"volumeUsd": 123,
"feesUsd": 123,
"rewardUsd": 123
}
],
"totals": {
"downlineVolumeUsd": 123,
"lifetimeRewardUsd": 123,
"currentEpochRewardUsd": 123,
"paidUsd": 123,
"unpaidUsd": 123
},
"epoch": {
"start": "2023-11-07T05:31:56Z",
"end": "2023-11-07T05:31:56Z"
}
}{
"message": "Invalid API Key provided",
"error": "Unauthorized",
"statusCode": 401
}Referral
Get referral summary
Returns the authenticated user’s referral code, referees, reward totals, and the current weekly epoch. Requires both x-api-key (shared web key or a personal key) and a SIWE bearer. A bearer without x-api-key returns 401 Invalid API Key provided.
GET
https://api.unitedmarket.ai
/
referral
/
summary
Get referral summary
curl --request GET \
--url https://api.unitedmarket.ai/referral/summary \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <api-key>'const options = {
method: 'GET',
headers: {'x-api-key': '<api-key>', Authorization: 'Bearer <token>'}
};
fetch('https://api.unitedmarket.ai/referral/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.unitedmarket.ai/referral/summary"
headers = {
"x-api-key": "<api-key>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"code": "<string>",
"rewardBps": 3000,
"refereeCount": 123,
"referees": [
{
"address": "<string>",
"username": "<string>",
"referredAt": "2023-11-07T05:31:56Z",
"volumeUsd": 123,
"feesUsd": 123,
"rewardUsd": 123
}
],
"totals": {
"downlineVolumeUsd": 123,
"lifetimeRewardUsd": 123,
"currentEpochRewardUsd": 123,
"paidUsd": 123,
"unpaidUsd": 123
},
"epoch": {
"start": "2023-11-07T05:31:56Z",
"end": "2023-11-07T05:31:56Z"
}
}{
"message": "Invalid API Key provided",
"error": "Unauthorized",
"statusCode": 401
}Authorizations
Shared web key or a personal key (umk_live_…). Required on routes that are not @Public(). A missing or unknown key returns 401 Invalid API Key provided even if a SIWE bearer is also sent.
SIWE access token returned by POST /auth/verify.
