跳到主要内容

历史数据摄取 API 参考

历史数据 API 提供了将历史每日 OHLCV K 线数据摄取、回填和查询到 TimescaleDB 存储中的方法。

POST /historical/ingest​

触发单个资产的历史数据摄取或回填。

请求体 (Request Body)​

{
  "ticker": "BNP.PA",
  "resolution": "d",
  "from_date": "2020-01-01",
  "to_date": "2026-08-01",
  "force": false
}

请求参数​

参数名类型是否必需默认值说明描述
tickerstring✅—要摄取的股票代码
resolutionstring❌dK 线周期 (d, w, m)
from_datestring❌—开始日期 (YYYY-MM-DD)
to_datestring❌—结束日期 (YYYY-MM-DD)
forceboolean❌false重新下载并覆盖数据库中的现有记录

响应示例​

{
  "status": "success",
  "ticker": "BNP.PA",
  "records_added": 1650,
  "source": "YahooFinance",
  "duration_ms": 1240
}

POST /historical/ingest/bulk​

在具有并发控制的情况下触发跨多个股票代码的大批量数据摄取。

请求体 (Request Body)​

{
  "tickers": ["AIR.PA", "BNP.PA", "TTE.PA", "MC.PA"],
  "resolution": "d",
  "concurrency": 4
}

响应示例​

{
  "total": 4,
  "successful": 4,
  "failed": 0,
  "details": [
    { "ticker": "AIR.PA", "status": "success", "records_added": 250 },
    { "ticker": "BNP.PA", "status": "success", "records_added": 250 }
  ]
}

GET /ticker/{symbol}/history​

从 prices_eod 表中查询历史 OHLCV K 线。如果 auto_ingest=true，将自动摄取缺失的数据。

请求参数​

参数名类型是否必需默认值说明描述
symbolstring✅—金融工具代码
resolutionstring❌d周期 (d, w, m)
limitinteger❌500历史 K 线数量
auto_ingestboolean❌true自动从 yfinance 回填缺失的 K 线

使用示例​

cURL​

curl -s "http://localhost:5000/ticker/AAPL/history?limit=10"

Python​

import requests

resp = requests.get("http://localhost:5000/ticker/AAPL/history", params={"limit": 10})
bars = resp.json()["data"]
print("Fetched bars:", len(bars))