Skip to main content
GET
Get trading activity of a referrer's referred clients

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

referrer_account
string
required

The referrer's wallet address (not a subaccount address)

days
integer<int64>

Trailing UTC days to cover. Defaults to 14, clamped to 90.

Required range: x >= 0
limit
integer<int32>

Direct (L1) clients per page. Defaults to 25, clamped to 200.

Required range: x >= 0
offset
integer<int32>

Direct (L1) clients to skip. Clamped to 10000.

Required range: x >= 0

Response

Referral activity summary and client page

Referral activity: per-level totals plus a page of direct referrals.

clients
object[]
required

A page of L1 clients, each carrying its own L2s

referrer_account
string
required
summary
object[]
required

Levels that traded in the window, level 1 first

total_count
integer<int64>
required

L1 rows the window holds, for pagination. Counts parents, not clients: an L1 that only appears because its L2s traded still occupies a row.

Required range: x >= 0