{
  "path": "/spot/my_trades",
  "operation_id": "listMyTrades",
  "auth_required": true,
  "parameters": [
    {
      "name": "currency_pair",
      "in": "query",
      "description": "Retrieve results with specified currency pair",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "BTC_USDT"
    },
    {
      "name": "limit",
      "in": "query",
      "description": "Maximum number of items returned in list. Default: 100, minimum: 1, maximum: 1000",
      "required": false,
      "example": 10,
      "schema": {
        "type": "integer",
        "default": 100,
        "minimum": 1,
        "maximum": 1000
      }
    },
    {
      "name": "page",
      "in": "query",
      "description": "Page number",
      "required": false,
      "schema": {
        "type": "integer",
        "format": "int32",
        "default": 1,
        "minimum": 1
      },
      "example": 1
    },
    {
      "name": "order_id",
      "in": "query",
      "description": "Filter trades with specified order ID. `currency_pair` is also required if this field is present",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "12345"
    },
    {
      "name": "account",
      "in": "query",
      "description": "The accountparameter has been deprecated. The interface supports querying all transaction records of the account.",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "spot"
    },
    {
      "name": "from",
      "in": "query",
      "required": false,
      "description": "Start timestamp for the query",
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "example": 1627706330
    },
    {
      "name": "to",
      "in": "query",
      "required": false,
      "description": "End timestamp for the query, defaults to current time if not specified",
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "example": 1635329650
    }
  ],
  "response_fields": {
    "200": {
      "description": "List retrieved successfully",
      "fields": [
        {
          "path": "$",
          "type": "array<object>",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$[]",
          "type": "object",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$[].id",
          "type": "string",
          "description": "Fill ID",
          "constraints": ""
        },
        {
          "path": "$[].create_time",
          "type": "string",
          "description": "Fill Time",
          "constraints": ""
        },
        {
          "path": "$[].create_time_ms",
          "type": "string",
          "description": "Trading time, with millisecond precision",
          "constraints": ""
        },
        {
          "path": "$[].currency_pair",
          "type": "string",
          "description": "Currency pair",
          "constraints": ""
        },
        {
          "path": "$[].side",
          "type": "string",
          "description": "Buy or sell order",
          "constraints": "枚举：buy / sell"
        },
        {
          "path": "$[].role",
          "type": "string",
          "description": "Trade role, not returned in public endpoints",
          "constraints": "枚举：taker / maker"
        },
        {
          "path": "$[].amount",
          "type": "string",
          "description": "Trade amount",
          "constraints": ""
        },
        {
          "path": "$[].price",
          "type": "string",
          "description": "Order price",
          "constraints": ""
        },
        {
          "path": "$[].order_id",
          "type": "string",
          "description": "Related order ID, not returned in public endpoints",
          "constraints": ""
        },
        {
          "path": "$[].fee",
          "type": "string",
          "description": "Fee deducted, not returned in public endpoints",
          "constraints": ""
        },
        {
          "path": "$[].fee_currency",
          "type": "string",
          "description": "Fee currency unit, not returned in public endpoints",
          "constraints": ""
        },
        {
          "path": "$[].point_fee",
          "type": "string",
          "description": "Points used to deduct fee, not returned in public endpoints",
          "constraints": ""
        },
        {
          "path": "$[].gt_fee",
          "type": "string",
          "description": "GT used to deduct fee, not returned in public endpoints",
          "constraints": ""
        },
        {
          "path": "$[].amend_text",
          "type": "string",
          "description": "The custom data that the user remarked when amending the order",
          "constraints": ""
        },
        {
          "path": "$[].sequence_id",
          "type": "string",
          "description": "Consecutive trade ID within a single market.\nUsed to track and identify trades in the specific market",
          "constraints": ""
        },
        {
          "path": "$[].text",
          "type": "string",
          "description": "Order's Custom Information. This field is not returned by public interfaces.\nThe scenarios pm_liquidate, comb_margin_liquidate, and scm_liquidate represent full-account forced liquidation orders.\nliquidate represents isolated-account forced liquidation orders.",
          "constraints": ""
        },
        {
          "path": "$[].deal",
          "type": "string",
          "description": "Total Executed Value",
          "constraints": ""
        },
        {
          "path": "$[].trade_quote",
          "type": "string",
          "description": "Actual quote currency used for the trade",
          "constraints": ""
        }
      ]
    }
  },
  "source_version": "v4.106.132",
  "source_url": "https://github.com/gate/gateapi-python/blob/cd2cac4d339ec0734480787d23c020f467fd7b80/openapi.yaml",
  "local_tool_limits": [
    "仅检查必填、枚举和简单数值范围",
    "复杂类型序列化、条件必填、时间窗口等以官方规则为准",
    "不会发起 API 请求"
  ]
}