快速开始

TickerLab 文档

专业的股票行情数据 API 服务，提供 K 线图表生成、技术指标计算和实时行情数据。

基础信息

项目说明
Base URLhttps://tickerlab.org
认证方式API Key（Header 或 Query 参数）
数据格式JSON
支持协议HTTPS

认证

所有 API 请求需要携带 API Key：

# 方式 1: Header 认证（推荐）
curl -H "X-API-Key: your_api_key" https://tickerlab.org/v1/indicators/time_series?symbol=000001.SZ

# 方式 2: Query 参数
curl "https://tickerlab.org/v1/indicators/query?apikey=your_api_key&symbol=000001.SZ&function=SMA"

快速开始

Python

import requests

API_KEY = "your_api_key"
BASE_URL = "https://tickerlab.org"

# 获取时间序列数据
response = requests.get(
    f"{BASE_URL}/v1/indicators/time_series",
    params={"symbol": "000001.SZ", "interval": "1d"},
    headers={"X-API-Key": API_KEY}
)
data = response.json()
print(data["values"][:5])  # 最近 5 条数据

JavaScript

const API_KEY = 'your_api_key';
const BASE_URL = 'https://tickerlab.org';

// 获取时间序列数据
const response = await fetch(
  `${BASE_URL}/v1/indicators/time_series?symbol=000001.SZ&interval=1d`,
  { headers: { 'X-API-Key': API_KEY } }
);
const data = await response.json();
console.log(data.values.slice(0, 5));

cURL

curl -G "https://tickerlab.org/v1/indicators/time_series" \
  -H "X-API-Key: your_api_key" \
  -d "symbol=000001.SZ" \
  -d "interval=1d"

API 端点概览

访问策略

/v1/metadata/endpoint-policies 已调整为内部管理员接口，不再对终端用户开放。

当前公开/专业版分层：

层级端点分组
Free/v1/market/*（不含 chart batch/storage）、/v1/macro/*、/v1/flow/*、/v1/stock/*、/v1/finance/*、/v1/sector/*、/v1/ranking/*、/v1/summary/*、/v1/indicators/*
Pro+/v1/intraday/*、/v1/export/*、/v1/market/chart/storage、/v1/market/chart/batch

K 线数据

多周期 K 线与 OHLCV 时间序列数据，是行情分析的主要入口。

方法端点
GET/v1/indicators/time_series
  • 适用场景: K 线序列、回测、图表数据源
  • 常用参数: symbol, interval, start_date, end_date, outputsize

示例:

curl -G "https://tickerlab.org/v1/indicators/time_series" \
  -H "X-API-Key: your_key" \
  -d "symbol=000001.SZ" \
  -d "interval=1d"

实时行情

获取单一标的的最新买卖盘与最新价。

方法端点
GET/v1/market/quote
  • 适用场景: 实时行情看板、交易界面

示例:

curl -H "X-API-Key: your_key" "https://tickerlab.org/v1/market/quote?symbol=000001.SZ"

历史行情（导出）

更适合批量导出和 CSV/JSON 下载的历史行情。

方法端点
GET/v1/market/history
  • 适用场景: 批量历史数据、离线分析

示例:

curl -H "X-API-Key: your_key" \
  "https://tickerlab.org/v1/market/history?symbol=BTCUSDT&interval=1d&start_date=2023-01-01"

批量图表生成

一次请求生成多张静态图表。

方法端点
POST/v1/market/chart/batch
  • 适用场景: 报表、批量 PNG 输出

示例:

curl -X POST "https://tickerlab.org/v1/market/chart/batch" \
  -H "X-API-Key: your_key" \
  -H "Content-Type: application/json" \
  -d '[
    {"symbol": "000001.SZ", "interval": "1d", "studies": [{"name": "MACD"}]},
    {"symbol": "BTCUSDT", "interval": "4h", "studies": [{"name": "RSI"}]}
  ]'

技术指标 (Technical Indicators)

所有指标均支持 symbol, interval, start_date, end_date 参数。

端点说明特定参数
/v1/market/vwap成交量加权平均价-
/v1/indicators/bbands布林带timeperiod (default 20), nbdevup (2)
/v1/indicators/macd平滑异同移动平均线fastperiod (12), slowperiod (26), signalperiod (9)
/v1/indicators/rsi相对强弱指标timeperiod (14)
/v1/market/stoch随机指标fastk_period (14), slowk_period (3)
/v1/market/atr平均真实波幅timeperiod (14)
/v1/market/obv能量潮-
/v1/market/adx平均趋向指数timeperiod (14)

宏观数据（新增扩展）

覆盖政策、迁徙、大宗商品、外汇、加密资产与全球风险等多维宏观数据。

方法端点分组说明
GET/v1/macro/cpi, /v1/macro/ppi, /v1/macro/gdp, /v1/macro/money-supply, /v1/macro/lpr, /v1/macro/pmi中国核心宏观指标
GET/v1/macro/social-finance, /v1/macro/new-loans, /v1/macro/fx-reserves信贷与储备相关指标
GET/v1/macro/migration-scale, /v1/macro/migration-area, /v1/macro/epu-index迁徙与政策不确定性
GET/v1/macro/oil-price-adjustment, /v1/macro/oil-price-region国内成品油价格跟踪
GET/v1/macro/commodity-daily, /v1/macro/forex-daily, /v1/macro/crypto-daily商品/外汇/加密日频数据
GET/v1/macro/global-index-daily, /v1/macro/global-index-spot, /v1/macro/fx-spot全球指数与外汇快照
GET/v1/macro/energy-inventory, /v1/macro/global-risk-factor能源库存与全球风险因子
  • 常用参数: start_date, end_date, limit

资金流数据（新增扩展）

覆盖资金流向、沪深港通持仓、限售解禁与停复牌等市场事件数据。

方法端点分组说明
GET/v1/flow/capital-flow, /v1/flow/north-flow, /v1/flow/south-flow核心资金流渠道
GET/v1/flow/margin, /v1/flow/margin-detail融资融券汇总与明细
GET/v1/flow/dragon-tiger, /v1/flow/institute-recommend龙虎榜与机构评级
GET/v1/flow/hsgt-hold-rank, /v1/flow/hsgt-stock-statistics沪深港通持股排行/统计
GET/v1/flow/stock-repurchase股票回购进度
GET/v1/flow/restricted-release-summary, /v1/flow/restricted-release-detail, /v1/flow/restricted-release-queue, /v1/flow/restricted-release-stockholder限售解禁全链路数据
GET/v1/flow/suspend-resume-events停复牌事件
  • 常用参数: symbol/stock_code, start_date, end_date, limit

汇总智能接口（P0）

面向 Agent 分析任务的聚合接口：市场状态识别、情绪强弱、板块轮动、单票综合快照与事件时间线。

方法端点分组说明
GET/v1/summary/market/regime, /v1/summary/market/sentiment市场状态与情绪总览
GET/v1/summary/market/hot-stock-trend热股趋势汇总
GET/v1/summary/sector/rotation板块主线与轮动强度
GET/v1/summary/sector/concept-heat, /v1/summary/sector/breadth概念热度与板块广度
GET/v1/summary/stock/snapshot单票统一快照（价格/技术/资金/财务/风险）
GET/v1/summary/stock/event-timeline单票催化事件时间线
GET/v1/summary/opportunity/watchlist, /v1/summary/risk/invalidation机会池与逻辑失效跟踪
  • 常用参数: trade_date, sector_type, symbol, start_date, end_date, limit

盘中智能接口（Pro）

方法端点分组说明
GET/v1/intraday/momentum盘中动量、突破与回落风险
GET/v1/intraday/sector-pulse盘中板块脉冲与延续概率
GET/v1/intraday/market-breadth分钟级市场广度拐点

订阅与账户 (Billing & Account)

端点方法说明
/v1/billing/plansGET获取订阅套餐列表
/v1/billing/usageGET查询当前 API 用量
/v1/payment/packagesGET获取充值包信息
/v1/payment/createPOST创建充值订单

错误处理

所有 API 错误返回标准化 JSON 格式：

{
  "error": {
    "code": "ERROR_CODE",
    "message": "可读的错误描述",
    "request_id": "abc123-uuid"
  }
}

常用错误码

错误码HTTP 状态码说明
BAD_REQUEST400参数错误或非法请求
UNAUTHORIZED401API Key 无效或过期
FORBIDDEN403权限不足 (如未订阅该数据)
NOT_FOUND404标的或资源不存在
RATE_LIMIT_EXCEEDED429请求频率超限
GEO_RESTRICTED451所在地区无法访问该数据 (如部分加密货币)
INTERNAL_ERROR500服务器内部错误

速率限制

计划每分钟请求 (RPM)每小时请求 (RPH)
Free3150
Pro601,000
Premium30010,000