Skip to main content
GET
/
v1
/
commissionrates
curl
curl https://api.testnet.arcus.xyz/v1/commissionrates
{
  "tiers": [
    {
      "level": 0,
      "name": "Base",
      "t1_rate_bps": 1000
    },
    {
      "level": 1,
      "name": "Bronze",
      "t1_rate_bps": 1000
    },
    {
      "level": 5,
      "name": "VIP",
      "t1_rate_bps": 1500
    }
  ],
  "t2_rate_bps": 300,
  "t3_rate_bps": 200
}
Returns the referral commission rate schedule used by go-attribution to compute affiliate payouts on each fill. T1 (depth 1) varies by the referrer’s tier and is listed per row; T2 (depth 2) and T3 (depth 3) are flat rates that apply regardless of tier. Values are sourced from compile-time constants in the wire package (wire.DefaultReferralTiers, wire.DefaultReferralT2RateBPS, wire.DefaultReferralT3RateBPS) — there is no admin mutation path today, so the response is stable until the next deploy that bumps those constants. Effective T1 paid to a referrer on a given fill is max(t1_rate_bps - referee_discount_bps_at_binding, 0) where the discount is locked at the referee’s registration time. No authentication required.

Response

Commission rate schedule.

Referral commission rate schedule returned by GET /v1/commissionrates. Sourced from wire.DefaultReferralTiers() and wire.DefaultReferralT2RateBPS / wire.DefaultReferralT3RateBPS — compile-time constants shared with go-attribution's payout math.

​
tiers
object[]
required

Per-tier T1 commission rate, sorted ascending by level.

​
t2_rate_bps
integer<int32>
required

Flat T2 commission rate in basis points paid to the referrer of the referrer (depth 2) regardless of tier. Example: 300 = 3%.

​
t3_rate_bps
integer<int32>
required

Flat T3 commission rate in basis points paid to the T2 referrer's referrer (depth 3) regardless of tier. Example: 200 = 2%.