开发工具
除 REST API 和 MCP 外，同花顺金融数据还提供 CLI、Python SDK 和 Agent Skill。本组文档面向首次接入：从安装开始，到完成一次真实数据查询结束。
三种方式共用同一个 API Key，无需重复注册或创建多个 Key。
你将完成什么
选择任意一种方式后，对应 Quick Start 会带你完成：
- 检查本地环境。
- 安装官方工具。
- 安全配置统一 API Key。
- 查询“贵州茅台”并获取最新行情。
- 根据返回值确认认证和线上数据访问可用。
选择接入方式
| 方式 | 适合场景 | 特点 |
|---|---|---|
| CLI | 终端、自动化、AI Agent | 统一认证、结构化输出，同时覆盖远程数据和本地 DuckDB |
| Python SDK | Python 应用、Notebook、量化研究 | 适合二次开发，可组合远程 toolkit 与本地 marketdb |
| Agent Skill | Codex、Claude Code 等 Agent | 用自然语言描述数据需求，由 Agent 选择合适入口和参数 |
选择建议
不确定时，人类终端和自动化任务优先选 CLI；Python 项目选 Python SDK；希望 Codex、Claude Code 等 Agent 直接理解自然语言需求时安装 Agent Skill。
开始前准备
- 在 API Key 管理 创建 Key。
- 确认当前账号已开通所需数据权限。
- 准备对应运行时：CLI 和 Skill 需要 Node.js/npm，Python SDK 需要 Python 和 Git。
- 将 Key 保存到用户级环境变量
HITHINK_FINANCE_API_KEY，或按各工具页面使用安全输入。 - 不要把 Key 写入代码、命令参数、日志或 Git 仓库。
API Key 是敏感凭据
示例中的 <API_KEY> 只是占位符。推荐使用隐藏输入、环境变量、用户级凭据文件或密钥管理服务，不要把真实 Key 粘贴到命令历史或项目 .env 文件中。
能力范围
CLI、Python SDK 和 Skill 均可覆盖 A 股行情、财务报表与指标、最新估值、指数与板块、集合竞价、公募基金和同花顺特色数据。CLI 和 Python marketdb 还可管理本地 DuckDB 历史数据。
当前不将分钟 K、tick、海外行情、宏观数据、新闻公告原文和研报原文作为公开能力。
文档边界
这里只保留能独立完成首次接入的稳定步骤。某个命令、函数或参数的当前契约，应以工具的 --help、schema、函数签名和源仓文档为准。
项目源码、更新日志和完整使用说明以 GitHub 仓库 为准。本站只维护稳定的接入介绍和快速开始，无需随每个 API 变化同步。