> 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/api/account/buyvolumequota.md).

# buyVolumeQuota

Buy volume quota with USDC. Submit a signed L2Transfer of quota × 500 USDC base units to the volume quota payment account; the server validates it, sends it and credits the quota to the payer's L1 address (or destination\_l1\_address) once the transfer executes. If execution takes longer than about 5 seconds the response is status=pending and the purchase is claimed by calling again with tx\_hash. Exactly one of tx\_info (new purchase) or tx\_hash (claim) is sent per call. Each transfer is credited once. Only Plus and Premium/Advanced accounts can receive quota, and the balance after the purchase may not exceed 30,000,000. See [Volume Quota](https://docs.lighter.xyz/developers/reference/volume-quota#buying-volume-quota).

```json
{"openapi":"3.0.0","info":{"title":"Lighter API","version":"1.0.0"},"tags":[{"name":"account"}],"servers":[{"url":"https://mainnet.zklighter.elliot.ai","description":"Lighter mainnet"},{"url":"https://api.testnet.lighter.xyz","description":"Lighter testnet"},{"url":"https://api.rh.lighter.xyz","description":"Lighter on Robinhood Chain mainnet"},{"url":"https://api.rh-testnet.lighter.xyz","description":"Lighter on Robinhood Chain testnet"}],"paths":{"/api/v1/buyVolumeQuota":{"post":{"summary":"buyVolumeQuota","operationId":"buyVolumeQuota","tags":["account"],"description":"Buy volume quota with USDC. Submit a signed L2Transfer of quota × 500 USDC base units to the volume quota payment account; the server validates it, sends it and credits the quota to the payer's L1 address (or destination_l1_address) once the transfer executes. If execution takes longer than about 5 seconds the response is status=pending and the purchase is claimed by calling again with tx_hash. Exactly one of tx_info (new purchase) or tx_hash (claim) is sent per call. Each transfer is credited once. Only Plus and Premium/Advanced accounts can receive quota, and the balance after the purchase may not exceed 30,000,000. See [Volume Quota](https://docs.lighter.xyz/developers/reference/volume-quota#buying-volume-quota).","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"type":"string"},"description":"Auth token in the Authorization header (or pass auth in the body)."}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/ReqBuyVolumeQuota"}}}},"responses":{"200":{"description":"A successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespBuyVolumeQuota"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultCode"}}}}}}}},"components":{"schemas":{"ReqBuyVolumeQuota":{"type":"object","properties":{"quota":{"type":"integer","format":"int64","description":"Volume quota to buy, in transactions. Price is quota × 500 USDC base units (1,000,000 quota = 500 USDC); at most 15,000,000 per request."},"tx_info":{"type":"string","description":"Required for a new purchase (omit when claiming with tx_hash). Signed L2Transfer (tx type 12) of USDC (asset index 3), exactly quota × 500 USDC base units from the paying account to the volume quota payment account (index 765210 on Lighter, 51687 on Lighter on Robinhood Chain), as sent to sendTx. Omit when claiming a pending purchase with tx_hash."},"tx_hash":{"type":"string","description":"Optional; claim only, not needed for a normal purchase. Pass instead of tx_info to finish a purchase whose earlier call answered status=pending: the tx_hash from that response. No new payment is made. Credits that purchase once its transfer has executed; the payer must authenticate."},"destination_l1_address":{"type":"string","description":"Credit this L1 address instead of the payer's own. Must be a Plus or Premium/Advanced account's L1 address."},"auth":{"type":"string","description":"Auth token of the paying account (alternatively the Authorization header)."}},"required":["quota"],"title":"ReqBuyVolumeQuota"},"RespBuyVolumeQuota":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"tx_hash":{"type":"string","description":"Hash of the USDC payment transfer; use it with tx_hash to claim a pending purchase."},"l1_address":{"type":"string","description":"L1 address the quota is (or will be) credited to."},"quota":{"type":"integer","format":"int64","description":"Quota credited (status=credited) or to be credited (status=pending)."},"volume_quota_remaining":{"type":"integer","format":"int64","description":"Balance of the credited L1 address after the purchase. Omitted while pending."},"status":{"type":"string","enum":["credited","pending"],"description":"credited: quota added. pending: the transfer has not executed within the wait; call again with tx_hash."}},"required":["code","tx_hash","l1_address","quota","status"],"title":"RespBuyVolumeQuota"},"ResultCode":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}},"title":"ResultCode","required":["code"]}}}}
```


---

# 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/api/account/buyvolumequota.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.
