文件

API 參考

最常用的驗證、資料集與請求範例。

總覽#

回應固定包含 dataset、source_role、lineage、data、errors。

驗證#

Header

X-API-Key: <API_KEY>

帳號與授權狀態可由 `/v2/account/entitlements` 檢視。

資料集#

目前 available now:26 個 sellable-now datasets(含財報三表、技術指標、法人流、融資融券、指數成分、ETF flow、衍生性商品、可轉債、結構化事件、公司/市場新聞與主題 taxonomy)。

對外語義維持 controlled rollout;billing 仍為 preview semantics,避免誤判為 full public GA。

請求範例#

Request

GET /v2/datasets/issuer-profile?ticker=2330&limit=1

Response

{
  "dataset": "issuer-profile",
  "source_role": "canonical",
  "lineage": { "provider": "TWSE/TPEx" },
  "data": [{ "ticker": "2330", "issuer_name": "台積電" }]
}

Account surfaces

  • `GET /v2/product/catalog`
  • `GET /v2/account/entitlements`
  • `GET /v2/account/usage-summary?window=month`
  • `GET /v2/account/billing-preview?window=month`(preview only)