企业微信

注册Tushare账户获取基础权限

进入Tushare官方网站后，用户需完成邮箱注册流程。填写有效电子邮箱地址并设置密码，系统将发送验证链接。点击链接激活账户后，登录平台进入个人主页。在“我的数据”或“接口权限”栏目中，系统默认授予用户基础数据访问权限。该权限包含A股日线行情、交易日历、股票列表等公开信息，适用于大多数初级量化策略回测需求。注册完成后，首要任务是获取专属的API Token。该字符串是调用数据接口的身份凭证，需在代码中配置使用。

获取并配置API Token

在个人中心页面，找到“Token管理”选项，系统已自动生成一串唯一识别码。复制该Token，在本地Python环境中进行配置。推荐使用tushare官方提供的SDK，通过pip安装库文件：

Tushare数据接口如何开通免费价格服务


import tushare as ts

# 配置Token

ts.set_token('your_token_here')

完成配置后，创建Pro API实例即可发起数据请求。首次使用者可通过pro_api()方法建立连接。若未报错且返回对象正常，说明认证成功。该Token具有访问控制功能，用户可在后台查看调用记录与频率限制状态。

查询股票历史价格数据

调用daily接口可获取沪深市场个股的日级别行情。输入股票代码与时间范围参数，系统返回开盘价、最高价、最低价、收盘价、成交量、成交额等字段。支持一次性查询单只或多只股票的历史序列，适用于构建价格矩阵用于技术指标计算。对于需要复权处理的数据，接口提供前复权、后复权及不复权三种模式选择，确保回测结果准确性。


pro = ts.pro_api()

# 获取贵州茅台2023年日线数据

df = pro.daily(ts_code='600519.SH', start_date='20230101', end_date='20231231')

print(df.head())

返回结果按日期倒序排列，用户可根据实际需求调整排序方式。高频策略研究者还可尝试调用minutely相关扩展接口（如有权限），获取分钟级粒度的价格变动。

获取期货合约行情信息

期货市场数据通过fut_daily接口提供。该接口覆盖国内四大期货交易所的主要品种，包括上海期货交易所、大连商品交易所、郑州商品交易所和中金所。输入合约代码或交易品种标识，可提取结算价、持仓量、涨跌幅度等关键指标。由于期货存在主力合约换月机制，建议结合fut_basic接口获取合约基本信息表，筛选有效交易标的。


# 查询螺纹钢主力合约2023年行情

fut_data = pro.fut_daily(ts_code='RB.FUT', start_date='20230101', end_date='20231231')

部分高级用户可能需要连续合约数据，可通过编写rollover逻辑拼接不同月份合约形成虚拟连续线。Tushare亦提供部分预处理后的连续合约代码，简化数据准备流程。

设置调用频率与异常处理机制

免费用户享有每分钟20次的基础请求额度，超出将触发限流。为避免中断，程序中应加入异常捕获与重试逻辑。利用try-except结构捕捉网络超时或状态码错误，并设置合理的时间间隔暂停。对于大规模数据拉取任务，可采用分批循环方式，每次请求限定时间段内的数据块，最终合并成完整数据集。


import time

def fetch_with_retry(func, max_retries=3, **kwargs):

    for i in range(max_retries):

        try:

            return func(**kwargs)

        except Exception as e:

            if i == max_retries - 1:

                raise e

            time.sleep(60)  # 等待一分钟再试

此机制保障长时间运行脚本的稳定性，尤其适用于跨日批量下载场景。

数据存储与本地化管理

原始返回数据通常为pandas DataFrame格式，可直接导出为CSV文件保存至本地目录。更高效的方案是导入SQLite或MySQL数据库，建立索引加速后续查询。针对高频更新需求，设计自动化定时任务每日增量获取前一日行情，保持本地仓库同步。数据库表结构应包含唯一索引约束，防止重复插入造成数据冗余。

升级权限以获取更多资源

虽然基础功能已满足一般分析需求，但更高频次访问、tick级数据、财务报表、资金流向等深度内容需提升账户等级。用户可通过参与社区贡献、邀请注册或订阅专业版服务解锁进阶权限。部分机构用户还可申请定制化数据接口支持，适配特定投研系统架构。

Tushare作为国内主流金融数据平台之一，持续优化API响应速度与数据覆盖广度。其免费层为个人投资者与初学者提供了低门槛入口，助力快速搭建从数据获取到策略验证的完整链条。合理规划调用策略与本地缓存机制，能最大化利用现有资源实现高效研究目标。