AI agent？先讀 /llms.txt 取得全站索引。
總體經濟
競貨幣匯率:每日三種亞洲出口競爭貨幣(日圓、韓元、人民幣)之美元匯率與美元/新台幣,並換算每新台幣交叉匯率。僅座標、無訊號。衍生自央行官方匯率。非預測、非建議。
GET /v2/datasets/competitor-fx即將開放——此資料集建置中,尚未可透過 API 查詢。下方涵蓋與誠實限制為真實資料庫狀態;serving 上線(預計 8/1)後脫離「建置中」。
| 欄位 | 型別 | 說明 |
|---|---|---|
usd_jpy | rate | |
usd_krw | rate | |
usd_cny | rate | |
usd_twd | rate | |
jpy_per_twd | rate | cross |
krw_per_twd | rate | cross |
cny_per_twd | rate | cross |
8,324 列,1993-01-05 至 2026-06-30。每新台幣交叉為美元腿之算術換算(derivation_method 記錄公式);央行官方定盤,某腿缺漏日該交叉為 NULL。
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "competitor-fx", "row_count": 3, "data": [ { "rate_date": "2026-06-30", "usd_jpy": 162.26, "usd_krw": 1553.5, "usd_cny": 6.7852, "usd_twd": 31.837, "jpy_per_twd": 5.096586, "krw_per_twd": 48.795427, "cny_per_twd": 0.213123 }, { "rate_date": "2026-06-29", "usd_jpy": 161.82, "usd_krw": 1543.7, "usd_cny": 6.7929, "usd_twd": 31.845, "jpy_per_twd": 5.081488, "krw_per_twd": 48.475428, "cny_per_twd": 0.213311 }, { "rate_date": "2026-06-26", "usd_jpy": 161.62, "usd_krw": 1540.4, "usd_cny": 6.7997, "usd_twd": 31.86, "jpy_per_twd": 5.072819, "krw_per_twd": 48.349027, "cny_per_twd": 0.213424 } ]}擷取自 2026-07-20 的線上 API。
curl "https://api.twmarketdata.com/v2/datasets/competitor-fx?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 是 | string | 股票代碼，例如 2330。 |
start_date | 否 | string (YYYY-MM-DD) | 查詢起始日期。 |
end_date | 否 | string (YYYY-MM-DD) | 查詢結束日期。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/competitor-fx", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/competitor-fx", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/competitor-fx。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。