API 文档

接口地址

Base URL: http://localhost:3000/api/v1

数据源

本平台接入真实股票行情数据源，提供准确的 A 股历史行情数据。

数据源：真实股票历史行情数据库
数据格式：日K线数据（开/高/低/收/成交量）
更新频率：每日收盘后更新
支持市场：A股（沪/深）

认证方式

所有 API 请求都需要提供 API Key。您可以通过以下两种方式传递：

# 方式1: URL 参数（通过股票代码）
curl "http://localhost:3000/api/v1/stock?symbol=000001&api_key=您的API_KEY"

# 方式2: URL 参数（通过股票名称）
curl "http://localhost:3000/api/v1/stock?name=平安银行&api_key=您的API_KEY"

# 方式3: 请求头
curl -H "X-API-Key: 您的API_KEY"   "http://localhost:3000/api/v1/stock?symbol=000001"

接口列表

1. 查询单个股票

GET /stock

参数

参数名	类型	必填	说明
symbol	string	可选	股票代码，如 000001（symbol 和 name 二选一）
name	string	可选	股票名称，如平安银行（symbol 和 name 二选一）
api_key	string	是	您的API Key

💡 提示：支持通过股票代码或股票名称查询，代码优先匹配

响应示例

{
  "success": true,
  "data": {
    "symbol": "000001",
    "name": "平安银行",
    "price": 10.58,
    "change": 0.23,
    "changePercent": 2.22,
    "volume": 5234567,
    "high": 10.75,
    "low": 10.35,
    "open": 10.40,
    "preClose": 10.35,
    "updateTime": "2024-03-10T08:30:00.000Z"
  },
  "remaining": 95
}

2. 查询多个股票

GET /stocks

参数

参数名	类型	必填	说明
symbols	string	可选	股票代码列表，用逗号分隔（symbols 和 names 二选一）
names	string	可选	股票名称列表，用逗号分隔（symbols 和 names 二选一）
api_key	string	是	您的API Key

💡 提示：支持混用代码和名称查询。示例：symbols=000001,603717 或 names=平安银行,天域生态

⚠️ 注意：每查询一个股票扣除一次额度

3. 获取热门股票

GET /market/hot

参数

参数名	类型	必填	说明
api_key	string	是	您的API Key

4. 查询用户额度

GET /user/quota

使用 API Key 鉴权，返回额度信息（扣除1次额度）

响应示例

{
  "success": true,
  "data": {
    "total": 1000,
    "used": 150,
    "remaining": 850
  }
}

5. 获取时间范围内股票数据

GET /stock/range

参数

参数名	类型	必填	说明
symbol	string	可选	股票代码，如 603717（symbol 和 name 二选一）
name	string	可选	股票名称，如天域生态（symbol 和 name 二选一）
start_date	string	是	开始日期，格式: YYYY-MM-DD
end_date	string	是	结束日期，格式: YYYY-MM-DD
api_key	string	是	您的API Key

响应示例

{
  "success": true,
  "data": {
    "symbol": "603717",
    "start_date": "2026-01-01",
    "end_date": "2026-01-31",
    "count": 20,
    "data": [
      {
        "date": "2026-01-20",
        "symbol": "603717",
        "name": "天域生物",
        "open": 7.8,
        "high": 7.83,
        "low": 7.62,
        "close": 7.7,
        "volume": 71209,
        "amount": 55014244,
        "amplitude": 2.7,
        "changePercent": -1.16,
        "change": -0.09
      }
    ]
  },
  "remaining": 180
}

6. 获取股票 K 线数据

GET /stock/kline

参数

参数名	类型	必填	说明
symbol	string	可选	股票代码，如 000001（symbol 和 name 二选一）
name	string	可选	股票名称，如平安银行（symbol 和 name 二选一）
period	string	否	周期: day(日K), week(周K), month(月K)，默认day
limit	number	否	返回条数，默认30
api_key	string	是	您的API Key

响应示例

{
  "success": true,
  "data": {
    "symbol": "000001",
    "period": "day",
    "data": [
      {
        "date": "2024-03-01",
        "open": 10.50,
        "high": 10.75,
        "low": 10.35,
        "close": 10.58,
        "volume": 5234567
      }
    ]
  },
  "remaining": 95
}

7. 获取股票分时数据

GET /stock/intraday

参数

参数名	类型	必填	说明
symbol	string	可选	股票代码，如 000001（symbol 和 name 二选一）
name	string	可选	股票名称，如平安银行（symbol 和 name 二选一）
api_key	string	是	您的API Key

返回当日分时数据，每分钟一个数据点

8. 搜索股票

GET /stocks/search

参数

参数名	类型	必填	说明
keyword	string	是	搜索关键词（股票代码或名称）
api_key	string	是	您的API Key

9. 获取股票详细信息

GET /stock/detail

参数

参数名	类型	必填	说明
symbol	string	可选	股票代码，如 000001（symbol 和 name 二选一）
name	string	可选	股票名称，如平安银行（symbol 和 name 二选一）
api_key	string	是	您的API Key

响应示例

{
  "success": true,
  "data": {
    "symbol": "000001",
    "name": "平安银行",
    "price": 10.58,
    "change": 0.23,
    "changePercent": 2.22,
    "marketCap": "1000000000",
    "pe": "15.32",
    "pb": "1.25",
    "turnover": "2.5",
    "amplitude": "3.2",
    "bid1": "10.57",
    "ask1": "10.59",
    "bidVol1": 5000,
    "askVol1": 3000
  },
  "remaining": 95
}

错误码

状态码	说明
400	请求参数错误
401	未授权，API Key无效或缺失
403	额度已用完，需要充值
404	接口不存在