TW Market Data LogoTW Market Data

Core data

Market & prices

TWSE / TPEx daily bars, adjusted prices, indices, and market breadth

Financials & growth

Monthly revenue, the three financial statements, financial metrics, and valuation data

Flows & positioning

Institutional investors and margin & short-selling data

Company & structure

Company & events

Company profiles, disclosures, events, corporate actions, and dividends

Taxonomy & structure

Theme taxonomy, index classification, and cross-dataset mapping

Strategy & quant

Features, factor data, time alignment, and screener

Platform capabilities

API access

REST API, authentication, and your first request

Query & tools

Search API, Query API, field lists, and query examples

Tools / MCP

Agent workflows, MCP tools, and the OpenAPI entry point

PricingDocsBlog
中文Dashboard

TW Market Data (TWMD) provides historical data and statistics, not investment advice; investment decisions and their risks are your own.

Privacy Policy|Terms of Service|Help Center||中文|TW Market Data © 2026

Documentation

DASHBOARD

DashboardPricing

FOR AI AGENTS

MCP Serverllms.txtTool manifestOpenAPI SpecAgent workflow examples
WebhooksBuilding

OVERVIEW

OverviewQuick startAuthenticationSource policyData gradesData lineageMarket coverage

DATA APIS

Index dataMarket indicesUnified daily pricesTPEx daily pricesTWSE daily pricesEx-rights & dividend adjustment factorsPrice-limit (daily)Return index (daily)Adjusted pricesIndex constituentsMarket breadthCore valuation (daily)Valuation dataTechnical indicatorsIndex classificationMarket overview snapshots

GUIDES

How to get the 3 financial statementsHow to read institutional flowsHow to check market statusHow to wire a strategy / AI agent

SDKS

Release statusPython SDKJavaScript / TypeScript SDK

Building an AI agent? Start with /llms.txt for the full site index.

Market & Prices

Index constituents

Index constituents — the member securities of each index with their weights, resolved from the official index and market data.

DerivedSource: TWSE·Plan: free·Cost: 2 credits·GET /v2/datasets/index-constituents

Overview

index-constituents returns one row per member security of an index, with the weight it carries. It is a derived surface: the membership comes from the official index definition and the weights are computed from official market data, so a constituent list is reproducible rather than opaque. Each row carries lineage back to those inputs.

FieldTypeDescription
index_codestringIndex code the constituents belong to.
symbolstringConstituent ticker.
weight_pctnumberWeight of the constituent in the index (percent, derived).
as_ofstringData date the membership was resolved against.
source_rolestringCanonical source role (derived_index_constituents).

Coverage

Rows546
Window2026-07-01 (single-day snapshot)
GradeDerived

Example response

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.

Getting started

  1. Put your key in the X-API-Key header.
  2. Add query parameters (symbol, date range, limit).
  3. Send the request and read the returned payload.
curl "https://api.twmarketdata.com/v2/datasets/index-constituents?symbol=2330" \  -H "X-API-Key: sk_live_..."

Filtering

ParameterRequiredTypeDescription
symbolYesstringTicker, e.g. 2330.
start_dateNostring (YYYY-MM-DD)Start of the query range.
end_dateNostring (YYYY-MM-DD)End of the query range.
limitNointegerMaximum rows to return.

Python

A first call:

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/index-constituents",    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/index-constituents",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

OpenAPI

This endpoint is GET /v2/datasets/index-constituents. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.

Notes & limitations

  • For this dataset the symbol param is an index code (e.g. IX0001), which selects the index whose constituents you want. Weights are derived and change with prices — pin as_of to reproduce a membership snapshot.

Request & Response

Request

curl "https://api.twmarketdata.com/v2/datasets/index-constituents?symbol=2330&start_date=2026-01-01&end_date=2026-06-30&limit=5" \  -H "X-API-Key: $TWMD_API_KEY"

Authenticate with the X-API-Key header, using a sk_live_ key issued in the dashboard.

Response

TODO — no response has been captured for this dataset yet (it needs an entitled key, or its required parameters are not yet known). No example is shown rather than an invented one.

The grade badge on this page is a documentation classification, not a response field.