Season Distribution

Returns the authenticated user's token distribution record(s) for a given season.

GET /points/distribution/:season_id
Authorization: Bearer <token>

Path Parameters

Parameter	Type	Description
season_id	UUID	Season ID (obtained from GET /points/seasons)

Response

Returns an array. A user may have up to two records — one for the user pool and one for the mm (market maker) pool. Returns [] if the season snapshot has not been taken yet.

[
  {
    "id": "f1e2d3c4-...",
    "season_id": "a1b2c3d4-...",
    "user_address": "0xabcd...1234",
    "pool_type": "user",
    "weighted_points": "48500.00",
    "share_pct": "0.000023000000",
    "token_amount": "805.00",
    "claim_status": "pending",
    "claim_deadline": "2026-03-05T00:00:00Z",
    "claim_nonce": 1,
    "claimed_at": null,
    "claim_tx_hash": null,
    "created_at": "2026-02-03T00:00:00Z"
  }
]

Records are sorted by pool_type — mm appears before user.

Response Fields

Field	Type	Description
id	string	Distribution record UUID — used in the claim endpoint
season_id	string	Season UUID
user_address	string	User's wallet address
pool_type	string	user (regular pool) or mm (market maker pool)
weighted_points	Decimal	User's points × Earn Level weight
share_pct	Decimal	Share of pool (12-decimal precision)
token_amount	Decimal	Token amount allocated (human-readable, not wei)
claim_status	string	pending / claimed / expired
claim_deadline	string	Claim deadline — 30 days after snapshot (ISO 8601)
claim_nonce	int	Nonce used in EIP-712 signature
claimed_at	string | null	Timestamp when claimed on-chain
claim_tx_hash	string | null	On-chain claim transaction hash

Distribution Formula

weighted_points = raw_total_points × earn_level_weight
share_pct       = user_weighted_points / Σ(all_users_weighted_points)
token_amount    = season_pool_tokens × share_pct

Code Examples

Python

import requests

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

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

for rec in records:
    print(f"Pool: {rec['pool_type']}, Tokens: {rec['token_amount']}, Status: {rec['claim_status']}")
    if rec["claim_status"] == "pending":
        print(f"  Claim by: {rec['claim_deadline']}, distribution_id: {rec['id']}")