Building an AI agent? Start with /llms.txt for the full site index.
Capital Flows
Coming soon — a combined chip-flow view per stock per trading day. The aggregation pipeline is still being built, so this dataset does not return rows yet.
GET /v2/datasets/chip-flowschip-flows is being built: it will combine the official TWSE institutional flows and margin trading balances into a single per-stock daily view of who is accumulating or distributing. The aggregation ETL is not live yet, so the endpoint currently returns no rows — the fields below are the planned schema, not a served response. It will move off "Building" once the pipeline backfills.
| Field | Type | Description |
|---|---|---|
symbol | string | Ticker. |
date | string | Trading date. |
institutional_net | number | Combined three-investor net for the stock (shares). |
margin_change | number | Day-over-day change in margin balance (shares). |
short_change | number | Day-over-day change in short balance (shares). |
source_role | string | Canonical source role (derived_twse_chip_flows). |
TODO — exact row / symbol counts and the coverage window are pending a measured snapshot; the indicators are computed from the official TWSE institutional-flow (T86) and margin trading reports (present through the latest trading day). No counts are shown rather than fabricated ones.
TODO — no real response has been captured for this dataset yet. It needs an entitled API key, or its required parameters are not yet known. Rather than show an example nobody has observed, this section stays empty.
curl "https://api.twmarketdata.com/v2/datasets/chip-flows?symbol=2330" \ -H "X-API-Key: sk_live_..."| Parameter | Required | Type | Description |
|---|---|---|---|
symbol | Yes | string | Ticker, e.g. 2330. |
start_date | No | string (YYYY-MM-DD) | Start of the query range. |
end_date | No | string (YYYY-MM-DD) | End of the query range. |
limit | No | integer | Maximum rows to return. |
A first call:
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/chip-flows", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())With a date-range filter:
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/chip-flows", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())This endpoint is GET /v2/datasets/chip-flows. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.