{
  "path": "/futures/{settle}/autoorder/v1/chase/list",
  "operation_id": "getChaseOrders",
  "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": "contract",
      "in": "query",
      "schema": {
        "type": "string"
      },
      "description": "Optional. When non-empty, must be a valid contract (validated against the market cache for the path settle); server-side converted to uppercase"
    },
    {
      "name": "is_finished",
      "in": "query",
      "schema": {
        "type": "boolean"
      },
      "description": "true to query finished orders, false to query in-progress orders"
    },
    {
      "name": "start_at",
      "in": "query",
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "description": "Lower time bound for the history list, paired with end_at. Required when is_finished is true"
    },
    {
      "name": "end_at",
      "in": "query",
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "description": "Upper time bound for the history list, paired with start_at. Required when is_finished is true"
    },
    {
      "name": "page_num",
      "in": "query",
      "schema": {
        "type": "integer",
        "format": "uint32",
        "minimum": 1
      },
      "description": "Page number, starting from 1"
    },
    {
      "name": "page_size",
      "in": "query",
      "schema": {
        "type": "integer",
        "format": "uint32",
        "minimum": 1,
        "maximum": 100
      },
      "description": "Page size; must be between 1 and 100"
    },
    {
      "name": "sort_by",
      "in": "query",
      "required": true,
      "schema": {
        "type": "integer",
        "enum": [
          1,
          2
        ]
      },
      "description": "Sort field: 1 ORDER_SORT_CREATED_AT, 2 ORDER_SORT_FINISHED_AT; cannot be 0"
    },
    {
      "name": "hide_cancel",
      "in": "query",
      "schema": {
        "type": "boolean"
      },
      "description": "When true, cancelled orders are hidden in the list"
    },
    {
      "name": "reduce_only",
      "in": "query",
      "schema": {
        "type": "integer",
        "enum": [
          0,
          1,
          2
        ]
      },
      "description": "OptionalBool: 0 unknown, 1 true, 2 false; used to filter by reduce-only flag"
    },
    {
      "name": "side",
      "in": "query",
      "schema": {
        "type": "integer",
        "enum": [
          0,
          1,
          2
        ]
      },
      "description": "Filter by long/short side: 1 long, 2 short"
    }
  ],
  "response_fields": {
    "200": {
      "description": "Success",
      "fields": [
        {
          "path": "$",
          "type": "object",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders",
          "type": "array<object>",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[]",
          "type": "object",
          "description": "Chase order detail or list item",
          "constraints": ""
        },
        {
          "path": "$.orders[].id",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].user",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].contract",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].settle",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].amount",
          "type": "string",
          "description": "Total size in contracts; positive for buy, negative for sell",
          "constraints": ""
        },
        {
          "path": "$.orders[].price_limit",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].reduce_only",
          "type": "boolean",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].text",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].create_time",
          "type": "integer",
          "description": "",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$.orders[].finish_time",
          "type": "integer",
          "description": "",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$.orders[].original_status",
          "type": "integer",
          "description": "Raw status enum",
          "constraints": ""
        },
        {
          "path": "$.orders[].status",
          "type": "string",
          "description": "Simplified status, e.g. open / finished",
          "constraints": ""
        },
        {
          "path": "$.orders[].reason",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].fill_amount",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].average_fill_price",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].suborder_id",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].is_dual_mode",
          "type": "boolean",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].side_label",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].position_side_output",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].chase_price",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].interval_sec",
          "type": "integer",
          "description": "",
          "constraints": "格式：\"uint32\""
        },
        {
          "path": "$.orders[].updated_at",
          "type": "integer",
          "description": "",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$.orders[].suborder_price",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].suborder_ongoing",
          "type": "boolean",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].suborder_finish_as",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].price_type",
          "type": "integer",
          "description": "PriceType enum: 1 latest, 2 index, 3 mark",
          "constraints": ""
        },
        {
          "path": "$.orders[].price_gap_type",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].price_gap_value",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].status_code",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].create_time_precise",
          "type": "string",
          "description": "Creation time (seconds.microseconds)",
          "constraints": ""
        },
        {
          "path": "$.orders[].finish_time_precise",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].pos_margin_mode",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].position_mode",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].leverage",
          "type": "string",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.orders[].error_label",
          "type": "string",
          "description": "",
          "constraints": ""
        }
      ]
    }
  },
  "source_version": "v4.106.132",
  "source_url": "https://github.com/gate/gateapi-python/blob/cd2cac4d339ec0734480787d23c020f467fd7b80/openapi.yaml",
  "local_tool_limits": [
    "仅检查必填、枚举和简单数值范围",
    "复杂类型序列化、条件必填、时间窗口等以官方规则为准",
    "不会发起 API 请求"
  ]
}