Affiliate API · v1

Affiliate Data API

Pull the players you referred — their wagers over any date range, plus Steam avatars, names and IDs — to build your own leaderboards and dashboards.

Authentication

Every request must include your personal API key. Generate one in Rewards → Affiliate → Affiliate Data API. Each account has exactly one key; regenerating it immediately invalidates the previous key. Treat it like a password.

x-api-key: rlaf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

You may also pass it as Authorization: Bearer <key>.

Endpoint

GET/api/affiliate/v1/referrals

Query parameters

ParamTypeRequiredDescription
fromISO 8601 date or epoch msNoStart of the wager window (inclusive). Defaults to 30 days ago.
toISO 8601 date or epoch msNoEnd of the wager window (inclusive). Defaults to now.

wagered is summed from each referral's bets within the fromto window (not their lifetime total).

Rate limits

Each key may make one request every 10 minutes. A request sent sooner is rejected and trips a 30-minute lockout. Rate-limited responses return 429 with a Retry-After header and a retryAfterSeconds field.

Example request

curl "https://sellrust.skin/api/affiliate/v1/referrals?from=2026-06-01&to=2026-07-01" \
  -H "x-api-key: rlaf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Example response 200 OK

{
  "range": {
    "from": "2026-06-14T00:00:00.000Z",
    "to":   "2026-07-14T00:00:00.000Z"
  },
  "count": 2,
  "referrals": [
    {
      "userId":  "clx8f2a0b0001",
      "name":    "PlayerOne",
      "avatar":  "https://avatars.steamstatic.com/xxxx_full.jpg",
      "steamId": "76561198000000000",
      "wagered": 1543.20
    },
    {
      "userId":  "clx8f2a0b0002",
      "name":    "PlayerTwo",
      "avatar":  "https://avatars.steamstatic.com/yyyy_full.jpg",
      "steamId": "76561198000000001",
      "wagered": 87.50
    }
  ]
}

Response fields

FieldTypeDescription
range.from / range.tostring (ISO)The resolved date window.
countnumberNumber of referrals returned.
referrals[].userIdstringInternal user id.
referrals[].namestringDisplay name.
referrals[].avatarstringSteam avatar URL.
referrals[].steamIdstring | nullSteam ID (null if not linked).
referrals[].wagerednumberTotal wagered in the window (coins).

Errors

StatusMeaning
401Missing or invalid API key.
429Rate limit exceeded — see retryAfterSeconds.
500Server error — retry later.