<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# A股实时行情

> A股实时行情与分时数据分析接口，覆盖沪深北交易所全部 A 股。

输入 6 位股票代码即可获取：实时行情快照（最新价、涨跌额/涨跌幅、振幅、换手率、量比、市盈率、市净率、总市值/流通市值）、当日分时数据（逐分钟 开/高/低/收、均价、成交量、成交额）、以及技术分析（趋势研判、强弱评分、振幅分级、逐分钟涨跌分布、VWAP 偏离度）。支持 full/simple 两种粒度，数据稳定、字段规范，适合行情展示、量化选股与投研场景。

免费额度：未登录每日 5 次；登录用户每日 50 次免费，超出部分按 ¥0.01/次计费（可用余额抵扣）；开通会员享更高额度与更大并发。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `stock-trend` |
| 接口名称 | A股实时行情 |
| 接口地址 | `https://v1.apizero.cn/api/stock-trend` |
| 请求方法 | `POST` |
| 分类 | finance |
| 提供方 | 极数本源 |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 5 req/s |
| 每日免费额度 | 50 次（已认证用户） |
| 匿名每日额度 | 5 次（无 API Key） |
| VIP 免费 | 是 |
| 调用总次数 | undefined |

## 2. 认证

未登录每日 5 次；登录用户（Authorization: Bearer <API Key>）每日 50 次免费，超出按 ¥0.01/次从余额扣费；开通会员享更高额度。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `code` | `string` | 是 | 6 位股票代码，可带 sh/sz 前缀 | `600519` |
| `type` | `string` | 否 | 返回粒度：full=完整分析（默认）/ simple=精简核心行情 | `full` |
| `limit` | `int` | 否 | 分时点返回数量，0=全部（默认），最大 240，>0 返回最近 N 个 | `30` |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `Authorization` | `string` | 否 | Bearer <你的 API Key>（登录用户额度更高） | — |

## 5. 请求示例

> AI 提示：以下 5 种语言示例都是可运行的，只需把 `YOUR_API_KEY` 替换为用户申请的实际 Key（https://apizero.cn/account/keys）。
> 优先选择用户问题中提到的语言；未指定时默认使用 Python。

### cURL

```bash
curl -X POST "https://v1.apizero.cn/api/stock-trend" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "600519",
  "type": "full",
  "limit": "30"
}'
```

### Python

```python
import requests

resp = requests.request(
    "POST",
    "https://v1.apizero.cn/api/stock-trend",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
    "code": "600519",
    "type": "full",
    "limit": "30",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())
```

### JavaScript (Node.js)

```javascript
// Node.js 18+ / 浏览器原生 fetch
const res = await fetch("https://v1.apizero.cn/api/stock-trend", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "code": "600519",
    "type": "full",
    "limit": "30"
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
```

### Go

```go
package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := []byte(`{"code":"600519","type":"full","limit":"30"}`)
	req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/stock-trend", bytes.NewBuffer(body))
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(string(out))
}
```

### PHP

```php
<?php
$payload = json_encode([
    "code" => "600519",
    "type" => "full",
    "limit" => "30",
], JSON_UNESCAPED_UNICODE);

$ch = curl_init("https://v1.apizero.cn/api/stock-trend");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        "X-Api-Key: YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_TIMEOUT        => 15,
]);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `stock` | `object` | 证券信息（代码/名称/市场/板块/交易状态/交易日/更新时间） | — |
| `quote` | `object` | 实时行情（最新价/开高低/昨收/均价/涨跌额/涨跌幅/振幅/换手率/量比/成交量额/市盈率/市净率/总市值/流通市值） | — |
| `change_status` | `object` | 涨跌状态（direction: up/down/flat、label、color 红涨绿跌） | — |
| `analysis` | `object` | 技术分析（趋势/趋势方向/振幅等级/强弱评分/逐分钟涨跌分布/上涨占比/VWAP 偏离度） | — |
| `minute` | `object` | 分时数据（count 实际点数、total 全天点数、list 逐分钟 时间/收/开/高/低/均价/量/额/涨跌幅） | — |
| `summary` | `string` | 一句话行情摘要 | — |

## 7. 响应示例

```json
{
  "code": 0,
  "msg": "成功",
  "data": {
    "stock": {"code": "600519", "name": "贵州茅台", "market": "SH", "market_name": "上海证券交易所", "board": "主板", "trade_status": "交易中", "trade_date": "2026-07-01", "update_time": "2026-07-01 10:44"},
    "quote": {"price": 1190.0, "open": 1180.1, "high": 1191.99, "low": 1166.33, "pre_close": 1185.49, "avg_price": 1180.64, "change": 4.51, "change_percent": 0.38, "amplitude": 2.16, "turnover_rate": 0.15, "volume_ratio": 1.19, "volume": 18422, "volume_display": "1.84万手", "amount": 2168779690, "amount_display": "21.69亿", "pe_ttm": 13.65, "pb": 6.31, "total_mv": 1487597105190, "total_mv_display": "1.49万亿"},
    "change_status": {"direction": "up", "label": "上涨", "color": "#EB5454"},
    "analysis": {"trend": "震荡上行", "trend_direction": "up", "amplitude_level": "小幅波动", "strength": {"level": "较弱", "score": 2, "max_score": 5}, "up_minutes": 40, "down_minutes": 30, "flat_minutes": 5, "up_ratio": 53.3, "vwap_deviation": 0.79},
    "minute": {"count": 75, "total": 241, "list": [{"time": "09:31", "price": 1184.88, "open": 1180.1, "high": 1184.95, "low": 1177.5, "avg": 1180.64, "volume": 562, "amount": 66354042, "change_percent": -0.05}]},
    "summary": "贵州茅台今日上涨0.38%，现价1190.00元，振幅2.16%，换手0.15%，整体呈震荡上行态势，波动强度较弱。"
  },
  "request_id": "abc123"
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `4000` | `VALIDATION_ERROR` | 股票代码格式错误，或代码无效（未找到对应证券） |
| `4022` | `INSUFFICIENT` | 免费额度已用完且余额不足，请充值或开通会员 |
| `4029` | `RATE_LIMITED` | 调用过快，请稍后再试 |
| `4030` | `QUOTA_EXCEEDED` | 今日额度已用完（未登录用户请登录以获得更高额度） |
| `5020` | `UPSTREAM_ERROR` | 行情服务暂不可用 |
| `5021` | `UPSTREAM_INVALID` | 行情数据格式异常 |

## 9. 变更日志

- **v1.0** (2026-07-01)
  - 首次上线：实时行情快照 + 当日分时数据 + 技术分析（趋势/强弱/振幅/涨跌分布/VWAP 偏离），支持沪深北 A 股。

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/stock-trend`

Source: `https://apizero.cn/aidocs/stock-trend/raw.md`
Last updated: 2026-07-01T10:57:33+08:00