> ## Documentation Index
> Fetch the complete documentation index at: https://orderly.network/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fee rate

> Fee tier, maker / taker rates, and 30-day rolling volume. Three response shapes based on params.

Fee tier and rates plus 30-day rolling volume.

Response shape depends on params:

* `address` + `account_id` → **flat object**, one account
* `address` + `broker_id` (no `account_id`) → `sub_accounts[]`
* `address` only → `accounts[]`

**Weight:** `1`

## Request

```json theme={null}
{
  "type": "feeRate",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "broker_id": "orderly",
  "account_id": "0xabc..."
}
```

| Field        | Type   | Required | Default | Notes                           |
| ------------ | ------ | -------- | ------- | ------------------------------- |
| `address`    | string | Yes      | —       | Wallet address                  |
| `broker_id`  | string | No       | —       | Triggers `sub_accounts[]` shape |
| `account_id` | string | No       | —       | Triggers flat-object shape      |

## Response

| Field                              | Type           | Notes                                                              |
| ---------------------------------- | -------------- | ------------------------------------------------------------------ |
| `tier`                             | string \| null | `PUBLIC` / `SILVER` / `GOLD` / `PLATINUM` / `DIAMOND`              |
| `futures_tier`                     | string \| null | Same value as `tier`                                               |
| `maker_fee_rate`, `taker_fee_rate` | string \| null | Decimal (`bps / 10000`)                                            |
| `30d_volume`                       | string         | Sum of executed perp notional over the last 30 days; `"0"` if none |

## Notes

* 60s cache keyed by `(address, broker_id, account_id)`
* Throws `ADDRESS_NOT_FOUND` (404) if no accounts match

<ResponseExample>
  ```json With account_id (flat) theme={null}
  {
    "success": true,
    "data": {
      "tier": "PLATINUM",
      "futures_tier": "PLATINUM",
      "maker_fee_rate": "0.0001",
      "taker_fee_rate": "0.0005",
      "30d_volume": "250000"
    },
    "ts": 1779269143700
  }
  ```

  ```json With broker_id (sub_accounts) theme={null}
  {
    "success": true,
    "data": {
      "sub_accounts": [
        {
          "broker_id": "orderly",
          "account_id": "0xabc...",
          "account_type": "main",
          "tier": "PLATINUM",
          "futures_tier": "PLATINUM",
          "maker_fee_rate": "0.0001",
          "taker_fee_rate": "0.0005",
          "30d_volume": "250000"
        }
      ]
    },
    "ts": 1779269143700
  }
  ```

  ```json Address only (accounts) theme={null}
  {
    "success": true,
    "data": {
      "accounts": [
        {
          "broker_id": "orderly",
          "account_id": "0xabc...",
          "account_type": "main",
          "tier": "PLATINUM",
          "futures_tier": "PLATINUM",
          "maker_fee_rate": "0.0001",
          "taker_fee_rate": "0.0005",
          "30d_volume": "250000"
        }
      ]
    },
    "ts": 1779269143700
  }
  ```
</ResponseExample>