For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get account settings

This endpoint allows users to get account margin and leverage settings (if they are not at default values)

GET /api/v1/account/settings

Query Parameters

Field
Type
Need
Description
Example

"account"

string

required

Account address

42trU9A5...

/api/v1/account/settings?account=42trU9A5...

Response

NOTE: Upon account creation, all markets have margin settings default to cross margin and leverage default to max. When querying this endpoint, all markets with default margin and leverage settings on this account will return blank.

  • Status 200: Successfully retrieved account settings

  {
  "success": true,
  "data": {
    "auto_lend_disabled": null,
    "margin_settings": [
        {
          "symbol": "WLFI",
          "isolated": false,
          "leverage": 5,
          "created_at": 1758085929703,
          "updated_at": 1758086074002
        }
      ],
      "spot_settings": [
        {
          "symbol": "SOL",
          "unified_margin_excluded": false
        }
      ],
      "error": null,
      "code": null
  }
}
Field
Type
Description

"auto_lend_disabled"

boolean or null

Whether automatic lending is disabled for this account. null means default (enabled)

"spot_settings"

array

Per-asset spot settings for unified margin (see below)

"symbol"

string

Trading pair symbol

"isolated"

boolean

If the account is set to isolated margining for this symbol

"leverage"

integer

Current leverage set by the user (default to max)

"created_at"

integer

Timestamp in milliseconds when these settings were adjusted from their default

"updated_at"

integer

Timestamp in milliseconds when these settings were last updated

Spot Settings Fields

Field
Type
Description

"symbol"

string

Spot asset symbol

"unified_margin_excluded"

boolean

If true, this spot asset is excluded from unified margin collateral calculations

  • Status 400: Invalid request parameters

  • Status 401: Unauthorized access

  • Status 500: Internal server error

Code Example (Python)

Last updated