> Source: https://ashareapi.com/docs/  ·  Markdown version for LLMs / AI agents

3 步拿到数据

# 快速开始
 两种接入方式：一个 curl 直接调，或用官方 SDK 两行代码拿到 DataFrame。都不需要申请流程。

 1 拿到 Key
 免费端点无需 Key 即可试。要全量能力 → 获取 Key（见定价）。

```
# 免费端点直接调（无需 Key）
curl "https://api.ashareapi.com/v1/quote?code=sh600667"
```

 2 带上 Key 调接口
 推荐 Authorization 头（密钥不进日志/历史）；?key= 也支持，仅建议在浏览器里快速试

```
# 方式 A（推荐 —— 脚本/生产都用这个）：请求头
curl -H "Authorization: Bearer ct-你的KEY" \
 "https://api.ashareapi.com/v1/fund?code=sh600667"

# 方式 B（仅快速测试）：URL 参数 —— 直接粘到浏览器就能看
curl "https://api.ashareapi.com/v1/fund?code=sh600667&key=ct-你的KEY"
```

 3 看返回
 统一 JSON 信封：ok / endpoint / tier / elapsed_ms / source / data

```
{
 "ok": true,
 "endpoint": "fund",
 "tier": "pro",
 "elapsed_ms": 862,
 "source": "multi",
 "data": { "main_net": "...", "lhb": [...], ... }
}
```

 用官方 SDK：两行代码拿到 DataFrame
 Python 和 Node.js / TypeScript 都有官方包，返回结构与 REST 完全一致，可直接接进你的脚本、看板或策略代码。
 Python `pip install ashareapi`

```
from ashareapi import AShareAPI

cli = AShareAPI() # 免费端点无需 Key
df = cli.kline("sh600519", "day", 30)
```

 Node.js `npm install ashareapi`

```
import { AShareAPI } from 'ashareapi'

const cli = new AShareAPI() // 免费端点无需 Key
const rows = await cli.kline('sh600519', 'day', 30)
```

 代码要带小写市场前缀
 sh600519（沪）· sz000001（深）· bj920002（北交所）· hk00700（港股）· usAAPL（美股）。写成 600519、600519.SH 或大写 SH600519 都会返回空数据。

[代码格式速查](/wiki/code-format)

 需要全量能力？
 付费档最多解锁 94 个端点、单次最多 1212 根 K 线、不设单日上限。

[看定价](/pricing)

## 错误码
 出错时先看这张表 —— 大部分问题能自己解决。
 |
| | 码 | 含义 | 怎么办

| | 401 | API Key 无效 | Key 拼错 / 已禁用 → 检查 Key；或未带 Key 调了付费端点

| | 403 | 本 Key 今日已用过 N 个不同 IP | 触发 IP 维度反倒卖 → 换网络被误拦请联系我们重置

| | 429 | 超出频率限制（每分钟） | 降频或加间隔；标准版 120 次/分

| | 200 + ok:false | 数据源取数失败 | 已自动换下一个源，**不扣次数**；若持续请反馈（附 endpoint 与时间）

 401
 API Key 无效
 Key 拼错 / 已禁用 → 检查 Key；或未带 Key 调了付费端点

 403
 本 Key 今日已用过 N 个不同 IP
 触发 IP 维度反倒卖 → 换网络被误拦请联系我们重置

 429
 超出频率限制（每分钟）
 降频或加间隔；标准版 120 次/分

 200 + ok:false
 数据源取数失败
 已自动换下一个源，**不扣次数**；若持续请反馈（附 endpoint 与时间）

## 接入指引

 接进 AI Agent（MCP）
 一条配置让 Claude Code / Codex 等 Agent 直接查 A 股
[查看](/mcp)

 Agent Skill（45+ 客户端）
 一个文件夹装进 Claude Code / Cursor / Codex 等，AI 自动知道怎么用
[查看](/skill)

 国内平台接入（豆包 / 百炼 / 扣子 等）
 按平台逐家核对的步骤，填 URL 即可
[查看](/docs/mcp-china)

 AI 爬虫清单与校验
 国内外 AI 爬虫对照 + 官方 IP 段 / rDNS 校验 + 常见误封
[查看](/docs/ai-crawlers)

 从 Tushare 迁移
 接口对照表 + 四步改写 + 字段映射（含迁不了的部分）
[查看](/docs/migrate-from-tushare)

 教程与指南
 用 Python 取 A 股数据的可运行代码与取舍（含边界）
[查看](/docs/guides)

 每日 A 股报告
 盘前 / 午间 / 收盘三档客观整理，含 Markdown 版（可直接喂 AI）
[查看](/daily/)

 Python 调用
 示例代码见端点清单
[查看](/endpoints)

 数据源状态
 现在哪些能用，公开可查
[查看](/status)

 想看完整端点？
 94 个端点的参数与 curl / Python / JS 示例，一页看全。

[端点清单](/endpoints)