Skip to main content
GET
/
referrers
Get referrer fee totals
curl --request GET \
  --url https://data-api.kuest.com/referrers
[
  {
    "exchange": "0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e",
    "receiver": "0x8e0d7a3d9f66f1e6b7a5c0b0b8b0c3e0f1a2b3c4",
    "tokenId": "0",
    "totalAmount": "184250000",
    "updatedAt": 1735560942,
    "totalVolume": "184250000"
  },
  {
    "exchange": "0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e",
    "receiver": "0x8e0d7a3d9f66f1e6b7a5c0b0b8b0c3e0f1a2b3c4",
    "tokenId": "35298173513404621577479069037847775250424943719108005377003027356519523123136",
    "totalAmount": "7400000",
    "updatedAt": 1735560120,
    "totalVolume": "7400000"
  }
]
GET https://data-api.kuest.com/referrers returns aggregated fee totals (in USDC base units at fee charge time) for an address you treat as a referrer. Results are grouped by exchange, ordered by updatedAt (desc).

​
Filters and pagination

  • address is required and should be the receiver wallet.
  • exchange scopes to a single CTFExchange/NegRisk address (lowercased).
  • tokenId is optional. If provided, totals include only that token’s fees (converted to USDC at charge time). If omitted, totals aggregate all tokens and the response tokenId is 0.
  • limit defaults to 100 (max 500); offset defaults to 0.

​
Amount semantics

  • totalAmount is returned as raw USDC base units at fee charge time; divide by 1e6 for UI display.
  • totalVolume is returned as raw USDC base units for executed trades that generated fees; divide by 1e6 for UI display.
  • Empty results return [].

Query Parameters

​
address
string
required

Receiver address to aggregate referrer fees for.

Example:

"0x8e0d7a3d9f66f1e6b7a5c0b0b8b0c3e0f1a2b3c4"

​
exchange
string

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

Example:

"0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e"

​
tokenId
string

Optional token id to scope results. If provided, totals include only that token’s fees converted to USDC at charge time. If omitted, totals aggregate all tokens and tokenId in the response is 0.

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

Referrer totals returned.

​
exchange
string

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

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
receiver
string

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

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

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