---
title: "全市场单日 K 线（一次拿全 A 股某日行情）"
method: GET
path: "/v1/market-kline"
---

# 全市场单日 K 线（一次拿全 A 股某日行情）

`GET /v1/market-kline`

## Request

- Base URL: `https://api.ashareapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ashareapi.com/v1/market-kline`
- Auth: none declared

**一次请求返回全市场（5000+ 只 A 股）在某一交易日的日线** —— 适合「每日增量更新全市场」，替代逐只调用（省 5000+ 次请求）。

典型用法：每天收盘后调一次，取当日全市场 K 线入库。
```
GET /v1/market-kline?date=2026-09-30
```

⚠️ **两种限定（务必看清）**：
| | 说明 |
|---|---|
| 档位 | **仅 `pro`（¥99）与 `unlimited`（¥199）** —— `standard` 及以下不可用 |
| 计费 | **1 次调用 = 折算 500 次额度**（一次动 5000+ 只，量级远超单只接口）|

⚠️ 日额度：`pro` 200 次/日 · `unlimited` 1000 次/日（另计，见重型额度）。
⚠️ 字段固定 7 列：`code` `time` `open` `high` `low` `close` `volume` `amount`（**不复权原始价**）。
⚠️ 数据范围：**2016-08-08 起**、**仅 A 股股票**（5572 只）—— 不含 ETF / 可转债 / 指数 / 板块 / 港股 / 美股。数据由官方 dump 每日增量维护，**最新可到前一交易日**（当日盘中数据不可用）。
⚠️ 体积：单日全市场约 **785 KB**（实测 5560 只）。

## Query parameters

- `date` string, required: 交易日 YYYY-MM-DD（如 2026-09-30；⛔ 非交易日返回空）
- `limit` integer: 分页：每次最多返回 N 只（0 = 全部 5000+ 只）
- `offset` integer: 分页偏移（配合 limit 使用）
- `codes` string: 可选：只取指定股票，逗号分隔（如 sh600519,sz000001；省略 = 全市场）

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)
