{
  "path": "/spot/pov_orders",
  "operation_id": "listSpotPovOrders",
  "auth_required": true,
  "parameters": [
    {
      "name": "currency_pair",
      "in": "query",
      "description": "Currency pair",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "BTC_USDT"
    },
    {
      "name": "status",
      "in": "query",
      "required": true,
      "description": "Order status. Defaults to open\n\n- open: Active orders\n- finished: Finished orders",
      "schema": {
        "type": "string",
        "default": "open"
      }
    },
    {
      "name": "side",
      "in": "query",
      "description": "Specify all bids or all asks, both included if not specified",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "sell"
    },
    {
      "name": "page",
      "in": "query",
      "description": "Page number, up to 100",
      "required": false,
      "schema": {
        "type": "integer",
        "format": "int32",
        "default": 1,
        "minimum": 1,
        "maximum": 100
      },
      "example": 1
    },
    {
      "name": "limit",
      "in": "query",
      "description": "Maximum number of records returned in a single list",
      "required": false,
      "schema": {
        "type": "integer",
        "default": 100,
        "minimum": 1,
        "maximum": 1000
      },
      "example": 100
    }
  ],
  "response_fields": {
    "200": {
      "description": "Query successful",
      "fields": [
        {
          "path": "$",
          "type": "array<object>",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$[]",
          "type": "object",
          "description": "Spot POV order details",
          "constraints": ""
        },
        {
          "path": "$[].id",
          "type": "string",
          "description": "Order ID",
          "constraints": ""
        },
        {
          "path": "$[].currency_pair",
          "type": "string",
          "description": "Currency pair",
          "constraints": ""
        },
        {
          "path": "$[].side",
          "type": "string",
          "description": "Buy or sell order",
          "constraints": ""
        },
        {
          "path": "$[].amount",
          "type": "string",
          "description": "Trade amount",
          "constraints": ""
        },
        {
          "path": "$[].participation_rate",
          "type": "integer",
          "description": "Target participation rate as a percentage. Allowed values: 5, 10, 20, and 40",
          "constraints": ""
        },
        {
          "path": "$[].ttl",
          "type": "string",
          "description": "Time to live. Valid values: 1h, 6h, 12h, 1d, 2d, 3d, 4d, 5d, 6d, and 7d",
          "constraints": ""
        },
        {
          "path": "$[].limit_price",
          "type": "string",
          "description": "Limit price. If omitted, the market price is used",
          "constraints": ""
        },
        {
          "path": "$[].trigger_price",
          "type": "string",
          "description": "Trigger price. If omitted, the order is triggered immediately",
          "constraints": ""
        },
        {
          "path": "$[].status",
          "type": "string",
          "description": "Order status\n\n- CREATED: Created\n- CANCELING: Canceling\n- RUNNING: Running\n- COMPLETED: Completed\n- EXPIRED: Expired\n- TERMINATED: Terminated",
          "constraints": ""
        },
        {
          "path": "$[].terminated_as",
          "type": "string",
          "description": "Order termination reason code",
          "constraints": ""
        },
        {
          "path": "$[].start_time_ms",
          "type": "integer",
          "description": "Order execution start time in milliseconds",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].end_time_ms",
          "type": "integer",
          "description": "Order execution end time in milliseconds",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].expire_time_ms",
          "type": "integer",
          "description": "Order expiration time in milliseconds",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].create_time_ms",
          "type": "integer",
          "description": "Creation time of order (in milliseconds)",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].update_time_ms",
          "type": "integer",
          "description": "Last modification time of order (in milliseconds)",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].text",
          "type": "string",
          "description": "Order custom information. Users can set custom ID with this field. Custom fields must meet the following conditions:\n\n1. Must start with `t-`\n2. Excluding `t-`, length cannot exceed 28 bytes\n3. Can only contain numbers, letters, underscore(_), hyphen(-) or dot(.)\n",
          "constraints": ""
        }
      ]
    }
  },
  "source_version": "v4.106.132",
  "source_url": "https://github.com/gate/gateapi-python/blob/cd2cac4d339ec0734480787d23c020f467fd7b80/openapi.yaml",
  "local_tool_limits": [
    "仅检查必填、枚举和简单数值范围",
    "复杂类型序列化、条件必填、时间窗口等以官方规则为准",
    "不会发起 API 请求"
  ]
}