{
  "path": "/delivery/{settle}/candlesticks",
  "operation_id": "listDeliveryCandlesticks",
  "auth_required": false,
  "parameters": [
    {
      "name": "settle",
      "in": "path",
      "description": "Settle currency",
      "required": true,
      "schema": {
        "type": "string",
        "enum": [
          "usdt"
        ]
      },
      "example": "usdt"
    },
    {
      "name": "contract",
      "in": "query",
      "required": true,
      "description": "Futures contract",
      "schema": {
        "type": "string"
      },
      "example": "BTC_USDT_20200814"
    },
    {
      "name": "from",
      "in": "query",
      "required": false,
      "description": "Start time of candlesticks, formatted in Unix timestamp in seconds. Default to`to - 100 * interval` if not specified",
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "example": 1546905600
    },
    {
      "name": "to",
      "in": "query",
      "required": false,
      "description": "Specify the end time of the K-line chart, defaults to current time if not specified, note that the time format is Unix timestamp with second precision",
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "example": 1546935600
    },
    {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Maximum number of recent data points to return. `limit` conflicts with `from` and `to`. If either `from` or `to` is specified, request will be rejected.",
      "schema": {
        "type": "integer",
        "default": 100,
        "maximum": 2000
      },
      "example": 100
    },
    {
      "name": "interval",
      "in": "query",
      "required": false,
      "description": "Time interval between data points, note that 1w represents a natural week, 7d time is aligned with Unix initial time",
      "schema": {
        "type": "string",
        "enum": [
          "10s",
          "30s",
          "1m",
          "5m",
          "15m",
          "30m",
          "1h",
          "2h",
          "4h",
          "6h",
          "8h",
          "12h",
          "1d",
          "7d",
          "1w",
          "30d"
        ],
        "default": "5m"
      },
      "example": "5m"
    }
  ],
  "response_fields": {
    "200": {
      "description": "Query successful",
      "fields": [
        {
          "path": "$",
          "type": "array<object>",
          "description": "",
          "constraints": ""
        },
        {
          "path": "$[]",
          "type": "object",
          "description": "data point in every timestamp",
          "constraints": ""
        },
        {
          "path": "$[].t",
          "type": "number",
          "description": "Unix timestamp in seconds",
          "constraints": "格式：\"double\""
        },
        {
          "path": "$[].v",
          "type": "integer",
          "description": "size volume (contract size). Only returned if `contract` is not prefixed",
          "constraints": "格式：\"int64\""
        },
        {
          "path": "$[].c",
          "type": "string",
          "description": "Close price (quote currency)",
          "constraints": ""
        },
        {
          "path": "$[].h",
          "type": "string",
          "description": "Highest price (quote currency)",
          "constraints": ""
        },
        {
          "path": "$[].l",
          "type": "string",
          "description": "Lowest price (quote currency)",
          "constraints": ""
        },
        {
          "path": "$[].o",
          "type": "string",
          "description": "Open price (quote currency)",
          "constraints": ""
        }
      ]
    }
  },
  "source_version": "v4.106.132",
  "source_url": "https://github.com/gate/gateapi-python/blob/cd2cac4d339ec0734480787d23c020f467fd7b80/openapi.yaml",
  "local_tool_limits": [
    "仅检查必填、枚举和简单数值范围",
    "复杂类型序列化、条件必填、时间窗口等以官方规则为准",
    "不会发起 API 请求"
  ]
}