Points

Developer reference for the Permissionless Rewards API service.

📈 Season 03 Updates (Updated: March 2026) What's New: The full leaderboard dump has been replaced with an individual address lookup endpoint for faster, more efficient querying.

Permissionless Rewards: Concepts

Before integrating the Nansen Points Leaderboard endpoint, it helps to understand Permissionless Rewards at a high level—see Nansen Academy: On Permissionless Rewards for full details.

• What they are: An open registry that maps Nansen Points balances to onchain wallets (EVM and Solana), without requiring an API key or explicit permission from Nansen.

• Why it matters: Protocols can seamlessly discover eligible wallets and distribute tokens, NFTs, or other perks—fully public and opt-in.

• Privacy model: The API only exposes a wallet's tier. No personal data, balances, or rankings are shared.

• User control: Holders can add or remove their wallet mapping at any time, revoking future distributions.

Points Leaderboard

GET https://app.nansen.ai/api/points-leaderboard/{address}

Fetch the tier for a single wallet address. No API key or authentication required.

Query Parameters

Name	Type	Required	Description
address	string	Yes	EVM or Solana wallet address. Case-insensitive.

Example Request

https://app.nansen.ai/api/points-leaderboard/0xbbfb6566ad064c233af6314aeb1eee4c26a5f921

Response Codes

Response Structure

   {"tier":"star"}

Response Codes

Code	Description
200	Successful response
500	Internal server error

Record Fields (within data array):

Field	Type	Description
tier	string	Tier name determined by points thresholds. Valid tier values are: "none," "green," "ice," "north," or "star." Addresses not on the leaderboard return "none."

Usage Notes

• Minimum Qualification: Wallets with fewer than 1,000 points return {"tier":"none"}

• Public & Permissionless: No authentication required.

• Data Refresh: Tier data refreshes daily at 11am UTC. Implement local caching to reduce redundant calls.