FTShare-python-sdk
FTShare金融数据Python SDK，为量化研究和AI投研提供统一数据接口。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：FTShare-python-sdk。 它的用途是：FTShare金融数据Python SDK，为量化研究和AI投研提供统一数据接口。 完整的 Skill 内容见：https://321skill.com/skills/ftshare-python-sdk/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我用FTShare SDK获取最近一周的美股龙头公司列表和涨跌幅。” 它会指导你安装SDK并编写类似`ft.market_api().eastmoney_us_stock_list(limit=20, fields='code,name,change_pct')`的代码，快速获取结构化数据进行分析。
介绍
FTShare-python-sdk 是连接FTShare金融数据服务的Python工具包，旨在解决开发者在量化研究、AI应用开发中获取和处理行情、财务、宏观等数据的难题。它通过统一的Python API，将复杂的数据服务封装为简单的函数调用，默认返回pandas DataFrame格式，极大简化了数据接入流程。
开发者只需通过pip安装SDK并导入ftshare模块，即可快速调用各类数据接口。例如，使用ft.market_api().baidu_financial_calendar()获取财经日历，或使用ft.market_api().eastmoney_us_stock_list()获取美股列表。SDK支持灵活的客户端配置、字段筛选、自动分页和多种返回格式。
该SDK主要面向量化交易员、数据分析师、后端开发者和智能体开发者。无论是构建自动化交易策略、进行市场研究、开发金融AI Agent，还是为MCP工具提供数据支持，都可以依赖此SDK作为稳定的数据基础。
使用建议：建议在Python 3.9+环境中使用。对于需要大量历史数据的场景，可利用其all_pages=True参数进行自动翻页。注意，SDK本身不提供数据存储功能，长期使用需自行考虑数据缓存与持久化方案。
核心特点
与通用的数据API封装库不同，FTShare-python-sdk深度集成FTShare金融数据生态，提供开箱即用的A股、港股、美股、期货、宏观等专业数据接口，并针对量化研究和AI工作流（如MCP、Skill、Agent）进行了原生优化，默认返回pandas DataFrame，无缝衔接数据分析流程。
注意事项
该SDK主要专注于金融数据获取，不包含数据建模、策略回测或可视化等高级分析功能。
常见问题
如何获取实时股票行情数据？
安装SDK后，使用`ft.market_api()`创建客户端，调用相应的股票行情接口（如`market.realtime_quote`），传入股票代码等参数即可。
返回的数据可以直接用于机器学习吗？
可以，SDK默认返回pandas DataFrame，这是Python数据科学和机器学习生态的标准数据结构，方便进行后续的数据清洗、特征工程和模型训练。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ftshare-python-sdk/raw/index.md 读取 FTShare-python-sdk 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ftshare-python-sdk/raw/index.md（查看排版版本）