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

Interest-rate snapshotBusiness indicator (monthly)Global macroWorld Bank macro

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.

Macroeconomics

World Bank macro

World Bank development indicators — long-run cross-country macro series sourced directly from the World Bank.

VerifiedSource: World Bank·Plan: pro·Cost: 2 credits·GET /v2/datasets/macro-worldbank

Overview

macro-worldbank returns one row per indicator per year for World Bank development indicators. It is international-source macro context, not a TWSE feed; each row names the World Bank indicator code in its lineage so a value can be reconciled against the original World Bank series.

FieldTypeDescription
indicatorstringWorld Bank indicator code (e.g. NY.GDP.MKTP.CD).
countrystringISO country / region code.
yearintegerReference year.
valuenumberIndicator value for the year.
source_rolestringCanonical source role (worldbank_indicator).
lineageobjectUpstream World Bank indicator + release for the value.

Coverage

Rows1,362,467
Window1960 – 2025
GradeVerified

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/macro-worldbank?country=TWN" \  -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/macro-worldbank",    params={"country": "TWN"},    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/macro-worldbank",    params={"country": "TWN"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

OpenAPI

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

Notes & limitations

  • This is World Bank international-source macro context, not TWSE market data — annual cadence with a reporting lag, so the latest year trails the current one.
  • For this macro dataset the symbol param is a World Bank indicator code (e.g. NY.GDP.MKTP.CD), not a stock ticker.

Request & Response

Request

curl "https://api.twmarketdata.com/v2/datasets/macro-worldbank" \  -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.