StockAPI 新手完全上手攻略
适用人群：刚接触量化交易、想自己写点代码分析行情、但还不知道用什么数据源的朋友。
官网地址：https://www.stockapi.com.cn
写作风格：纯新手视角，不讲虚的，只讲 “怎么才能跑起来”。

description

一、为什么选 StockAPI？（新手实话实说）
作为一个新手，我用过几个行情平台，感觉 StockAPI 比较适合我的点：
文档清楚：每个接口都有例子，复制就能跑。
价格透明：免费量足够新手练手，不用马上花钱。
支持多语言：Python、Java、JS 都有示例，学习成本低。
数据全：A 股、港股、美股、加密货币基本都覆盖了。
下面直接教你怎么注册、怎么拿到数据、怎么写第一行代码。
二、注册与准备（0 基础也能看懂）

  1. 注册账号
    打开官网 https://www.stockapi.com.cn
    点击右上角「注册」
    输入手机号 / 邮箱 → 设密码 → 验证码验证
    登录后台
    小建议：注册完立刻去 “个人中心” 改一下密码，绑定手机，这样账号更安全。
  2. 找到你的 API 密钥（关键）
    这是新手最容易卡的地方。
    登录后，左侧菜单找到 「个人中心」 → 「API 管理」
    点击「生成 API 密钥」
    填个名字（比如 “我的第一个密钥”）→ 选择权限（新手默认 “数据查询” 就行）
    生成后，API Key 和 Secret 会出现一次，务必保存到本地，不要泄露给别人！
    三、新手最常用的 3 个功能（先学会这 3 个就够了）
    功能 1：查实时行情（网页版不用写代码）
    适合不想写代码，只想看看行情的人。
    左侧菜单 → 「数据中心」 → 「实时行情」
    输入股票代码（比如贵州茅台：600519）
    可以看到：现价、涨跌幅、成交量、分时图、K 线图
    支持切换：日线、周线、月线、1 分钟、5 分钟等周期
    ✅ 新手体验：
    界面不复杂，图表清晰，适合快速看盘，比很多炒股软件更灵活。
    功能 2：查历史数据（用来做回测）
    新手想做策略，必须要有历史数据。
    左侧菜单 → 「数据中心」 → 「历史数据」
    选择市场、代码、时间范围（比如 2023-01-01 到 2026-01-01）
    选择数据类型：OHLCV（开盘价、最高价、最低价、收盘价、成交量）、基本面等
    点击查询 → 可查看表格，也可导出为 Excel/CSV
    ✅ 新手体验：
    导出的数据很干净，直接丢到 Excel 里就能做简单分析，不用自己写爬虫。
    功能 3：用 Python 调用 API（真正的量化开始）
    这是新手最容易卡壳的地方，我给你最简单的模板，复制改一下就能跑。
    步骤 1：安装依赖
    在电脑终端输入：
    bash
    运行
    pip install requests
    步骤 2：复制下面代码，替换你的 token 即可运行
    python
    运行
    import requests

1. 替换成你的 API Key

API_TOKEN = "你的APIKey"

2. 查询贵州茅台（600519）的日线数据

url = "https://www.stockapi.com.cn/v1/base/day"
params = {
"token": API_TOKEN,
"code": "600519",
"startDate": "2025-01-01",
"endDate": "2026-01-01"
}

3. 发送请求

response = requests.get(url, params=params)
data = response.json()

4. 打印结果看看

print(data)
运行后，你会得到一串 JSON 数据，包含日期、开盘价、收盘价、成交量等。
✅ 新手体验：
官方文档里有更多示例，比如获取分时数据、技术指标数据，新手可以慢慢尝试。
四、新手常见坑点（提前告诉你，少走弯路）

  1. API 密钥别泄露
    不要把 API Key 写到 GitHub 公共代码里，也不要发给别人，否则账号可能被滥用。
  2. 注意调用频率
    免费用户有频率限制，不要疯狂循环请求，容易被限流。
  3. 回测 ≠ 实盘
    平台提供策略回测工具，但回测结果是基于历史数据的，实际交易会有滑点、手续费等，不要盲目相信回测收益。
  4. 数据延迟
    行情数据可能有 1-5 分钟延迟，若需要更实时的数据，可以考虑升级会员。
    五、进阶玩法（新手以后可以慢慢加）
    等你熟悉基础后，可以尝试：
    策略回测：用平台提供的模板，自己设置买入卖出条件，测试策略历史收益。
    技术指标：调用 MACD、KDJ、BOLL 等指标数据，自动分析行情。
    Excel 导入：不用写代码，直接把行情数据导入到 Excel 做报表。
    多市场数据：尝试美股、港股、加密货币的数据，拓宽视野。
    六、总结（新手快速记忆）
    注册 → 登录 → 生成 API Key
    网页版看行情、导历史数据
    Python 复制示例代码，替换 Key 就能拿数据
    注意账号安全，别乱分享 API Key
    从简单任务开始，先跑通一个小例子，再逐步深入