---
name: suibrokers-progress
description: Use for reading four-stage season progress and explaining the boundary between verified Points, qualification, capacity, and final allocation.
---

# SUI BROKERS Season Progress

Use `suibrokers_get_season` for one stage number from 1 through 4, an optional canonical viewer wallet, and a bounded entry limit. Read [references/api.md](references/api.md) when explaining stage thresholds, capacity, or planned NFT mechanics.

The API is authoritative. Return the raw `stage`, `entries`, and `viewer` fields with source origin, endpoint, and timestamp. Do not recompute Points, rank, cutoff, rollover, capacity, or allocation from visible entries. Keep an unavailable response separate from a valid stage with no entries, and preserve explicit pending, confirmed, or partial states.

Verified swap activity is credited only after confirmation and verification. Desk activity is credited only when the service ledger confirms the record. A progress value, threshold, rank, or available capacity does not guarantee a final Broker NFT allocation.

For a points-related action, `suibrokers_prepare_action` is only a review plan. It never refreshes points, claims a token, activates a level, or mints an NFT.