Points

Developer reference for the Permissionless Rewards API service.

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.

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

A. Points Leaderboard (Paginated)

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

Query the full leaderboard with pagination. No authentication required.

Query Parameters

Name	Type	Required	Default	Description
tier	string	No	all tiers	Filter by tier: green, ice, north, star
page	integer	No	1	Page number (min: 1)
recordsPerPage	integer	No	10	Results per page (min: 1, max: 10,000)

Example Request

https://app.nansen.ai/api/points-leaderboard/api?tier=star&recordsPerPage=10

Response Structure

Results are ordered by rank. Ties share the same rank.

"results": [
      {
        "rank": 1,
        "points": 982400,
        "evm_address": "0x1234...abcd",
        "solana_address": null,
        "tier": "Star",
        "is_eligible": true
      },
      {
        "rank": 2,
        "points": 871200,
        "evm_address": "0x5678...efgh",
        "solana_address": "7xKX...9mPq",
        "tier": "Star",
        "is_eligible": true
      }
    ]

B. Individual Lookup

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 Structure

   {"tier":"star"}

References

Response Codes

Code	Description
200	Successful response
400	Invalid parameters

Fields Response:

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."
rank	number	Leaderboard rank. Users with the same points share the same rank.
points	number	Total accumulated Nansen Points
evm_address	string	Linked EVM rewards wallet
solana_address	string	Linked Solana rewards wallet

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.