同花顺金融数据服务

同花顺金融数据服务是由同花顺官方提供并维护的一站式 A 股金融数据解决方案。它打破了传统金融数据获取的壁垒，通过统一的 API Key，为 AI Agent、量化研究者及应用开发者提供涵盖行情、财务、估值、指数、板块及公募基金等全维度的实时与历史数据。该服务支持 REST API、MCP、CLI、Python SDK 及本地 DuckDB 数据库等多种接入方式，旨在让金融数据像代码一样易于调用和集成。

核心数据能力

• 📈 行情与交易数据：
  • 实时快照：最新价格、涨跌幅、成交额、集合竞价快照。
  • 特色数据：涨跌停池、炸板池、连板天梯、个股异动、热榜及龙虎榜。
  • 历史 K 线：支持股票、指数及板块的历史走势查询，含前/后复权因子。
• 📊 基本面与估值：
  • 财务报表：利润表、资产负债表、现金流量表及五类核心财务指标。
  • 估值快照：批量查询市盈率 (TTM/MRQ)、市净率、市销率及市现率。
  • 公司行动：分红、送转等事件及交易日历。
• 🏦 公募基金与指数：
  • 基金全景：资料、经理、持仓、业绩、净值及 ETF/LOF 场内行情。
  • 指数板块：成分股目录、行情及历史 K 线。

多元接入方式：总有一款适合你

快速开始指南

1. 获取 API Key

登录同花顺金融数据服务官网创建 Key，并保存为环境变量 HITHINK_FINANCE_API_KEY。

2. 推荐：安装 hithink-finance Skill

让 AI Agent 自动管理数据调用：

npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes

安装后，你可以直接对 Agent 说：“查询贵州茅台的最新行情，并分析近一年的涨跌幅。”

3. CLI 快速体验

# 安装 CLI
npm install -g @hithink-tech/hithink-finance-cli

# 登录
hithink-finance auth login

# 查询最新行情
hithink-finance market snapshot --thscodes 600519.SH --format json

4. MCP 配置示例

在支持 MCP 的客户端（如 Claude Desktop）中添加以下配置：

{
  "mcpServers": {
    "hithink-finance-a-share": {
      "type": "http",
      "url": "https://fuyao.aicubes.cn/mcp/a-share",
      "headers": { "X-api-key": "${HITHINK_FINANCE_API_KEY}" }
    }
  }
}

AI Agent 使用约定

为确保数据准确性与安全性，Agent 在使用本服务时需遵循：

1. 代码消歧：用户仅提供名称时，必须先检索唯一的 thscode，严禁猜测交易所后缀。
2. 优先远端：最新行情、财报及特色数据优先调用远端 API。
3. 本地缓存：历史行情优先查询本地 DuckDB，减少重复下载。
4. 大结果落盘：全市场或多年数据必须保存为文件，仅在对话中返回路径与摘要。
5. 真实透明：数据不可用时明确说明，严禁使用模拟数据冒充；所有分析需注明“非投资建议”。