Get institutional investor trading (三大法人)
get_institutional_tradingRetrieve net buy/sell data for Taiwan's three institutional investor groups (foreign, trust, dealer) on TWSE and TPEx stocks, for a single trading day or up to 23 days, including per-stock figures and market-wide rankings.
Instructions
Net buying/selling by Taiwan's three institutional investor groups (三大法人): foreign investors (外資), investment trusts (投信) and dealers (自營商), for TWSE and TPEx. Covers one trading day by default. For a period, set start (e.g. the 1st of the month for "this month", the Monday for "this week") or days (number of trading days, e.g. 5 for "recently"), up to 23 trading days; figures then become totals over the period, with a daily breakdown per stock. With symbols: per-stock net shares for each group. Without symbols: the TWSE market-wide buy/sell totals in TWD plus the top net buyers and sellers (stocks and ETFs, both markets) ranked by rank_by. All per-stock figures are in shares (positive = net buy); total_net = foreign_net + trust_net + dealer_net. Rankings are by shares, so low-priced stocks rank higher than their TWD value suggests. Without date, the period ends on the most recent trading day with published data; exchanges publish after the close, around 15:00-16:30 Taipei.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_institutional_trading"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Last trading date of the period, YYYY-MM-DD. Default: latest available. | |
| days | No | Number of trading days ending at `date`, e.g. 5 for about a week. Default 1. Do not combine with start. | |
| limit | No | Rows per ranking. Default 10. | |
| start | No | First date of the period, YYYY-MM-DD; every trading day from here to `date` is included (max 23). Do not combine with days. | |
| market | No | Restrict rankings or symbol lookup to one market. | |
| rank_by | No | Group to rank by when symbols are omitted. Default "total". | |
| symbols | No | Codes or exact names, e.g. ["2330", "6488", "鴻海"]. Omit for the market summary and rankings. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Last trading date of the data (same as end_date) | |
| unit | Yes | ||
| notes | Yes | ||
| stocks | No | ||
| end_date | Yes | ||
| start_date | Yes | ||
| top_buyers | No | ||
| unresolved | No | ||
| top_sellers | No | ||
| trading_days | Yes | Trading days actually covered | |
| market_summary | No | TWSE market-wide totals in TWD over the period |