天天基金 API

提供基金实时净值、历史净值、K 线 (OHLC)、基金列表等数据接口

API 接口列表

GET /api/fund/realtime

获取单个基金的实时净值数据

GET /api/fund/realtime?code=001186

参数:

  • code - 基金代码 (6位数字,必填)

返回示例:

{
  "fundcode": "001186",
  "name": "富国国有企业债A",
  "jzrq": "2024-01-15",
  "dwjz": "1.2340",
  "gsz": "1.2350",
  "gszzl": "0.08",
  "gztime": "2024-01-16 15:00"
}

GET /api/fund/history

获取单个基金的历史净值数据

GET /api/fund/history?code=001186

参数:

  • code - 基金代码 (6位数字,必填)

返回示例:

[
  {
    "x": 1705276800000,
    "y": 1.234,
    "equityReturn": 0.08,
    "unitMoney": "元",
    "cumulative": 1.567
  }
]

GET /api/fund/kline

获取基金 K 线 (OHLC) 数据,包含开盘价、收盘价、最高价、最低价、成交量、成交额等,可直接用于绘制蜡烛图。仅场内交易的基金 (ETF/LOF) 有真实 OHLC 数据,场外基金每个交易日只公布一个净值,请求场外代码返回 404。

GET /api/fund/kline?code=510300&period=daily&adjust=forward&limit=250

参数:

  • code - 基金代码 (6位数字,必填)
  • period - K 线周期 (可选: daily 日线 / weekly 周线 / monthly 月线,默认 daily)
  • adjust - 复权方式 (可选: none 不复权 / forward 前复权 / backward 后复权,默认 forward)
  • limit - 返回条数 (可选,非负整数,从最新往回取,0 或不传表示全部历史)

返回字段:

  • code - 基金代码
  • name - 基金名称
  • market - 交易市场 (1=上海, 0=深圳)
  • klines - K 线数组 (按日期升序排列),每项包含:
    • date - 交易日期 (YYYY-MM-DD)
    • open / close / high / low - 开盘价 / 收盘价 / 最高价 / 最低价
    • volume - 成交量 (手)
    • amount - 成交额 (元)
    • amplitude - 振幅 (百分比)
    • pctChange - 涨跌幅 (百分比)
    • change - 涨跌额
    • turnover - 换手率 (百分比)

返回示例:

{
  "code": "510300",
  "name": "沪深300ETF华泰柏瑞",
  "market": 1,
  "klines": [
    {
      "date": "2026-09-01",
      "open": 4.683,
      "close": 4.684,
      "high": 4.705,
      "low": 4.666,
      "volume": 8467983,
      "amount": 3962899774,
      "amplitude": 0.83,
      "pctChange": -0.02,
      "change": -0.001,
      "turnover": 3.68
    }
  ]
}

错误响应:

// 400 参数错误
{ "error": "period 参数错误,可选值: daily / weekly / monthly" }

// 404 非场内基金或代码不存在
{ "error": "获取K线数据失败,该基金可能不是场内基金 (ETF/LOF) 或代码不存在" }

使用注意:

  • klines 按日期升序排列;绘制蜡烛图 (如 ECharts) 时转为 [open, close, low, high] 格式
  • 数据为交易所行情,交易日 15:00 收盘后更新当日数据
  • 上游无官方配额保证,前端请做好缓存 (建议至少缓存 5 分钟)

GET /api/fund/list

获取全量基金列表

GET /api/fund/list

返回示例:

[
  {
    "fund_code": "000001",
    "abbr": "HHCZ",
    "name": "华夏成长混合",
    "type": "混合型",
    "pinyin": "huaxiachengzhanghunhe"
  }
]

POST /api/fund/batch-realtime

批量获取多个基金的实时净值数据

POST /api/fund/batch-realtime

请求体:

{
  "codes": ["001186", "110022"],
  "concurrency": 5
}

参数:

  • codes - 基金代码数组 (必填)
  • concurrency - 并发数 (可选,默认5)

返回示例:

{
  "001186": {
    "fundcode": "001186",
    "name": "富国国有企业债A",
    ...
  },
  "110022": {
    "fundcode": "110022",
    "name": "易方达消费行业股票",
    ...
  }
}