17-07-2026: Premium Labels Default Change Now Live

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.

Value	Behavior	Credits Used
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.