private/get_leverage
Retrieves the current user-configured custom leverage and effective maximum leverage for a specified active future instrument.
When instrument_name is supplied, returns a single leverage details object. When omitted, returns leverage details only for futures with a stored custom leverage override; instruments using the default maximum leverage are omitted. For isolated=true, regular subaccounts receive an empty object or array because isolated leverage configuration is visible only to the main account.
Authorizations
Call public/auth with grant_type: coinbase_cdp and a CDP JWT. Send the returned access_token as Authorization: Bearer.
Query Parameters
Instrument name Unique instrument identifier
"BTC-PERPETUAL"
The user id for the subaccount. Available to retail-broker callers; defaults to the authenticated account.
If true, returns leverage settings for isolated margin mode (main accounts only).
Response
Success response
The JSON-RPC version (2.0)
2.0 Leverage details for one requested future, a list of futures with stored custom leverage overrides, or an empty object/list when isolated settings are hidden from a regular subaccount.
- Option 1 · object
- Option 2 · object[]
- Option 3 · object
The id that was sent in the request