Get a referrer's referred clients with lifecycle segments
Segment counts across the whole referral set, plus a filtered page of clients ordered by window volume. Carries no commission amounts: the accrual ledger is not built yet.
Authorizations
Bearer token from Geomi. See Authentication for setup instructions.
Query Parameters
The referrer's wallet address (not a subaccount address)
Trailing UTC days the volume columns cover. Defaults to 30, clamped to 90.
x >= 0Clients per page. Defaults to 25, clamped to 200.
x >= 0Clients to skip. Clamped to 10000.
x >= 0Keep only one lifecycle bucket: active, at_risk, dormant or never_traded.
Case-insensitive substring match on the client address.
Response
Segment counts and a page of clients
How many clients sit in each lifecycle bucket. Always the whole referral set, never the filtered page, so the four counts sum to the affiliate's referral total.
Clients matching the current filter, for pagination
x >= 0
