Python调用股票API示例：iTick-sdk从安装到跑通只要五步

很多刚开始学量化或者想做个人小工具的朋友，第一次调用金融数据API经常卡在环境配置和认证这些前置步骤上，正经代码还没写几行，光是折腾"怎么把接口跑起来"就花掉半天。这篇给一个Python调用股票API的完整示例，用iTick的官方SDK，从安装到拿到第一条数据，五步搞定。

第一步：装SDK

pip install itick-sdk

一行命令，没有额外的依赖需要手动处理。

第二步：注册账号拿Token

去官网注册，登陆后台就能看到自己的API Token，这个token后面所有请求都要带上。

第三步：拉一次实时报价

from itick.sdk import Client

token = "your_api_token"
client = Client(token)

quote = client.get_stock_quote("US", "AAPL")
print(quote)

跑起来之后应该能看到一个包含最新价、开盘价、涨跌幅等字段的返回对象，如果这一步能正常出数据，说明token和网络都没问题，可以往下走了。

第四步：拉历史K线

kline = client.get_stock_kline("US", "AAPL", 8, 30)
for k in kline:
    print(k["t"], k["c"])

这段代码拿的是苹果最近30根日线的收盘价，kType传8对应日线周期，如果想要别的周期，改这个数字就行，具体对照表文档里都有。

第五步：订阅实时推送

import time

client.set_message_handler(lambda msg: print("推送:", msg))
client.connect_stock_websocket()
client.send_websocket_message('{"ac":"subscribe","params":"AAPL$US","types":"quote"}')

time.sleep(20)
client.close_websocket()

到这一步，一个能拉实时报价、能拉历史K线、还能订阅WebSocket推送的最小demo就跑完了，整个流程正常情况下十分钟以内能走完。

几个容易踩的小坑

第一，token不要写死在代码里直接提交到git仓库，用环境变量或者配置文件管理更安全；第二，免费套餐的REST接口有调用频率限制，写循环的时候别一股脑把频率打爆了，不然会被限流；第三，WebSocket订阅的params格式要注意，多个标的用逗号分割，单个标的的格式是代码$地区，格式写错的话订阅不会生效，但也不一定会报错，这个坑之前自己也踩过。

延伸参考

完整的接口列表和参数说明看文档：https://docs.itick.org。SDK源码（含更多语言版本入口）在GitHub：https://github.com/itick-org/java-sdk。注册入口：https://itick.org。