Skip to main content
GET
Get referees
The response body shown here is a static example, not live data. After you click Send, your live result appears in a separate panel headed 200 OK. The panel under the status-code tabs is a fixed sample from the spec — its field values (fees, prices, sizes, IDs, timestamps) are placeholders. Use Send, or call the endpoint, for current values.
Returns the affiliate’s T1/T2/T3 referee list, newest-first by each referee row’s own boundAt. Optional from/to (epoch ms) bound the time window for follow-on pagination. Use nextCursor for exact pagination when multiple rows share the same boundAt.

Query Parameters

address
string
required

Ethereum address of the affiliate. 20-byte EVM address as hex: optional 0x or 0X prefix and exactly 40 hexadecimal digits. API responses normalize to lowercase af after 0x.

Pattern: ^(0x|0X)?[0-9a-fA-F]{40}$
from
integer<int64>

Start boundAt filter (epoch ms, inclusive).

Required range: x >= 0
to
integer<int64>

End boundAt filter (epoch ms, inclusive).

Required range: x >= 0
limit
integer
default:1000

Maximum rows to return. Default and maximum are both 1000; requests above the maximum are silently clamped.

Required range: 1 <= x <= 1000
cursor
string

Opaque cursor returned as nextCursor from the previous page. Encodes (boundAt, tier, address) and avoids duplicate/skip behavior for rows with identical timestamps.

Response

List of referees.

referees
object[]
nextCursor
string

Opaque cursor for the next page, encoded from the last returned row's (boundAt, tier, address). Omitted when there is no next page.