快速开始

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 端点概览

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)

订阅与账户 (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)
Free10100
Pro601,000
Enterprise30010,000