Get an affiliate's accrued commission
What the affiliate has earned: today, since Monday, and over all time, plus a daily breakdown carrying the tier and any anti-farming penalty that was in force each day.
This is not what is claimable. Claimable commission is an on-chain campaign allocation and comes from the campaigns endpoints; this is the off-chain ledger of what is owed.
Authorizations
Bearer token from Geomi. See Authentication for setup instructions.
Query Parameters
The affiliate's wallet address (not a subaccount address)
Trailing UTC days of daily breakdown to return. Defaults to 30, clamped to 180.
x >= 0Response
The affiliate's accrued commission
An affiliate's accrued commission: today, the running week, and lifetime.
Distinct from what is claimable, which lives on chain in campaign_claims. This
endpoint answers "what have I earned"; the chain answers "what can I take". Keeping them
apart is what makes "accrued but not yet swept" and "accrued but forfeited" answerable
without trusting either side alone.
Accrued since Monday. This is what the weekly sweep will pay, or forfeit.
Accrued so far today. Provisional until the week is swept.
The trailing-window NUV that rung was derived from.
The rung in force, from the most recent accrual. bronze when there is no history:
an affiliate whose network brings nobody new still earns, at the lowest rate.
Daily breakdown, oldest first. Days with no activity are absent, not zero-filled.
Accrued over all time, including weeks already paid.
Whether the running week currently clears the floor
The floor a week must clear to be paid at all
points | usd, as stamped on the most recent accrual. Absent history reads
points, which is the status quo for every affiliate today.
Days in the NUV window. Sent so the caller can label it without hardcoding 30.
x >= 0The Monday pending_mode starts, YYYY-MM-DD, or empty when nothing is pending.
A recorded election that has not taken effect yet, or empty.
Published because mode alone cannot express it. An election lands on a future Monday, so
between signing it and that day the affiliate is still earning the old currency and the
ledger still stamps it — a screen reading only mode shows no trace of a decision that has
already been made, irreversibly. The affiliate concludes it failed and tries again.
On-chain campaign carrying the previous week, or 0 when it is not on chain yet. A non-zero id means the money is claimable through the campaigns endpoints, not here.
x >= 0What the sweep decided about that week: paid, forfeited, withheld, or empty
when it has not been swept yet. Empty is the common case early in a week.
Accrued over the week before this one. Non-zero for the two or three days between a week closing and its sweep paying out — the window in which the running week reads near zero while real money is still owed.
0.0–1.0 progress toward the floor, for a progress indicator
The whole ladder, highest rung first. Static config, published so no client keeps a second copy of the rate table.
Monday of the running week, YYYY-MM-DD
Weekly history, newest first: what each week accrued and what the sweep decided.
Separate from days because the two answer different questions — days is how the
figure was built, weeks is what happened to it.

