twelvedata-python

twelvedata-python 是 Twelve Data 金融 API 和 WebSocket 服务的官方 Python 客户端。它需要 Twelve Data API 密钥；README 指出 WebSocket 访问适用于 Pro 及以上套餐。 该库可获取股票、外汇、加密货币、ETF 和指数的 OHLC 时间序列。它还提供报价、实时和收盘价格、汇率以及货币换算。基本面方法涵盖公司简介和徽标、股息、拆股、收益和日历、IPO 日历、统计数据、内部交易、利润表、资产负债表、现金流、高管以及机构或基金持有人。 时间序列请求支持包括 symbol、interval、exchange、MIC code、country、output size、timezone、start 和 end dates 以及 sort order 在内的参数。结果可以以 JSON、CSV、pandas DataFrame 或请求 URL 的形式返回。100 多种技术指标可以链式添加到时间序列请求中，并且当只需要指标时，可以排除 OHLC 数据。 批量请求接受逗号分隔的字符串或 symbol 列表，每次 API 调用最多支持 120 个 symbol。批量输出支持 JSON 和 pandas 格式，包括按 symbol 和 datetime 的 MultiIndex DataFrame。 可选依赖增加了图表和流式传输功能。静态图表使用 matplotlib 和 mplfinance，交互式图表使用 Plotly。WebSocket 客户端为股票、外汇和加密货币提供事件驱动的流，并具有订阅、取消订阅、重置订阅、连接、断开连接和发送心跳的方法。 高级功能包括向自定义 Twelve Data 端点发送请求、检查当前 API 额度使用情况，以及生成用于调试的底层 URL。该包通过 pip 安装，并在 MIT 许可证下分发。