幫助中心

登入 dashboard 後進入 API 金鑰區塊，建立新金鑰並立即複製。請妥善保存，若外洩請立即撤銷並重建。

使用 HTTPS GET 呼叫 /v2/datasets/* 端點，並在 header 帶入 X-API-Key。可先參考 /docs/quick-start 的範例。

可從 /v2/datasets/twse-daily-price 或 /v2/datasets/tpex-daily-price 開始，帶入 symbol 與 limit 等查詢參數。

每次請求都會回傳 X-Request-Id，方便追蹤錯誤、對帳與客服排查。

每個 dataset endpoint 會對應固定成本，回應 header 會帶 X-TWMD-Credits-Cost（試算或實扣依模式而定）。

多半是上游 backend timeout、冷啟動或暫時性服務波動。可記錄 requestId，稍後重試或聯繫我們。

先設定 TWMD_API_KEY，建立 client 後呼叫 twse_daily_price、issuer_profile 等方法。詳見 /docs/sdk/python-sdk。

建立 TWMarketDataClient 並帶入 apiKey，可用 getDataset 或 dataset 專用 helper。詳見 /docs/sdk/javascript-sdk。

MCP 是讓 agent 以工具方式呼叫資料服務的介面。TW Market Data 目前提供 MCP skeleton（preview）。

常見流程是先查公司主檔，再查價格與營收，最後整合為研究上下文。可參考 /docs/ai-agents/agent-workflow-examples。

在 SDK response meta 或 API response header 取得 requestId，再對照 usage/credits 記錄進行追查。

請先確認瀏覽器 cookie 與第三方登入流程可用；若持續失敗，回報發生時間與 requestId 協助排查。

可使用註冊流程建立並驗證 Email，或在已存在帳號上完成驗證後設定密碼。

通常與 session 或 backend 暫時波動有關。請重新整理、重新登入，或稍後再試。若持續發生請聯繫我們。

若出現短暫未登入狀態，可能是 session 查詢失敗或網路波動。請以穩定網路重試，並保留時間點供排查。

credits 用於 API 請求計價。可透過訂閱方案 included credits 或單次儲值補充。

dry-run 代表只計算估算成本，不真正扣除 wallet。回應會顯示 X-TWMD-Dry-Run: true。

正式扣點需由 production 安全旗標明確開啟，預設不啟用，避免誤扣。

若平台仍在試算模式，usage 會記錄 estimated credits，但 wallet 不會下降。

可在 /usage 查看請求紀錄與 requestId，在 /billing/credits 查看交易與對帳資訊。

請立即在 dashboard 撤銷該 key，並建立新的 key 替換。

在 API keys 表格按刪除/撤銷圖示即可。撤銷後該 key 立即失效。

建立當下會顯示完整值，系統只儲存 hash 與加密版本，避免明文金鑰暴露。

requestId 可用於問題追蹤、對帳核對、客服協助定位單筆請求。

低流量時後端服務可能進入冷狀態，首次請求會比較慢，後續暖機請求通常明顯加速。

常見原因是 backend cold start、DB pool 喚醒或上游快取尚未建立。

請附上發生時間、端點、HTTP 狀態碼與 requestId，寄信至 avenra.platform@gmail.com。