![us-stock-api.png](https://developer.qcloudimg.com/http-save/yehe-2926320/e926d7d1b3d5e8965c3b742e48db3407.png)

## 环境准备与数据源选择

先装 SDK：

```bash
pip install itick-sdk
```


为什么选 itick？其实社区里还有很多优秀的金融数据 API，但 itick 的免费套餐已经覆盖了美股、港股、A股等主流市场的实时数据和历史K线。REST 接口每分钟可以调用 5 次，WebSocket 允许 1 条连接、订阅 3 个标的。这个额度对学习、原型测试基本够用，实测下来延迟也在可接受范围内。如果你需要更高频的查询，官方也提供了 600 次/分钟、6 条连接等更高配置的付费方案，按需升级就好。

---

## 1. 获取实时报价（REST）

```python
from itick.sdk import Client

token = "your_api_token"
client = Client(token)

# region 填 US 代表美股市场
quote = client.get_stock_quote("US", "AAPL")
print("苹果最新报价：", quote)

tick = client.get_stock_tick("US", "TSLA")
print("特斯拉 Tick：", tick)
```

`region` 参数传 `"US"` 即可，SDK 底层会自动拼接成完整请求。返回的字段里，`ld` 是最新价，`o/h/l` 是开、高、低，`ch/chp` 是涨跌额和涨跌幅，和券商 App 看盘时的数据基本一致。

---

## 2. 获取历史 K 线

美股支持从 1 分钟到月线的多种周期，参数 `kType` 的取值整理如下：

| kType | 含义 |
|-------|------|
| 1     | 1 分钟 |
| 2     | 5 分钟 |
| 3     | 15 分钟 |
| 4     | 30 分钟 |
| 5     | 1 小时 |
| 8     | 1 天 |
| 9     | 1 周 |
| 10    | 1 月 |

拉取苹果最近 10 根 5 分钟 K 线的代码：

```python
kline = client.get_stock_kline("US", "AAPL", kType=2, limit=10)
print("K线数据：", kline)
```

每条 K 线包含 `t`（时间戳）、`o/h/l/c`（开高低收）、`v`（成交量）和 `tu`（成交额），画个简单的走势图完全够用。

---

## 3. WebSocket 实时推送

盯盘、量化实盘等场景下，反复轮询 REST 接口很容易触碰频率上限，而且效率不高。更好的方式是使用 WebSocket，让服务端主动推送数据。itick 的 SDK 已经封装好了连接、心跳和自动重连。

下面是一个完整的订阅例子，同时接收苹果和特斯拉的报价与盘口数据：

```python
import time

def on_message(message):
    print(f"收到推送: {message}")

def on_error(error):
    print(f"WebSocket 出错: {error}")

client.set_message_handler(on_message)
client.set_error_handler(on_error)

# 建立 WebSocket 连接
client.connect_stock_websocket()

# 订阅 AAPL（US 市场）和 TSLA（NASDAQ 交易所，US 市场）
subscribe_msg = '{"ac":"subscribe","params":"AAPL$US,TSLA$NASDAQ$US","types":"quote,depth"}'
client.send_websocket_message(subscribe_msg)

# 保持连接一段时间，实际项目中可以改成事件循环
time.sleep(30)

print("当前连接状态：", client.is_websocket_connected())
client.close_websocket()
```

关于订阅参数：
- `params` 格式为 `代码$地区`。如果同一市场内有多个交易所需要区分，可以写成 `代码$交易所$地区`。
- `types` 可选 `tick`（逐笔成交）、`quote`（实时报价）、`depth`（十档盘口）、`kline`（K线推送，其中 1 分钟粒度的 kline@1 目前仅对 Premium 及以上套餐开放）。

SDK 还内置了心跳机制（默认每 30 秒 ping 一次），一旦因网络抖动断线，会自动按 5 秒间隔重连，最多尝试 10 次。重连成功后，之前的订阅关系也会自动恢复。这个小设计在搭建实时监控时省了不少事。

---

## 常见问题

**Q：免费套餐能支撑日常开发吗？**  
如果只是个人学习、搭建原型或者跑一些低频策略，每分钟 5 次 REST 调用、1 条 WebSocket 连接基本足够。当策略需要监控更多标的或更高频的数据时，再考虑升级到更高级别的套餐。

**Q：数据延迟表现怎么样？**  
itick 官方给出的延迟参考是毫秒级推送。我在本地测试下来，做盯盘工具和实时计算的延迟感知很小，符合一般量化的要求。当然实际体验也和你的服务器位置、网络环境有关。

**Q：一条 WebSocket 连接可以订阅多少个标的？**  
单条连接最多支持 500 个标的。如果你监控上千只美股，可以按逻辑拆分成多条连接，或者联系客服调整连接数上限。

---

## 结语

本文用 itick 的 Python SDK 演示了美股实时行情和历史 K 线的基本接入流程：REST 负责一次性或低频查询，WebSocket 负责持续的实时推送。两条链路配合使用，基本能覆盖选股、盯盘、策略回测等场景。整个流程从注册、拿到 Token 到跑通第一条 WebSocket 推送，通常半小时内能搞定。

更详细的字段说明、批量请求接口以及 Java/Go/Node.js 等语言的 SDK，可以查阅 [itick 文档中心](https://docs.itick.org)。希望这篇文章能帮你少走一点弯路，快速把数据层搭起来。

> 免责声明：本文仅用于技术交流与学习，不构成任何投资建议。

为什么选 itick？其实社区里还有很多优秀的金融数据 API，但 itick 的免费套餐已经覆盖了美股、港股、A股等主流市场的实时数据和历史K线。REST 接口每分钟可以调用 5 次，WebSocket 允许 1 条连接、订阅 3 个标的。这个额度对学习、原型测试基本够用，实测下来延迟也在可接受范围内。如果你需要更高频的查询，官方也提供了 600 次/分钟、6 条连接等更高配置的付费方案，按需升级就好。

美股量化数据接入实战：低成本获取实时行情与历史K线

金融数据 API覆盖了美股、港股、A股等主流市场的实时数据和历史K线。REST 接口每分钟可以调用 5 次，WebSocket 允许 1 条连接、订阅 3 个标的。这个额度对学习、原型测试基本够用，实测下来延迟也在可接受范围内。

前端

itick金融数据API提供美股、港股、A股实时行情和历史K线数据，支持REST和WebSocket两种接入方式。免费套餐包含每分钟5次REST调用和1条WebSocket连接，适合个人学习和策略开发。SDK封装了自动重连和心跳机制，简化实时数据订阅流程，帮助开发者快速搭建量化交易数据层。

腾讯云大数据特惠0.2折起


oceanus

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

美股量化数据接入实战：低成本获取实时行情与历史K线-腾讯云开发者社区-腾讯云

美股量化数据接入实战：低成本获取实时行情与历史K线

美股量化数据接入实战：低成本获取实时行情与历史K线

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐