Skip to main content
GET
/
affiliates
Get affiliate fee totals
curl --request GET \
  --url https://data-api.forka.st/affiliates
[
  {
    "exchange": "0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e",
    "receiver": "0x52a7a01677fb46117adc584fc331bfd54cf685c0",
    "tokenId": "0",
    "totalAmount": "32500000",
    "updatedAt": 1735561201
  }
]
GET https://data-api.forka.st/affiliates returns aggregated fee totals for an address you treat as an affiliate. The response format and filters match GET /referrers; only the meaning of the receiver changes.

​
Filters and pagination

  • address is required and should be the receiver wallet.
  • exchange scopes to a single CTFExchange/NegRisk address (lowercased).
  • tokenId is a decimal string; 0 refers to collateral fees, other values refer to ERC1155 outcome tokens.
  • limit defaults to 100 (max 500); offset defaults to 0.

​
Amount semantics

  • totalAmount is returned as raw base units; divide by 1e6 for UI display.
  • Empty results return [].

Query Parameters

​
address
string
required

Receiver address to aggregate affiliate fees for.

Example:

"0x52a7a01677fb46117adc584fc331bfd54cf685c0"

​
exchange
string

CTFExchange/NegRisk address to scope results to (lowercased).

Example:

"0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e"

​
tokenId
string

Decimal token ID (0 for collateral).

Example:

"0"

​
limit
integer
default:100

Maximum number of rows to return (max 500).

Required range: 0 <= x <= 500
​
offset
integer
default:0

Number of rows to skip.

Required range: x >= 0

Response

Affiliate totals returned.

​
exchange
string

0x-prefixed EVM address (40 hex chars).

Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
receiver
string

0x-prefixed EVM address (40 hex chars).

Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
tokenId
string
​
totalAmount
string
​
updatedAt
integer<int64>