User Tier

Returns the authenticated user's current tier and progress toward the next tier.

GET /points/tier
Authorization: Bearer <token>

Query Parameters

Parameter	Type	Required	Description
epoch	integer	No	Epoch number; defaults to current

Response

{
  "tier": "T2",
  "multiplier": "1.5",
  "min_volume": "5000000",
  "max_volume": "99999999.99",
  "current_volume": "8500000.00",
  "next_tier": {
    "tier": "T3",
    "multiplier": "2.0",
    "required_volume": "100000000",
    "remaining_volume": "91500000.00"
  }
}

next_tier is null when the user is already at T3 (max tier).

Response Fields

Field	Type	Description
tier	string	Current tier: T1 / T2 / T3
multiplier	string	Trading point rate multiplier
min_volume	string	Minimum volume threshold for current tier (USD)
max_volume	string	Maximum volume threshold for current tier (USD)
current_volume	string	User's 14-day rolling trading volume (USD)
next_tier	object | null	Next tier info; null if at T3

next_tier

Field	Type	Description
tier	string	Next tier name
multiplier	string	Next tier multiplier
required_volume	string	Volume threshold required for next tier (USD)
remaining_volume	string	Additional volume still needed (USD)

Tier Thresholds

Tier	14-day Rolling Volume	Maker Rate	Taker Rate
T1	$0 – $4,999,999	1.2 TP / $1,000	0.8 TP / $1,000
T2	$5M – $99,999,999	1.5 TP / $1,000	1.0 TP / $1,000
T3	≥ $100M	2.0 TP / $1,000	1.3 TP / $1,000

Code Examples

Python

import requests

BASE_URL = "https://api.primit.io/api/v1"
JWT_TOKEN = "your_jwt_token"

resp = requests.get(
    f"{BASE_URL}/points/tier",
    headers={"Authorization": f"Bearer {JWT_TOKEN}"},
)
data = resp.json()

print(f"Tier: {data['tier']} (×{data['multiplier']}), Volume: {data['current_volume']}")
if data["next_tier"]:
    print(f"Next: {data['next_tier']['tier']}, need {data['next_tier']['remaining_volume']} more")