Update spot settings

This endpoint allows users to update spot asset settings for unified margin.

POST /api/v1/account/settings/spot

The operation type for signing is "update_account_spot_settings".

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	Spot asset symbol	SOL
"unified_margin_excluded"	boolean	required	Whether to exclude this asset from unified margin collateral	true
"agent_wallet"	string	optional	Agent wallet address	8zFqj1Kp...
"expiry_window"	integer	optional	Signature expiry in milliseconds	10000

Response

• Status 200: Successfully updated spot settings

{
  "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": "SOL",
    "unified_margin_excluded": True,
}

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

data = response.json()