Global macro

Overview

macro-global returns one row per indicator per period for global macro series compiled from international bodies. It is international-source context to sit alongside the Taiwan-market data, not a TWSE feed; each row carries its source role and lineage so the upstream authority is explicit.

Coverage

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-global?series_id=GDP" \  -H "X-API-Key: sk_live_..."

Filtering

Python

A first call:

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

OpenAPI

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

Notes & limitations

• This is international-source macro context, not TWSE market data — use it to frame the Taiwan datasets, not as an exchange feed.
• For this macro dataset the symbol param is an indicator code (e.g. gdp_growth), not a stock ticker.