On this page

# Update margin mode

This endpoint allows users to switch between isolated and cross margin modes for a specific trading pair. For open positions, users cannot change the margin mode.

    POST /api/v1/account/margin

####
Operation Type (for signing)

Header Field
Type
Content

"type"

string

`"update_margin_mode"`

####
Request Body

Field
Type
Need
Description
Example

`"account"`

string

required

User's wallet address

`42trU9A5...`

`"symbol"`

string

required

Trading pair symbol

`BTC`

`"is_isolated"`

boolean

required

Margin mode (true for isolated, false for cross)

`false`

`"timestamp"`

integer

required

Current timestamp in milliseconds

`1716200000000`

`"expiry_window"`

integer

optional

Signature expiry in milliseconds

`30000`

`"agent_wallet"`

string

optional

Agent wallet address

`69trU9A5...`

`"signature"`

string

required

Cryptographic signature

`5j1Vy9Uq...`

    {
      "account": "42trU9A5...",
      "symbol": "BTC",
      "is_isolated": false,
      "timestamp": 1716200000000,
      "expiry_window": 30000,
      "agent_wallet": "69trU9A5...",
      "signature": "5j1Vy9Uq..."
    }

####
Response

- Status 200: Margin mode updated successfully

     {
        "success": true
      }

- Status 400: Invalid request parameters

      {
        "error": "Invalid margin mode",
        "code": 400
      }

- Status 500: Internal server error

####
Code Example (Python)

    import requests

    payload = {
        "account": "42trU9A5...",
        "signature": "5j1Vy9Uq",
        "timestamp": 1716200000000,
        "symbol": "BTC",
        "is_isolated": false
    }

    response = requests.post(
        "/api/v1/account/margin",
        json=payload,
        headers={"Content-Type": "application/json"}
    )

    data = response.json()

Previous Update leverage
Next Get positions

Last updated 3 months ago