Skip to main content
GET
/
v1
/
affiliate
/
claimStatus
Look up a single claim
curl --request GET \
  --url https://api.testnet.arcus.xyz/v1/affiliate/claimStatus
{
  "affiliate": "<string>",
  "timestampUs": 123,
  "claimId": "<string>",
  "cutoffFillId": 123,
  "amountQuantums": 123
}

Query Parameters

​
address
string
required

Affiliate address that submitted the claim. 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}$
​
id
string
required

Claim identifier (matches the on-chain transferId).

Minimum string length: 1

Response

The claim row.

​
affiliate
string
required

Lower-case 0x-prefixed 20-byte affiliate address.

​
timestampUs
integer<int64>
required

Wall-clock microsecond timestamp the claim was processed.

​
claimId
string
required

Opaque identifier of the claim (matches on-chain transferId).

​
cutoffFillId
integer<int64>
required

Opaque monotonic referral cutoff recorded with the claim. For claims submitted through POST /v1/affiliate/claim, this is server-computed from the latest referral event state and is used only for idempotency/stale-claim detection; clients should not interpret it as a selectable fill-id range.

​
amountQuantums
integer<int64>
required

Total claim amount in quote quantums (1e9 = $1).