17-07-2026: Premium Labels Default Change Now Live
Value
Behavior
Credits Used
Last updated
Was this helpful?
Affected endpoints: tgm/holders, tgm/pnl-leaderboard, tgm/perp-pnl-leaderboard, perp-leaderboard
The premium_labels default change announced in the 31-03-2026 changelog entry is now live.
omitted (default)
Returns free-tier labels only
Standard credit cost (5)
true
Returns premium labels (Smart Money, Fund, etc.)
150
false
Returns free-tier labels only
Standard credit cost (5)
What changed:
Requests that omit premium_labels now return free-tier labels at the standard credit cost. Previously, omitted requests returned premium labels.
Passing premium_labels=true returns premium labels (Smart Money, Fund, etc.), is billed at 150 credits per call, and requires a paid plan. Free plan users sending premium_labels=true receive a 403 Forbidden response.
Passing premium_labels=false is unchanged: free-tier labels at the standard credit cost.
Action required: If your integration relies on premium labels (Smart Money, Fund, and other advanced labels) in responses from these endpoints, pass "premium_labels": true explicitly. Note the 150-credit-per-call cost before enabling it.
The credit cost of each request is always returned in the X-Nansen-Credits-Used response header.
Last updated
Was this helpful?
Was this helpful?