{
  "path": "/futures/{settle}/autoorder/v1/trail/change_log",
  "operation_id": "getTrailOrderChangeLog",
  "auth_required": true,
  "parameters": [
    {
      "name": "settle",
      "in": "path",
      "description": "Perpetual futures settlement currency",
      "required": true,
      "schema": {
        "type": "string",
        "enum": [
          "btc",
          "usdt",
          "usd1"
        ]
      },
      "example": "usdt"
    },
    {
      "name": "id",
      "in": "query",
      "required": true,
      "description": "Order ID",
      "schema": {
        "type": "integer",
        "format": "int64",
        "x-is-bigint": true
      }
    },
    {
      "name": "page_num",
      "in": "query",
      "required": false,
      "description": "Page number, starting from 1",
      "schema": {
        "type": "integer",
        "format": "int32",
        "default": 1
      }
    },
    {
      "name": "page_size",
      "in": "query",
      "required": false,
      "description": "Number of items per page",
      "schema": {
        "type": "integer",
        "format": "int32",
        "default": 20
      }
    }
  ],
  "response_fields": {
    "200": {
      "description": "Query successful",
      "fields": [
        {
          "path": "$",
          "type": "object",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.change_log",
          "type": "array<object>",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.change_log[]",
          "type": "object",
          "description": "Trail order modification records",
          "constraints": ""
        },
        {
          "path": "$.change_log[].updated_at",
          "type": "integer",
          "description": "Update time",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$.change_log[].amount",
          "type": "string",
          "description": "Trading quantity in contracts, positive for buy, negative for sell",
          "constraints": ""
        },
        {
          "path": "$.change_log[].is_gte",
          "type": "boolean",
          "description": "true: activate when market price >= activation price, false: <= activation price",
          "constraints": ""
        },
        {
          "path": "$.change_log[].activation_price",
          "type": "string",
          "description": "Activation price, 0 means trigger immediately",
          "constraints": ""
        },
        {
          "path": "$.change_log[].price_type",
          "type": "integer",
          "description": "Activation price type: 0-unknown, 1-latest price, 2-index price, 3-mark price",
          "constraints": "格式：\"int32\"；枚举：0 / 1 / 2 / 3"
        },
        {
          "path": "$.change_log[].price_offset",
          "type": "string",
          "description": "Callback ratio or price distance, e.g., `0.1` or `0.1%`",
          "constraints": ""
        },
        {
          "path": "$.change_log[].is_create",
          "type": "boolean",
          "description": "true - order creation, false - order modification",
          "constraints": ""
        }
      ]
    }
  },
  "source_version": "v4.106.132",
  "source_url": "https://github.com/gate/gateapi-python/blob/cd2cac4d339ec0734480787d23c020f467fd7b80/openapi.yaml",
  "local_tool_limits": [
    "仅检查必填、枚举和简单数值范围",
    "复杂类型序列化、条件必填、时间窗口等以官方规则为准",
    "不会发起 API 请求"
  ]
}