{
  "path": "/futures/{settle}/accounts",
  "operation_id": "listFuturesAccounts",
  "auth_required": true,
  "parameters": [
    {
      "name": "settle",
      "in": "path",
      "description": "Perpetual futures settlement currency",
      "required": true,
      "schema": {
        "type": "string",
        "enum": [
          "btc",
          "usdt",
          "usd1"
        ]
      },
      "example": "usdt"
    }
  ],
  "response_fields": {
    "200": {
      "description": "Query successful",
      "fields": [
        {
          "path": "$",
          "type": "object",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.total",
          "type": "string",
          "description": "Balance, only applicable to classic contract account.The balance is the sum of all historical fund flows, including historical transfers in and out, closing settlements, and transaction fee expenses, but does not include upl of positions.total = SUM(history_dnw, history_pnl, history_fee, history_refr, history_fund)",
          "constraints": ""
        },
        {
          "path": "$.unrealised_pnl",
          "type": "string",
          "description": "Unrealized PNL",
          "constraints": ""
        },
        {
          "path": "$.position_margin",
          "type": "string",
          "description": "Deprecated",
          "constraints": ""
        },
        {
          "path": "$.order_margin",
          "type": "string",
          "description": "initial margin of all open orders",
          "constraints": ""
        },
        {
          "path": "$.available",
          "type": "string",
          "description": "Refers to the available withdrawal or trading amount in per-position, specifically the per-position available balance under the unified account that includes the credit line (which incorporates trial funds; since trial funds cannot be withdrawn, the actual withdrawal amount needs to deduct the trial fund portion when processing withdrawals)",
          "constraints": ""
        },
        {
          "path": "$.point",
          "type": "string",
          "description": "Point card amount",
          "constraints": ""
        },
        {
          "path": "$.currency",
          "type": "string",
          "description": "Settlement currency",
          "constraints": ""
        },
        {
          "path": "$.in_dual_mode",
          "type": "boolean",
          "description": "Whether Hedge Mode is enabled",
          "constraints": ""
        },
        {
          "path": "$.enable_credit",
          "type": "boolean",
          "description": "Whether portfolio margin account mode is enabled",
          "constraints": ""
        },
        {
          "path": "$.position_initial_margin",
          "type": "string",
          "description": "Initial margin occupied by positions, applicable to unified account mode",
          "constraints": ""
        },
        {
          "path": "$.maintenance_margin",
          "type": "string",
          "description": "Maintenance margin occupied by positions, applicable to new classic account margin mode and unified account mode",
          "constraints": ""
        },
        {
          "path": "$.bonus",
          "type": "string",
          "description": "Bonus",
          "constraints": ""
        },
        {
          "path": "$.enable_evolved_classic",
          "type": "boolean",
          "description": "Deprecated",
          "constraints": ""
        },
        {
          "path": "$.cross_order_margin",
          "type": "string",
          "description": "Cross margin order margin, applicable to new classic account margin mode",
          "constraints": ""
        },
        {
          "path": "$.cross_initial_margin",
          "type": "string",
          "description": "Cross margin initial margin, applicable to new classic account margin mode",
          "constraints": ""
        },
        {
          "path": "$.cross_maintenance_margin",
          "type": "string",
          "description": "Cross margin maintenance margin, applicable to new classic account margin mode",
          "constraints": ""
        },
        {
          "path": "$.cross_unrealised_pnl",
          "type": "string",
          "description": "Cross margin unrealized P&L, applicable to new classic account margin mode",
          "constraints": ""
        },
        {
          "path": "$.cross_available",
          "type": "string",
          "description": "Cross margin available balance, applicable to new classic account margin mode",
          "constraints": ""
        },
        {
          "path": "$.cross_margin_balance",
          "type": "string",
          "description": "Cross margin balance, applicable to new classic account margin mode",
          "constraints": ""
        },
        {
          "path": "$.cross_mmr",
          "type": "string",
          "description": "Cross margin maintenance margin rate, applicable to new classic account margin mode",
          "constraints": ""
        },
        {
          "path": "$.cross_imr",
          "type": "string",
          "description": "Cross margin initial margin rate, applicable to new classic account margin mode",
          "constraints": ""
        },
        {
          "path": "$.isolated_position_margin",
          "type": "string",
          "description": "Isolated position margin, applicable to new classic account margin mode",
          "constraints": ""
        },
        {
          "path": "$.enable_new_dual_mode",
          "type": "boolean",
          "description": "Deprecated",
          "constraints": ""
        },
        {
          "path": "$.margin_mode",
          "type": "integer",
          "description": "Margin mode of the account\n0: classic future account or Classic Spot Margin Mode of unified account;\n1:  Multi-Currency Margin Mode;\n2:  Portoforlio Margin Mode;\n3:  Single-Currency Margin Mode",
          "constraints": ""
        },
        {
          "path": "$.enable_tiered_mm",
          "type": "boolean",
          "description": "Whether to enable tiered maintenance margin calculation",
          "constraints": ""
        },
        {
          "path": "$.enable_dual_plus",
          "type": "boolean",
          "description": "Whether to Support Split Position Mode",
          "constraints": ""
        },
        {
          "path": "$.position_mode",
          "type": "string",
          "description": "Position Holding Mode single - Single Direction Position, dual - Dual Direction Position, dual_plus - Split Position",
          "constraints": ""
        },
        {
          "path": "$.history",
          "type": "object",
          "description": "Statistical data",
          "constraints": ""
        },
        {
          "path": "$.history.dnw",
          "type": "string",
          "description": "total amount of deposit and withdraw",
          "constraints": ""
        },
        {
          "path": "$.history.pnl",
          "type": "string",
          "description": "total amount of trading profit and loss",
          "constraints": ""
        },
        {
          "path": "$.history.fee",
          "type": "string",
          "description": "total amount of fee",
          "constraints": ""
        },
        {
          "path": "$.history.refr",
          "type": "string",
          "description": "total amount of referrer rebates",
          "constraints": ""
        },
        {
          "path": "$.history.fund",
          "type": "string",
          "description": "total amount of funding costs",
          "constraints": ""
        },
        {
          "path": "$.history.point_dnw",
          "type": "string",
          "description": "total amount of point deposit and withdraw",
          "constraints": ""
        },
        {
          "path": "$.history.point_fee",
          "type": "string",
          "description": "total amount of point fee",
          "constraints": ""
        },
        {
          "path": "$.history.point_refr",
          "type": "string",
          "description": "total amount of referrer rebates of point fee",
          "constraints": ""
        },
        {
          "path": "$.history.bonus_dnw",
          "type": "string",
          "description": "total amount of perpetual contract bonus transfer",
          "constraints": ""
        },
        {
          "path": "$.history.bonus_offset",
          "type": "string",
          "description": "total amount of perpetual contract bonus deduction",
          "constraints": ""
        },
        {
          "path": "$.history.cross_settle",
          "type": "string",
          "description": "Represents the value of profit settlement from the futures account to the spot account under Unified Account Mode. Negative values indicate settlement from futures to spot, while positive values indicate settlement from spot to futures. This value is cumulative.",
          "constraints": ""
        }
      ]
    }
  },
  "source_version": "v4.106.132",
  "source_url": "https://github.com/gate/gateapi-python/blob/cd2cac4d339ec0734480787d23c020f467fd7b80/openapi.yaml",
  "local_tool_limits": [
    "仅检查必填、枚举和简单数值范围",
    "复杂类型序列化、条件必填、时间窗口等以官方规则为准",
    "不会发起 API 请求"
  ]
}