---
title: "ETF 数据（概览/详情/持仓/净值/公司/持有人/财务）"
method: GET
path: "/v1/etf"
tags: ["pro"]
---

# ETF 数据（概览/详情/持仓/净值/公司/持有人/财务）

`GET /v1/etf`

## 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/etf`
- Auth: none declared

ETF 行情/规模/溢折率/资金流。code 形如 sh510300。用户问『ETF』时用。`kind` 选子集：**概览**（默认，行情+规模+溢折率+资金流+回撤+估值） / 详情（基金要素+费率+份额） / 持仓（成分股及权重） / 净值（历史**单位净值**，4 位小数，**须同时传 `start`+`end`**；含 `closePrice` 可自算折溢价） / 公司（管理人+托管人+跟踪指数） / 持有人（户数+机构个人占比） / 财务（资产配置：股/债/商品/基金占比）。⚠️ 响应 `data` 是上游排版文本；**字段请取 `structured`（首表）或 `tables`（全部表）** —— `详情`/`公司` 是多表（含基金经理），只有 `tables` 能拿全。⚠️ **仅 ETF 代码**：传个股代码返回 `ok:false`（**不扣次数**），不再给全 0 空壳 —— 代码不确定请先用 `/v1/search` 或 `/v1/hot?type=etf` 确认。⚠️ 代码可传裸 6 位 `510300` 或带前缀 `sh510300`，结果一致。

## Query parameters

- `code` string, required: ETF 代码：sh510300
- `kind` string: 概览(默认)/详情/持仓/净值/公司/持有人/财务
- `start` string: 仅 kind=净值：起始日 YYYY-MM-DD
- `end` string: 仅 kind=净值：结束日 YYYY-MM-DD

## 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)