Get Fee Rate (WebSocket)

Retrieve the authenticated wallet's current fee tier, 14-day trading volume, wallet-effective maker/taker rates, and the complete public fee schedule through the trade WebSocket.

Endpoint

ws.send() wss://api.synthetix.io/v1/ws/trade

Request

Request Format

{
  "id": "feerate-1",
  "method": "post",
  "params": {
    "action": "getFeeRate",
    "subAccountId": "1867542890123456789",
    "expiresAfter": 1704153600,
    "signature": {
      "v": 28,
      "r": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "s": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    }
  }
}

Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Client-generated request identifier
`method`	string	Yes	Must be `"post"`
`params.action`	string	Yes	Must be `"getFeeRate"`
`params.subAccountId`	string	Yes	Subaccount identifier
`params.expiresAfter`	integer	No	Optional expiration timestamp in seconds
`params.signature`	object	Yes	EIP-712 signature using `SubAccountAction`

Response Format

Success Response

{
  "id": "feerate-1",
  "requestId": "feerate-1",
  "status": 200,
  "timestamp": 1735689900000,
  "result": {
    "status": "success",
    "response": {
      "volume14d": "5500000.00",
      "currentTier": {
        "tierId": "tier_2",
        "tierLevel": 2,
        "tierName": "Tier 2",
        "tierType": "volume",
        "minTradeVolume": "5000000",
        "makerFeeRate": "0.00016",
        "takerFeeRate": "0.0004"
      },
      "makerFeeRate": "0.000144",
      "takerFeeRate": "0.00036",
      "referralDiscountApplied": true,
      "referralDiscount": "0.9",
      "tiers": [
        {
          "tierId": "tier_0",
          "tierLevel": 0,
          "tierName": "Regular User",
          "minTradeVolume": "0",
          "makerFeeRate": "0.0002",
          "takerFeeRate": "0.0005"
        }
      ]
    }
  }
}

Response Fields

See Get Fee Rate (REST) for the full field reference. The result.response object matches the REST response object.

Implementation Notes

Uses SubAccountAction EIP-712 signing with action: "getFeeRate"
REST equivalent: Get Fee Rate

Error Code	Description	Retryable
`UNAUTHORIZED`	EIP-712 signature validation failed	No
`VALIDATION_ERROR`	Request validation failed	No
`MISSING_REQUIRED_FIELD`	Required field is missing	No
`INVALID_FORMAT`	Field format is invalid	No
`INVALID_VALUE`	Invalid parameter value	No
`RATE_LIMIT_EXCEEDED`	Too many requests in time window	Yes
`INSUFFICIENT_MARGIN`	Not enough margin for trade	No
`ORDER_NOT_FOUND`	Order does not exist	No
`OPERATION_TIMEOUT`	Operation timed out	Yes