Get Account Referral

Changed on

Get the authenticated account's invite code, parent referral code, direct referral count, and fee share rate.

get/v1/account/referral

Request

  • Base URL: https://api.perpetuals.polymarket.com
  • URL: https://api.perpetuals.polymarket.com/v1/account/referral
  • Auth: API key in header POLYMARKET-PROXY and API key in header POLYMARKET-SECRET

Response

Account referral response.

codestring required

Referral or invite code

parentstring

Referral or invite code

children_countinteger required

Number of directly referred child accounts

active_children_countinteger required

Number of directly referred child accounts that have traded at least once since their referral was applied

children_volumestring required

Total notional volume traded by directly referred child accounts since their referral was applied

children_feesstring required

Total fees paid by directly referred child accounts since their referral was applied

referrals_leftinteger required

Number of additional referrals remaining for this account's invite code

fee_share_ratestring required

Referral fee share rate. Defaults to 0.2.

Example response

{
  "code": "ABC123",
  "parent": "ABC123",
  "children_count": 12,
  "active_children_count": 8,
  "children_volume": "125000.50",
  "children_fees": "312.75",
  "referrals_left": 11,
  "fee_share_rate": "0.2"
}

Changes

  • 953ba055eaebRevision changes
    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status