---
title: "北向持股明细"
method: GET
path: "/v1/flows/northbound-holdings"
tags: ["资金流向"]
---

# 北向持股明细

`GET /v1/flows/northbound-holdings`

## Request

- Base URL: `https://quantsonar.com`
- URL: `https://quantsonar.com/v1/flows/northbound-holdings`
- Auth: API key in header `X-API-Key`

披露节奏说明：港交所自 2024 年 8 月起不再每日披露北向持股明细，本接口数据为港交所定期披露口径（低频），历史每日数据完整保留。查询建议不带日期或用较宽日期范围。

## Query parameters

- `symbol` string, nullable: 证券代码（带后缀），如 000001.SZ
- `start_date` string, nullable: 起始日期 YYYYMMDD
- `end_date` string, nullable: 结束日期 YYYYMMDD
- `trade_date` string, nullable: 单个交易日 YYYYMMDD（与 start/end 二选一）

## Response `200`

Successful Response

- object[]
  - `trade_date` unknown
  - `symbol` unknown
  - `name` unknown
  - `vol` unknown
  - `ratio` unknown
  - `exchange` unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/quantsonar/apis/quantsonar-agent-data-api.md) · [All operations](https://skmtc.dev/quantsonar/apis/quantsonar-agent-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quantsonar/apis/quantsonar-agent-data-api/revisions/1457cc05fb2b?raw)
