{"repo":"FTShare-Lab/FTShare-python-sdk","free":true,"listed":false,"github":"https://github.com/FTShare-Lab/FTShare-python-sdk","clone":"git clone https://github.com/FTShare-Lab/FTShare-python-sdk.git","description":"FTShare financial data Python SDK｜金融数据 Python SDK，支持 market data、quantitative research、MCP、Skill 和 Agent workflows。","language":"Python","stars":86,"topics":["financial-data","ftshare","investment-research","market-data","mcp","python-sdk","agent","skill","ai-finance","python"],"license":"MIT","category":"trading","readme_excerpt":"FTShare Python SDK FTShare-python-sdk 是 FTShare 金融数据能力的 Python SDK，面向需要接入行情、财务、宏观、基金、期货等数据的开发者。 它提供统一的 Python 调用方式，默认返回 pandas DataFrame ，方便开发者在数据分析、量化研究、金融应用开发、MCP 工具封装、Skill 构建和 Agent 投研流程中使用 FTShare 数据。 面向国际开发者，本项目也可以被理解为 FTShare financial data Python SDK ：用于 market data、quantitative research、MCP tools、Agent Skills 和 AI finance workflows 的底层数据接入组件。 在 FTShare 生态中的位置 FTShare-python-sdk 是 FTShare 生态的数据接入层。它向下连接 FTShare 数据服务，向上为 MCP、Skill、量化研究脚本和 Agent 应用提供稳定的数据基础。 安装 本地开发时，克隆仓库并以可编辑模式安装（含测试依赖）： pandas 和 requests 是运行依赖，会随 SDK 默认安装。 快速开始 输出是 pandas DataFrame 。例如财经日历接口会返回类似： 在另一个项目中使用 方式一：先安装 SDK。 然后在任意 Python 项目中： 客户端入口 创建客户端： 自定义请求头： 上下文管理： Base URL 配置 默认值： 全局修改，影响之后创建的新客户端： 只修改某个客户端： SDK 会规范化 URL， https://host/gateway 和 https://host/gateway/ 都可以。 返回类型 默认返回 pandas DataFrame ： 返回 Python 行数据： 返回服务端完整 JSON： SDK 默认会优先从常见响应结构中提取表格数据： - data.records - data.items - 顶层 items - 顶层数组 如果响应不是表格结构，SDK 会保留数据结构并转换为单行 DataFrame ，避免丢失字段。 字段筛选 fields 可以传列表或逗号分隔字符串： 字段筛选在 SDK 提取表格数据之后执行。 分页 分页接口同时支持传统 page/page size 和更方便的 limit/all pages 。 取最多 N 条： 当 limit 大于单页上限时，SDK 会自动分页并合并结果。 自动翻页： 精确指定页码： 通用翻页入口： 分页约束： - 大多数接口默认单页最大 200 。 - stk limit 和 stk premarket 单页最大 500 。 - page size 超过接口上限时，SDK 会直接抛出 ValueError 。 - limit 表示最终最多返回多少条，允许大于单页上限，SDK 会分多页请求。 常用调用示例 财经日历： 美股列表： A 股涨跌停价： 股票日内分时： 股票前收盘价： 查看可用接口 查看所有 SDK 方法： 查看某个接口的元数据： 当前 SDK 会为每个已开放的接口生成对应的 Python 方法。 异常处理 异常类型： - FtshareHTTPError ：HTTP 非 2xx。 - FtshareDecodeError ：响应不是合法 JSON。 - FtshareAPIError ：服务端业务状态码失败。 测试 本地单元测试使用 mock HTTP，不依赖线上服务： 真实","default_branch":null,"files":null,"tree":[],"storefront":"/r/FTShare-Lab","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/FTShare-Lab/FTShare-python-sdk/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}