Skip to main content
GET
/
v1
/
affiliate
/
claims
Get affiliate claim history
curl --request GET \
  --url https://api.testnet.arcus.xyz/v1/affiliate/claims
{
  "claims": [
    {
      "affiliate": "<string>",
      "timestampUs": 123,
      "claimId": "<string>",
      "cutoffFillId": 123,
      "amountQuantums": 123
    }
  ]
}
Returns one page of an affiliate’s claim history, newest-first by timestampMs. Optional from/to (epoch ms) bound the time window for follow-on pagination. Served by a Scylla referrals.claims partition scan ordered by (timestamp_ms DESC, claim_id ASC).

Query Parameters

​
address
string
required

Affiliate address whose claim history to return. 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>

Start timestampMs filter (epoch ms, inclusive).

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

End timestampMs 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

Response

Claim history newest-first.

​
claims
object[]
required