> For the complete documentation index, see [llms.txt](https://docs.lighter.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lighter.xyz/developers/reference/volume-quota.md).

# Volume Quota

{% hint style="info" %}
**Lighter on Robinhood Chain**

Volume quota works the same way on RH, with its own per-market rates (listed below) and its own payment account for purchases. See [Lighter on Robinhood Chain](https://docs.lighter.xyz/developers/robinhood-chain/overview.md) for everything that differs on RH.
{% endhint %}

**Volume Quota** gives users higher rate limits on `sendTx` and `sendTxBatch` based on trading volume and is **only enforced for Plus and Premium/Advanced accounts**. The only types of transactions that consume volume quota are:

* `L2CreateOrder` (14)
* `L2CancelAllOrders` (16)
* `L2ModifyOrder` (17)
* `L2CreateGroupedOrders` (28)

Other types of transactions have separate rate limits, see [Transaction Type Limits](https://docs.lighter.xyz/developers/reference/rate-limits.md#transaction-type-limits).

For more details on transaction types, see [constants.go](https://github.com/elliottech/lighter-go/blob/main/types/txtypes/constants.go). Grouped orders only consume one quota. Single-order cancels (`L2CancelOrder`, 15) do not consume quota and have no rate limit. If you include `n` transactions in a `sendTxBatch` request, `n` quota will be consumed.

`sendTx` and `sendTxBatch` responses include the remaining quota (`volume_quota_remaining`, e.g. "10780 volume quota remaining."). Every 15 seconds, you get a free `sendTx` which won't consume volume quota (nor show remaining quota). Volume quota is shared across all sub-accounts under the same L1 address.

This differs from Rate Limits, which enforce a maximum of **72,000** transactions per minute for Premium/Advanced accounts on Lighter (**24,000** on Robinhood Chain). You can check the weight of the endpoints, and standard accounts limits here: [Rate Limits](https://docs.lighter.xyz/developers/reference/rate-limits.md).

## Earning quota by trading

Every fill adds `fill notional in USD / USD per quota` to the quota of the L1 address, where **USD per quota is set per market**:

* The default is **2 USD per quota** (1 quota per $2 traded).
* Most markets currently earn **1 quota per $1** traded, including the USDC spot markets. BTC, ETH and SOL, the largest US stock markets (NVDA, TSLA, AAPL, AMZN, MSFT, GOOGL, META), index, commodity and most FX markets (SPY, QQQ, US500, XAU, XAG, WTI, …) and a number of smaller perps stay at the $2 default.

### Markets earning at 1 USD per quota

Snapshot of the operator configuration as of 2026-11-02. Every market not listed earns at the default of 2 USD per quota. Market ids differ between Lighter and Robinhood Chain; each list uses its own venue's ids, and both lists include spot markets.

**Lighter mainnet** (160 markets)

| Market (id)        | Market (id)        | Market (id)         | Market (id)         |
| ------------------ | ------------------ | ------------------- | ------------------- |
| 0G (`84`)          | 1000BONK (`18`)    | 1000FLOKI (`19`)    | 1000NOT (`172`)     |
| 1000PEPE (`4`)     | 1000SHIB (`17`)    | 2Z (`88`)           | AAVE (`27`)         |
| AAVE/USDC (`2052`) | ADA (`39`)         | AERO (`65`)         | AI (`232`)          |
| AMD (`138`)        | ANSEM (`219`)      | APEX (`86`)         | APT (`31`)          |
| ARB (`50`)         | ARC (`132`)        | ASML (`151`)        | ASTER (`83`)        |
| AUDUSD (`106`)     | AVAX (`9`)         | AVNT (`82`)         | AXS (`131`)         |
| AZTEC (`144`)      | BABA (`177`)       | BCH (`58`)          | BERA (`20`)         |
| BIO (`171`)        | BMNR (`123`)       | BOT (`185`)         | CAP (`212`)         |
| CBRS (`175`)       | CC (`101`)         | CHIP (`163`)        | COIN (`109`)        |
| CRCL (`121`)       | CRO (`73`)         | CRV (`36`)          | CRWV (`167`)        |
| CTR (`183`)        | CXMT (`217`)       | DASH (`127`)        | DATA (`34`)         |
| DELL (`187`)       | DOGE (`3`)         | DOT (`11`)          | DRAM (`195`)        |
| DYDX (`62`)        | EDGE (`157`)       | EIGEN (`49`)        | ETH/USDC (`2048`)   |
| ETHFI (`64`)       | EURUSD (`96`)      | EWY (`166`)         | FARTCOIN (`21`)     |
| FF (`87`)          | FIL (`103`)        | FOLKS (`215`)       | GBPUSD (`97`)       |
| GEV (`218`)        | GMX (`61`)         | GRASS (`52`)        | H100 (`182`)        |
| HBAR (`59`)        | HOOD (`108`)       | HYUNDAIUSD (`160`)  | ICP (`102`)         |
| INTC (`137`)       | IWM (`153`)        | JTO (`134`)         | JUP (`26`)          |
| KAITO (`33`)       | LDO (`46`)         | LDO/USDC (`2054`)   | LINEA (`76`)        |
| LINK (`8`)         | LINK/USDC (`2050`) | LITE (`178`)        | MEGA (`94`)         |
| MET (`95`)         | MINIMAX (`199`)    | MNT (`63`)          | MON (`91`)          |
| MORPHO (`68`)      | MRVL (`174`)       | MSTR (`122`)        | NBIS (`189`)        |
| NMR (`74`)         | NOW (`191`)        | NZDUSD (`107`)      | ONDO (`38`)         |
| OP (`55`)          | OPENAI (`192`)     | ORCL (`165`)        | PAXG (`48`)         |
| PENDLE (`37`)      | PENGU (`47`)       | PLTR (`111`)        | POL (`14`)          |
| PONS (`231`)       | POPCAT (`23`)      | PROVE (`57`)        | PYTH (`78`)         |
| QNT (`190`)        | RAIL (`184`)       | RAY (`233`)         | RIVER (`126`)       |
| RKLB (`186`)       | ROBO (`149`)       | S (`40`)            | SAMSUNGUSD (`162`)  |
| SEI (`32`)         | SHEIN (`230`)      | SKHY (`216`)        | SKR (`130`)         |
| SKY (`79`)         | SKY/USDC (`2053`)  | SMIC (`202`)        | SOXL (`197`)        |
| SPX (`42`)         | STABLE (`118`)     | STBL (`85`)         | STRK (`104`)        |
| SUI (`16`)         | SYRUP (`44`)       | TAO (`13`)          | TENCENT (`201`)     |
| TIA (`67`)         | TRUMP (`15`)       | TRX (`43`)          | TSM (`168`)         |
| TTWO (`179`)       | UNI (`30`)         | UNI/USDC (`2051`)   | UNITREE (`220`)     |
| US10Y (`227`)      | USDCAD (`100`)     | USDCHF (`99`)       | USDKRW (`105`)      |
| USELESS (`66`)     | VIRTUAL (`41`)     | VVV (`69`)          | WEN (`214`)         |
| WIF (`5`)          | WLD (`6`)          | XAUT/USDC (`2056`)  | XCU (`136`)         |
| XIAOMI (`203`)     | XLM (`119`)        | XMR (`77`)          | XPD (`146`)         |
| XPL (`71`)         | XPT (`147`)        | XRP (`7`)           | ZHIPU (`205`)       |
| ZK (`56`)          | ZORA (`53`)        | rhQQQ/USDC (`2058`) | rhSPY/USDC (`2057`) |

**Lighter on Robinhood Chain mainnet** (49 markets)

| Market (id)        | Market (id)        | Market (id)         | Market (id)        |
| ------------------ | ------------------ | ------------------- | ------------------ |
| AI (`45`)          | AMC (`56`)         | AMD/USDG (`2068`)   | AMZN/USDG (`2050`) |
| ANSEM (`39`)       | ASTS (`47`)        | BE (`20`)           | BE/USDG (`2059`)   |
| CASHCAT (`36`)     | CLSK (`48`)        | COIN (`23`)         | CRWV (`33`)        |
| CRWV/USDG (`2072`) | ETH/USDG (`2048`)  | GOOGL/USDG (`2051`) | INTC (`30`)        |
| INTC/USDG (`2069`) | IREN (`49`)        | LIT (`5`)           | LUNR (`50`)        |
| MU/USDG (`2070`)   | NEAR (`7`)         | NVDA/USDG (`2054`)  | ORCL (`17`)        |
| ORCL/USDG (`2056`) | PLTR (`34`)        | PONS (`44`)         | PONS/USDG (`2074`) |
| QBTS (`51`)        | QQQ/USDG (`2064`)  | RGTI (`52`)         | SHEIN (`43`)       |
| SLV/USDG (`2067`)  | SMCI (`53`)        | SNDK/USDG (`2071`)  | SOFI (`54`)        |
| SOXL (`35`)        | SPCX/USDG (`2057`) | SPY/USDG (`2065`)   | SUI (`9`)          |
| TSLA/USDG (`2055`) | TSM (`46`)         | USAR (`21`)         | USAR/USDG (`2060`) |
| USELESS (`57`)     | VVV (`8`)          | WULF (`55`)         | XRP (`6`)          |
| ZEC (`4`)          |                    |                     |                    |

New accounts start at 1,000 quota, and quota does not expire.

Switching from Standard to Plus or Premium/Advanced resets the volume quota for your L1 address to 1,000. Quota accumulated while on Standard does not carry over.

## Caps

| Cap                         | Value      | Meaning                                                                                                                                            |
| --------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `volume_quota_cap`          | 15,000,000 | Trading alone refills your balance up to this value.                                                                                               |
| `volume_quota_purchase_cap` | 30,000,000 | Highest balance you can reach by buying quota. A purchase that would end above it is rejected (error `69005` names the maximum you can still buy). |

While your balance is above 15,000,000 (after a purchase), trading keeps refilling it up to 30,000,000. Quota is consumed normally at any level; nothing is clamped back down.

Check your balance and caps with [`accountLimits`](https://docs.lighter.xyz/api/account): `volume_quota_remaining`, `volume_quota_cap` and `volume_quota_purchase_cap` (strings, whole quota, for the L1 address of the queried account).

## Buying volume quota

Plus and Premium/Advanced accounts can buy volume quota with USDC on Lighter mainnet or USDG on Robinhood Chain mainnet through `POST /api/v1/buyVolumeQuota`. This endpoint is not available on testnet.

**Price:** 500 base units of the payment asset (0.0005 USDC on Lighter / 0.0005 USDG on Robinhood Chain) per quota, i.e. **1,000,000 quota = 500 USDC on Lighter / 500 USDG on Robinhood Chain**. A single request can buy at most 15,000,000 quota, and the balance after the purchase must not exceed 30,000,000.

**Payment:** the payment is an `L2Transfer` (tx type 12) that you sign and pass as `tx_info`, exactly like a transfer sent to `sendTx`:

| Field            | Value                                                                         |
| ---------------- | ----------------------------------------------------------------------------- |
| Asset            | USDC on Lighter / USDG on Robinhood Chain (asset index 3)                     |
| To account index | `765210` on Lighter, `51687` on Lighter on Robinhood Chain                    |
| Amount           | exactly `quota × 500` base units of USDC on Lighter / USDG on Robinhood Chain |
| From account     | the account whose `auth` you send; its L1 address receives the quota          |

The transfer must be at least the minimum transfer amount of the payment asset (USDC on Lighter / USDG on Robinhood Chain) (error `69007` names the minimum quota). The server validates every condition (eligibility, caps, amount, destination) before the transfer is sent, so a rejected request costs nothing.

{% hint style="warning" %}
**Using lighter-python**

Use `client.sign_transfer()` to obtain the signed `tx_info`, then pass it to `buyVolumeQuota`. Do not use `client.transfer()`: it submits the transfer through `sendTx`, moving the payment asset without purchasing quota.
{% endhint %}

**Request parameters** (query string or form body):

Use `tx_info` with `quota` to make a new purchase. To claim a purchase that returned `pending`, send `tx_hash` without `tx_info`; `quota` is ignored for that claim. If both `tx_info` and `tx_hash` are sent, `tx_info` is used and `tx_hash` is ignored.

| Parameter                | Required       | Description                                                                                                                                                                                                                       |
| ------------------------ | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `quota`                  | with `tx_info` | Quota to buy, as a whole number. Required for a new purchase; ignored when claiming with `tx_hash` without `tx_info`.                                                                                                             |
| `tx_info`                | new purchase   | Signed `L2Transfer` JSON as described above. This is the normal way to buy; the server submits the transfer for you, so do not send it to `sendTx` yourself.                                                                      |
| `tx_hash`                | claim only     | **Optional, not needed for a normal purchase.** Only used to finish a purchase whose first call answered `status: pending` (the transfer took longer than \~5 s to execute): the hash from that response. No new payment is made. |
| `destination_l1_address` | no             | Credit another L1 address instead of your own. It must belong to a Plus or Premium/Advanced account.                                                                                                                              |
| `auth`                   | yes            | Auth token of the paying account (or send it in the `Authorization` header).                                                                                                                                                      |

**Flow:**

1. Call `buyVolumeQuota` with `quota`, `tx_info` and `auth`. The server sends the transfer and waits up to about 5 seconds for it to execute.
2. If it executes, the response is `status: credited`, with the `quota` added and the new `volume_quota_remaining` of the credited L1 address.
3. If it has not executed yet, the response is `status: pending` with the transfer's `tx_hash` and nothing has been credited. Call `buyVolumeQuota` again with `tx_hash` (with `auth`, no `tx_info`; `quota` is ignored) once the transfer is executed to receive the quota. A claim before execution returns `69009`; a failed transfer returns `69008` and charges nothing.

Each transfer is credited exactly once (`69010` on a repeated claim). `tx_hash` and `l1_address` are always returned so a client can reconcile purchases.

```json
{
  "code": 200,
  "tx_hash": "0x…",
  "l1_address": "0x…",
  "quota": 1000000,
  "volume_quota_remaining": 1010780,
  "status": "credited"
}
```

**Errors** (`code` in the response body):

| Code    | Meaning                                                                                         |
| ------- | ----------------------------------------------------------------------------------------------- |
| `21501` | Malformed `tx_info` (`invalid tx info`).                                                        |
| `69001` | Buying volume quota is not enabled on this environment.                                         |
| `69002` | `quota` is not a positive whole number (or above the per-request maximum).                      |
| `69003` | Transfer amount is not `quota × price`.                                                         |
| `69004` | `destination_l1_address` is not a known L1 address.                                             |
| `69005` | Purchase would exceed 30,000,000; the message names the maximum you can buy.                    |
| `69006` | The credited address is not a Plus or Premium/Advanced account, so quota would not apply to it. |
| `69007` | Purchase is below the minimum transfer amount of USDC on Lighter / USDG on Robinhood Chain.     |
| `69008` | Payment transfer failed; nothing was charged or credited.                                       |
| `69009` | Payment transfer is not executed yet; retry with `tx_hash`.                                     |
| `69010` | This transfer was already credited.                                                             |
| `69011` | No purchase recorded for `tx_hash`.                                                             |

Malformed `tx_info` returns `21501` (`invalid tx info`). Other validation errors (wrong payment account, incorrect payment asset, `tx_info` that is not an `L2Transfer`, auth that does not belong to the paying account) return `20001` / `20013` with an explanatory message.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.lighter.xyz/developers/reference/volume-quota.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
