{
  "openapi": "3.0.3",
  "info": {
    "title": "Binance 现货行情转发 API",
    "version": "1.0.0",
    "description": "仅公共现货行情，无需 API Key。单 IP 持续 3 次/秒，全站持续 5 次/秒；上游另有权重限制。"
  },
  "servers": [
    {
      "url": "https://binance.api.dudoo.cc"
    }
  ],
  "paths": {
    "/api/v3/ticker/price": {
      "get": {
        "operationId": "spot_ticker_price",
        "summary": "最新价格",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/ticker/bookTicker": {
      "get": {
        "operationId": "spot_ticker_bookTicker",
        "summary": "最优买卖报价",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/ticker/24hr": {
      "get": {
        "operationId": "spot_ticker_24hr",
        "summary": "24小时统计",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/klines": {
      "get": {
        "operationId": "spot_klines",
        "summary": "K线",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          },
          {
            "name": "interval",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "1m"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "example": 20
            }
          },
          {
            "name": "startTime",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "endTime",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/uiKlines": {
      "get": {
        "operationId": "spot_uiKlines",
        "summary": "展示用K线",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          },
          {
            "name": "interval",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "1m"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "example": 20
            }
          },
          {
            "name": "startTime",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "endTime",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/depth": {
      "get": {
        "operationId": "spot_depth",
        "summary": "订单簿深度",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "example": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/trades": {
      "get": {
        "operationId": "spot_trades",
        "summary": "近期成交",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "example": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/aggTrades": {
      "get": {
        "operationId": "spot_aggTrades",
        "summary": "归集成交",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "example": 20
            }
          },
          {
            "name": "startTime",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "endTime",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "fromId",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/avgPrice": {
      "get": {
        "operationId": "spot_avgPrice",
        "summary": "平均价格",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/ticker": {
      "get": {
        "operationId": "spot_ticker",
        "summary": "滚动窗口统计",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          },
          {
            "name": "windowSize",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "1h"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/exchangeInfo": {
      "get": {
        "operationId": "spot_exchangeInfo",
        "summary": "交易规则",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "BTCUSDT"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/time": {
      "get": {
        "operationId": "spot_time",
        "summary": "服务器时间",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    },
    "/api/v3/ping": {
      "get": {
        "operationId": "spot_ping",
        "summary": "连通性",
        "description": "参数列表列出常用项；完整约束请查 Binance 官方文档。",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Binance 原始行情 JSON",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "additionalProperties": true
                    },
                    {
                      "type": "array",
                      "items": {}
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "本服务或上游限流"
          },
          "default": {
            "description": "请结合 HTTP 状态与上游 code/msg 处理错误"
          }
        }
      }
    }
  },
  "externalDocs": {
    "url": "https://developers.binance.com/en/docs/products/spot/faqs/market_data_only"
  }
}