Add isolated margin

This endpoint allows users to add margin to an isolated position.

POST /api/v1/positions/add_isolated_margin

The operation type for signing is "add_isolated_margin".

Transfers USDC from free balance into the isolated margin pool for the specified position.

Request Body

Field	Type	Need	Description	Example
"account"	string	required	User's wallet address	42trU9A5...
"signature"	string	required	Cryptographic signature	5J3mBbAH...
"timestamp"	integer	required	Current timestamp in milliseconds	1716200000000
"symbol"	string	required	Trading pair symbol	BTC-PERP
"amount"	string	required	Amount of USDC to add as margin	100.000000
"agent_wallet"	string	optional	Agent wallet address	8zFqj1Kp...
"expiry_window"	integer	optional	Signature expiry in milliseconds	10000

Response

• Status 200: Successfully added isolated margin

{
  "success": true
}

• Status 400: Invalid request parameters

• Status 401: Unauthorized access

• Status 500: Internal server error

Code Example (Python)

import requests

payload = {
    "account": "42trU9A5...",
    "signature": "5J3mBbAH...",
    "timestamp": 1716200000000,
    "symbol": "BTC-PERP",
    "amount": "100.000000",
}

response = requests.post(
    "/api/v1/positions/add_isolated_margin",
    json=payload,
    headers={"Accept": "*/*"},
)

data = response.json()