Skip to main content
GET
/
v1
/
affiliate
/
commissions
Get affiliate commission history
curl --request GET \
  --url https://api.testnet.arcus.xyz/v1/affiliate/commissions
{
  "commissions": [
    {
      "affiliate": "<string>",
      "referee": "<string>",
      "fillId": 123,
      "tier": 2,
      "amountQuantums": 123,
      "postTotalCommissionQuantums": 123,
      "postPendingCommissionQuantums": 123,
      "timestampUs": 123
    }
  ],
  "nextCursor": "<string>"
}
Returns one page of an affiliate’s per-fill commission events, ordered by fillId DESC, tier ASC, referee ASC. Each row carries both the per-event delta (amountQuantums) and the post-event snapshot (postTotalCommissionQuantums, postPendingCommissionQuantums) stamped by go-attribution at emission time, so clients never have to re-aggregate. Served by a ClickHouse partition scan against persistence.referral_commissions.

Query Parameters

​
address
string
required

Affiliate address to fetch the commission log for. 20-byte EVM address as hex: optional 0x or 0X prefix and exactly 40 hexadecimal digits. API responses normalize to lowercase a–f after 0x.

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

Optional inclusive lower bound on timestamp_ms. Omit for no lower bound (start of time).

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

Optional inclusive upper bound on timestamp_ms. Omit for no upper bound (current time).

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

Optional opaque cursor returned as nextCursor by the previous response. Cursors are scoped to the same address and optional from/to bounds.

Response

Commission events newest-first.

​
commissions
object[]
required
​
nextCursor
string

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