TickDB — Unified Real-time Market Data API for Forex, Stocks, Futures, Crypto

One connection for Forex, Precious Metals, Indices, US Stocks, HK Stocks, A-Shares, China/Hong Kong Futures, and Crypto

开源工具集 · 完整 API 文档 + AI Skill + MCP 服务端实现

语言版本: 简体中文 • 繁體中文 • English

在线文档 • 官网 • AI 接入

---

什么是 TickDB？

TickDB 是面向开发者、AI 代理和多市场金融应用的 AI 原生实时行情数据 API(AI-native real-time market data API)。

通过 一次接入（one connection），无缝访问外汇（Forex）、贵金属（Precious Metals）、指数（Indices）、美股（US Stocks / NASDAQ / NYSE）、港股（HK Stocks）、A 股（A-Shares）、中国及香港期货（China/Hong Kong Futures）、加密货币（Cryptocurrency）等多个金融市场的实时与历史行情数据。

TickDB 专为需要可靠、低延迟、可长期依赖行情数据的开发者构建，帮助你避免管理多个数据源、协议和供应商的复杂性，专注于业务和策略本身。

支持逐笔成交（tick-by-tick trades）、盘口深度（order book / depth）、K 线（candlestick）等多种行情形式， 通过 REST API 与 WebSocket 接入，覆盖量化交易、AI Agent、实时行情系统、交易平台与数据分析场景。

---

快速接入

本仓库提供完整源码：SKILL/（AI Skill，含接口参考）· mcp/（Python MCP 服务端，43 工具 · Dockerfile · 自动化测试 · CI · MIT）。可基于 mcp/ 自部署，也可使用公开托管端点 mcp.tickdb.ai。

选一种适合你的接入方式：

方式	适合	说明
Skill	AI 对话即用，零配置	npx 一键安装，AI 自动获取试用 Key
MCP	AI 编码客户端 / 自部署开源	基于 mcp/ 自部署，或使用托管 OAuth / 请求头接入
CLI	终端 / 脚本 / AI Agent	npm 全局安装，命令行直查行情
REST API	应用集成	行情、期货与财务基本面 HTTP API
WebSocket	实时流式数据	低延迟订阅 ticker / depth / trade

---

核心特性

• 统一接入：一套 API 覆盖外汇、贵金属、指数、美股、港股、A 股、中国及香港期货、加密货币
• 实时数据：基于 WebSocket 的流式推送，端到端延迟约 10-50ms
• 公司财务与基本面：REST API 提供美股、港股、A 股财报、PE 估值、营收构成、股东与公司事件查询
• AI 原生：官方提供 Skill / MCP / CLI 三档 AI 接入，AI Agent 与编码助手开箱即用
• 开发者友好：RESTful API + WebSocket，结构化 JSON 响应，完整文档与多语言示例
• 全球覆盖：覆盖股票、外汇、贵金属、指数、中国及香港期货与加密货币；品种及数量以产品目录返回为准
• 免费开始：无需信用卡，立即获取 API 密钥

---

典型使用场景

• 量化交易（Quantitative Trading）：算法与策略系统的实时行情数据源
• AI Agent / 编码助手：通过 Skill / MCP 让 AI 助手直接调用行情数据，自然语言驱动查询
• 行情看板：实时价格展示、资产与投资组合监控
• 交易应用：构建类似 TradingView 的行情界面与图表系统
• 数据分析与回测（Backtesting）：历史行情分析、策略回测与研究
• 金融服务集成：集成到现有交易平台或金融基础设施中
• 自部署 / 私有化：不想用托管端点？基于本仓库 mcp/ 代码自部署，完全控制数据流

---

快速开始 — REST API

同一 REST API 提供行情与公司财务和基本面查询；财务接口包括财报、估值、股东持仓与分类财经日历。

认证与基础信息 · 行情核心 API · 公司财务与基本面 API

认证与基础信息

访问 TickDB.ai 注册账户，即可获取 API 密钥。

身份认证

所有 HTTP API 请求都需要在请求头中包含 API 密钥：

X-API-Key: YOUR_API_KEY

基础 URL

https://api.tickdb.ai

API Key 订阅查询

• GET /v1/apikeys/subscriptions — 查询当前认证账户下 API Key 的套餐、状态与到期情况

支持的市场

市场类型	Symbol 格式示例	说明
外汇（Forex / FX）	GBPUSD	主要货币对（Base/Quote）
贵金属（Precious Metals）	XAUUSD	贵金属对美元（Commodity / USD）
美股（US Stocks）	AAPL.US	NYSE / NASDAQ 上市股票
指数（Indices）	SPX	股票指数（如标准普尔 500）
港股（HK Stocks）	700.HK	港交所上市证券
A 股（A-Shares）	600519.SH	上海 / 深圳交易所股票
中国期货（China Futures）	AP8888	type=futures、market=CN；具体合约及连续合约以目录为准
香港期货（HK Futures）	HSI8888	type=futures、market=HK；具体合约及连续合约以目录为准
加密货币（Cryptocurrency）	BTCUSDT	加密资产交易对

期货支持实时行情、K 线、盘口与逐笔成交查询；K 线可返回持仓量 open_interest。代码须从 /v1/symbols/available?type=futures 查询，普通合约随交割月变化；7777、8888、9999 分别表示次主力、主力和加权连续，连续合约不代表实际可交割合约。上表仅展示代码格式，数据可用性取决于品种与 Key 权限。

行情核心 API

通用行情