Northbound Holdings
Daily stock-level holdings of northbound (Stock Connect) investors, reporting the share quantity and percentage of outstanding shares held by foreign capital in each A-share, along with the Connect channel (Shanghai/Shenzhen). It lets you track day-by-day foreign accumulation or reduction at the single-name level and is the core dataset for bottom-up analysis of overseas positioning preferences. Updated each trading day; the holding ratio is a percentage and is best read against free-float share counts.
GET /v2/flows/northbound-holdingsParameters
Name
Type
Required
Description
symbol
string
No
Stock code, e.g. 000001.SZ
start_date
string
No
Start date (YYYYMMDD)
end_date
string
No
End date (YYYYMMDD)
trade_date
string
No
Trading date YYYYMMDD (single day)
Response Fields
Field
Type
Description
trade_date
string
Trading date
symbol
string
Stock code
name
string
Stock name
vol
number
Shares held
ratio
number
% of total shares
exchange
string
Exchange (SH/SZ)
API Example
cURL
curl -H "X-API-Key: YOUR_KEY" \
"https://asharehub.com/v2/flows/northbound-holdings?symbol=000001.SZ"Python SDK
from asharehub import AShareHub
client = AShareHub(api_key="YOUR_KEY")
df = client.northbound_holdings(symbol="000001.SZ")
print(df.head())Sample Data
returns a pandas.DataFrame
| trade_date | symbol | name | vol | ratio | exchange |
|---|---|---|---|---|---|
| 20251231 | 000001.SZ | 平安銀行 | 628291149 | 3.23 | SZ |
| 20250930 | 000001.SZ | 平安銀行 | 707394198 | 3.64 | SZ |
| 20250630 | 000001.SZ | 平安銀行 | 829114531 | 4.27 | SZ |
Esc