[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_142":143},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":57,"_58":-5,"_59":51,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":-5,"_83":-5,"_84":85,"_86":87,"_88":-5,"_89":45,"_90":91,"_92":93,"_94":95,"_96":97,"_98":99,"_100":101},"apiUrl","https://odel.app/api","creator","tickdb","moduleId","tickdb-market-data","@tickdb/tickdb-market-data","displayName","TickDB Market Data","tagline","Real-time & historical market data: forex, stocks, crypto, indices, metals, K-line, quotes","iconKey","external/5bd274ff8baadd4354e872feeeabe1fe4d532f88c2286267643bccdebbba5eb5.png","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.tickdb.ai/\",\"transport\":\"streamable-http\",\"authType\":\"headers\",\"requiredSecrets\":[{\"name\":\"X-TickDB-Key\",\"scope\":\"per-user\",\"header\":\"X-TickDB-Key\"}]}","pricingModel","free","priceCredits",0,"creatorUserId","system:external-import","createdAt",1781363378000,"updatedAt",1790464262000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.TickDB%2Ftickdb-market-data","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",824,"upstreamUpdatedAt",1781969477000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt",1790449410000,"githubRepoUrl","https://github.com/TickDB/tickdb-unified-realtime-marketdata-api","githubRepoFullName","TickDB/tickdb-unified-realtime-marketdata-api","releaseId","ext-tickdb-tickdb-unified-realtime-marketdata-api","version","0.1.2","descriptionMarkdown","

\n\n $\"TickDB$ \n\n# TickDB — Unified Real-time Market Data API for Forex, Stocks, Crypto\n\n*One connection for Forex, Precious Metals, Indices, US Stocks, HK Stocks, A-Shares, and Crypto*\n\n*开源工具集 · 完整 API 文档 + AI Skill + MCP 服务端实现*\n\n[![API Status](https://img.shields.io/badge/API-Live-green)](https://tickdb.ai)\n[![AI-Native](https://img.shields.io/badge/AI--Native-Skill%20%7C%20MCP%20%7C%20CLI-purple)](#ai-access)\n[![MCP CI](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/actions/workflows/mcp-ci.yml/badge.svg)](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/actions/workflows/mcp-ci.yml)\n[![Docs Check](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/actions/workflows/docs-quality.yml/badge.svg)](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/actions/workflows/docs-quality.yml)\n[![WebSocket](https://img.shields.io/badge/WebSocket-Supported-blue)](https://tickdb.ai)\n[![Latency](https://img.shields.io/badge/Latency-10--50ms-blue)](#)\n[![Docs](https://img.shields.io/badge/Docs-docs.tickdb.ai-brightgreen)](https://docs.tickdb.ai)\n[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)\n\n**语言版本:** [🇨🇳 简体中文](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/README.md) • [🇹🇼 繁體中文](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/README_tw.md) • [🇺🇸 English](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/README_en.md)\n\n[📚 在线文档](https://docs.tickdb.ai) • [🌐 官网](https://tickdb.ai) • [🤖 AI 接入 ↓](#ai-access)\n\n

\n\n---\n\n## 🎯 什么是 TickDB？\n\nTickDB 是面向开发者、AI 代理和多市场金融应用的 **AI 原生实时行情数据 API**(AI-native real-time market data API)。\n\n通过 **一次接入（one connection）**，无缝访问外汇（Forex）、贵金属（Precious Metals）、指数（Indices）、美股（US Stocks / NASDAQ / NYSE）、港股（HK Stocks）、A 股（A-Shares）、加密货币（Cryptocurrency）等多个金融市场的实时与历史行情数据。\n\nTickDB 专为需要**可靠、低延迟、可长期依赖**行情数据的开发者构建，帮助你**避免管理多个数据源、协议和供应商的复杂性**，专注于业务和策略本身。\n\n> 支持 tick 级成交（trades）、盘口深度（order book / depth）、K 线（candlestick）等多种行情形式，\n> 通过 REST API 与 WebSocket 接入，覆盖量化交易、AI Agent、实时行情系统、交易平台与数据分析场景。\n\n---\n\n## 🚀 快速接入\n\n📦 **本仓库提供完整源码**：[`SKILL/`](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/SKILL/)（AI Skill 配置）· [`mcp/`](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/mcp/)（Python MCP 服务端，13 工具 · Dockerfile · 46 单元测试 · CI · MIT）。托管端点 `mcp.tickdb.ai` 即基于 [`mcp/`](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/mcp/) 代码运行 — 你看到的、你部署的、官方在跑的，是同一套代码。\n\n选一种适合你的接入方式：\n\n| 方式 | 适合 | 说明 |\n|------|------|------|\n| 💬 **[Skill](#skill)** | AI 对话即用，零配置 | npx 一键安装，AI 自动获取试用 Key |\n| 🔌 **[MCP](#mcp)** | AI 编码客户端 / 自部署开源 | 托管端点 + JSON 配置，或基于 [`mcp/`](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/mcp/) 自部署 |\n| 💻 **[CLI](#cli)** | 终端 / 脚本 / AI Agent | npm 全局安装，命令行直查行情 |\n| 🔧 **[REST API](#rest-api)** | 应用集成 | HTTP API + 6 个端点示例 |\n| 🌐 **[WebSocket](#websocket)** | 实时流式数据 | 低延迟订阅 ticker / depth / trade |\n\n---\n\n## ✨ 核心特性\n\n- **🔌 统一接入** - 一套 API 覆盖外汇、贵金属、指数、美股、港股、A 股、加密货币\n- **⚡ 实时数据** - 基于 WebSocket 的流式推送，端到端延迟约 10-50ms\n- **🤖 AI 原生** - 官方提供 Skill / MCP / CLI 三档 AI 接入，AI Agent 与编码助手开箱即用\n- **🛠️ 开发者友好** - RESTful API + WebSocket，结构化 JSON 响应，完整文档与多语言示例\n- **🌍 全球覆盖** - 37,527+ 品种，6 大市场（US/HK/CN + Forex/Crypto/Indices）\n- **🆓 免费开始** - 无需信用卡，立即获取 API 密钥\n\n---\n\n## 🏗️ 典型使用场景\n\n- **量化交易（Quantitative Trading）** - 算法与策略系统的实时行情数据源\n- **AI Agent / 编码助手** - 通过 Skill / MCP 让 AI 助手直接调用行情数据，自然语言驱动查询\n- **行情看板** - 实时价格展示、资产与投资组合监控\n- **交易应用** - 构建类似 TradingView 的行情界面与图表系统\n- **数据分析与回测（Backtesting）** - 历史行情分析、策略回测与研究\n- **金融服务集成** - 集成到现有交易平台或金融基础设施中\n- **自部署 / 私有化** - 不想用托管端点？基于本仓库 [`mcp/`](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/mcp/) 代码自部署，完全控制数据流\n\n---\n\n\n## 🚀 快速开始 — REST API\n\n### 1. 注册并获取 API 密钥\n\n访问 [TickDB.ai](https://tickdb.ai) 注册账户，即可获取 API 密钥。\n\n#### 🔑 身份认证\n\n所有 HTTP API 请求都需要在请求头中包含 API 密钥：\n\n```http\nX-API-Key: YOUR_API_KEY\n```\n\n#### 🌐 基础 URL\n\n```\nhttps://api.tickdb.ai\n```\n\n#### 📋 HTTP API 核心接口\n\n| 接口 | 方法 | 描述 |\n|------|------|------|\n| `/v1/market/kline` | GET | 历史 K 线 / 蜡烛图（Candlestick）数据 |\n| `/v1/market/ticker` | GET | 实时行情（Ticker）数据 |\n| `/v1/market/depth` | GET | 订单簿深度（Order Book）数据 |\n| `/v1/market/trades` | GET | 最近成交（Recent Trades）历史 |\n\n#### 🏪 支持的市场\n\n| 市场类型 | Symbol 格式示例 | 说明 |\n|---------|----------------|------|\n| 外汇（Forex / FX） | `GBPUSD` | 主要货币对（Base/Quote） |\n| 贵金属（Precious Metals） | `XAUUSD` | 贵金属对美元（Commodity / USD） |\n| 美股（US Stocks） | `AAPL.US` | NYSE / NASDAQ 上市股票 |\n| 指数（Indices） | `SPX` | 股票指数（如标准普尔 500） |\n| 港股（HK Stocks） | `700.HK` | 港交所上市证券 |\n| A 股（A-Shares） | `600519.SH` | 上海 / 深圳交易所股票 |\n| 加密货币（Cryptocurrency） | `BTCUSDT` | 加密资产交易对 |\n\n### 2. 获取 K 线（K-line）数据\n\n```bash\ncurl -H \"X-API-Key: YOUR_API_KEY\" \\\n \"https://api.tickdb.ai/v1/market/kline?symbol=700.HK&interval=1h&limit=24\"\n```\n\n### 3. 获取实时行情（Ticker）数据\n\n```bash\ncurl -H \"X-API-Key: YOUR_API_KEY\" \\\n \"https://api.tickdb.ai/v1/market/ticker?symbols=AAPL.US,700.HK,BTCUSDT\"\n```\n\n### 4. 获取盘口深度（Depth）数据\n\n```bash\ncurl -H \"X-API-Key: YOUR_API_KEY\" \\\n \"https://api.tickdb.ai/v1/market/depth?symbol=AAPL.US&limit=10\"\n```\n\n### 5. 获取成交记录（Trades）数据\n\n```bash\ncurl -H \"X-API-Key: YOUR_API_KEY\" \\\n \"https://api.tickdb.ai/v1/market/trades?symbols=AAPL.US&limit=20\"\n```\n\n### 6. 查询可用交易品种\n\n```bash\ncurl -H \"X-API-Key: YOUR_API_KEY\" \\\n \"https://api.tickdb.ai/v1/symbols/available?market=HK&limit=10\"\n```\n\n---\n\n\n## 🌐 实时订阅 — WebSocket\n\n低延迟（10-50ms）的流式数据推送，适合实时行情看板、量化策略与 Agent 自动化场景。\n\n### 支持的频道\n\n- `ticker` - 实时价格更新\n- `depth` - 订单簿（Order Book）变化\n- `trade` - 实时成交执行\n\n```javascript\nconst ws = new WebSocket('wss://api.tickdb.ai/v1/realtime?api_key=YOUR_API_KEY');\n\nws.onopen = () => {\n // 订阅实时价格\n ws.send(JSON.stringify({\n cmd: 'subscribe',\n data: { channel: 'ticker', symbols: ['BTCUSDT'] }\n }));\n\n // 订阅订单簿变化\n ws.send(JSON.stringify({\n cmd: 'subscribe',\n data: { channel: 'depth', symbols: ['BTCUSDT'] }\n }));\n\n // 订阅实时成交数据\n ws.send(JSON.stringify({\n cmd: 'subscribe',\n data: { channel: 'trade', symbols: ['BTCUSDT'] }\n }));\n};\n```\n\n---\n\n\n## 🤖 AI 接入\n\nTickDB 是 **AI-native** 行情数据 API，提供三档原生接入方式，覆盖从零配置对话到生产级深度集成的全场景需求。\n\n\n### 💬 Skill — 对话即用\n\n安装后 AI 自动获取试用 Key，无需注册即可查询 72 个热门品种：\n\n```bash\nnpx clawhub@latest install tickdb-market-data\n```\n\n或直接使用本仓库 [SKILL 文件](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/SKILL/SKILL.md)。\n\n\n### 🔌 MCP — 永久集成\n\n一次配置，让 Claude、Cursor、Kiro 等 AI 编码客户端永久获得 13 个行情工具。\n\n**托管端点（推荐，无需自部署）：**\n\n```json\n{\n \"mcpServers\": {\n \"tickdb\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.tickdb.ai/\",\n \"headers\": {\n \"X-TickDB-Key\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n支持客户端：Claude Code · Claude Desktop · Cursor · Kiro · Codex · Zed · Cherry Studio\n\n**MCP 服务端已开源**，代码位于本仓库 [`mcp/`](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/mcp/) 目录。\n\n📊 **mcp/ 概览**：13 个 MCP 工具 · Python 3.11+ · Docker 就绪 · 46 单元测试 · MIT 许可证 · CI 持续验证\n\n| 文档 | 链接 |\n|------|------|\n| 客户端接入配置 | [mcp/MCP_CLIENT_SETUP.md](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/mcp/MCP_CLIENT_SETUP.md) |\n| 部署说明（自部署） | [mcp/DEPLOYMENT.md](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/mcp/DEPLOYMENT.md) |\n| MCP 完整文档 | [mcp/README.md](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/mcp/README.md) |\n\n\n### 💻 CLI — 终端 & Agent\n\n```bash\nnpm install -g tickdb\ntickdb config set-key YOUR_API_KEY\ntickdb ticker BTCUSDT,XAUUSD\n```\n\n详见 [官网 AI 接入页面](https://tickdb.ai/ai-tools)。\n\n---\n\n## 📚 在线文档\n\n完整的 API 参考、参数说明、以及可直接运行的示例请求：\n\n- **Docs**: https://docs.tickdb.ai\n- **官网**: https://tickdb.ai\n- **AI 接入页面**: https://tickdb.ai/ai-tools\n\n---\n\n## 🤝 社区和支持\n\n- **GitHub Issues** - [报告错误或请求功能](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/issues)\n- **技术支持** - [Telegram](https://t.me/TickDB_Support)\n- **邮箱** - [support@tickdb.ai](mailto:support@tickdb.ai)\n- **文档** - [docs.tickdb.ai](https://docs.tickdb.ai)\n\n---\n\n## 📄 许可证\n\n本文档采用 [MIT 许可证](https://github.com/TickDB/tickdb-unified-realtime-marketdata-api/blob/main/LICENSE)。\n","changelogMarkdown","videoKey","requiredSecretsJson","[{\"name\":\"X-TickDB-Key\",\"scope\":\"per-user\",\"header\":\"X-TickDB-Key\"}]","publishedAt",1780587107000,"priceCents","trialDays","iconType","image","upstream",{"_125":126,"_127":128,"_129":130,"_131":132,"_133":134,"_135":136},"requiredSecrets",[119],"tags",[104,105,106,107,108,109,110,111,112,113,114,115,116,117,118],"assets",[],"stats",{"_102":45,"_103":45},"ratingAvg","reviewCount","ai-tools","cli-tool","commodities","cryptocurrency","financial-data","forex","indices","market-data","order-book","real-time","rest-api","skill","stock","stock-api","stock-data",{"_120":121,"_122":123,"_124":121},"name","X-TickDB-Key","scope","per-user","header","topics",[104,105,106,107,108,109,110,111,137,112,113,114,115,116,117,118,138,139,140,141],"license","MIT","language","Python","registryName","io.github.TickDB/tickdb-market-data","homepage","https://tickdb.ai","packages",[],"mcp","stock-market","stocks","tick-data","websocket","ENV",{"_144":145,"_146":147,"_148":149,"_150":-7},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272","SENTRY_ENABLE_LOCAL"]