{
  "path": "/tradfi/symbols/{symbol}/klines",
  "operation_id": "querySymbolKline",
  "auth_required": false,
  "parameters": [
    {
      "name": "symbol",
      "in": "path",
      "required": true,
      "description": "Trading symbol code",
      "schema": {
        "type": "string",
        "example": "EURUSD"
      }
    },
    {
      "name": "kline_type",
      "in": "query",
      "required": true,
      "description": "Kline type (time period)",
      "schema": {
        "type": "string",
        "enum": [
          "1m",
          "15m",
          "1h",
          "4h",
          "1d",
          "7d",
          "30d"
        ],
        "example": "1m"
      }
    },
    {
      "name": "begin_time",
      "in": "query",
      "required": false,
      "description": "Start time (Unix timestamp in seconds)",
      "schema": {
        "type": "integer",
        "format": "int64",
        "example": 1769378400
      }
    },
    {
      "name": "end_time",
      "in": "query",
      "required": false,
      "description": "End time (Unix timestamp in seconds)",
      "schema": {
        "type": "integer",
        "format": "int64",
        "example": 1769464800
      }
    },
    {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Kline limit (max 500, error if exceeded)",
      "schema": {
        "type": "integer",
        "minimum": 1,
        "maximum": 500,
        "example": 100
      }
    }
  ],
  "response_fields": {
    "200": {
      "description": "Request success",
      "fields": [
        {
          "path": "$",
          "type": "object",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.timestamp",
          "type": "integer",
          "description": "Server timestamp (milliseconds)",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$.data",
          "type": "object",
          "description": "Response data",
          "constraints": ""
        },
        {
          "path": "$.data.list",
          "type": "array<object>",
          "description": "Kline data list",
          "constraints": ""
        },
        {
          "path": "$.data.list[]",
          "type": "object",
          "description": "Single kline data",
          "constraints": ""
        }
      ]
    },
    "400": {
      "description": "Request failed",
      "fields": [
        {
          "path": "$",
          "type": "object",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$.label",
          "type": "string",
          "description": "Business status code, non-empty indicates request exception, please refer to TradFi error enumeration in documentation",
          "constraints": ""
        },
        {
          "path": "$.message",
          "type": "string",
          "description": "Return message, returned when request error occurs",
          "constraints": ""
        },
        {
          "path": "$.timestamp",
          "type": "integer",
          "description": "Server timestamp (milliseconds)",
          "constraints": "格式：\"int64\""
        }
      ]
    }
  },
  "source_version": "v4.106.132",
  "source_url": "https://github.com/gate/gateapi-python/blob/cd2cac4d339ec0734480787d23c020f467fd7b80/openapi.yaml",
  "local_tool_limits": [
    "仅检查必填、枚举和简单数值范围",
    "复杂类型序列化、条件必填、时间窗口等以官方规则为准",
    "不会发起 API 请求"
  ]
}