Update Leverage for Multiple Instruments
Changed onUpdate leverage for up to 100 unique instruments. Updates are processed sequentially and are not atomic. If only some responses arrive before the gateway deadline, missing item results use internal_error; whether those updates applied is unknown. If no responses arrive, the request returns 503 — retryable, since each update is an idempotent leverage/margin-type set that converges to the same value whether or not the original attempt was admitted.
Each setting resolves independently: explicit per-instrument setting, then exchange-managed account-group default, then instrument maximum leverage and isolated margin. Group leverage is capped at the instrument maximum; a group cross default resolves to isolated on isolated-only instruments. Group defaults apply to new listings and never overwrite explicit settings. This operation sets both settings explicitly; GET /v1/account/config reports resolved values. Submit the current resolved pair to preserve it against later group changes. Leverage bounds and BLP locks also apply to unchanged values. Set your preferred leverage and margin mode after listing and before placing your first order. An unknown instrument ID (never listed) is rejected with instrument_not_found; a disabled instrument is not rejected merely because it is disabled.
Margin mode can change only when the account has no position and no open orders in that instrument, including orders awaiting risk approval or execution. Close the position and cancel all orders before switching between isolated and cross margin. A position blocks a mode change with position_exists; open orders block it with open_orders_exist. Leverage changes within the same mode remain subject to leverage limits and margin checks. Leverage must be positive (lev: 0 returns 400); exceeding the instrument maximum returns invalid_leverage. BLP-subscribed instruments reject leverage or mode updates with blp_leverage_locked; unsubscribe before changing the configuration.
Requires proxy signature, see Update Leverage.
Request
- Base URL: https://api.perpetuals.polymarket.com
- URL: https://api.perpetuals.polymarket.com/v1/trade/leverage/batch
- Auth: none required
Request body
Example request
{
"op": {
"args": [
{
"iid": 1,
"lev": 10
}
]
},
"sig": "0x1234567890...",
"salt": 1234567890,
"ts": 1767225600000
}Response
Ordered result for each requested instrument.
Example response
[
{
"instrument_id": 1,
"leverage": 10
}
]Changes
- info
added the non-success response with the status
- info
- info
endpoint added
- info