開始使用

元富行情 Web API 提供開發者友善的 API 服務。您可以查詢台股的日內行情、行情快照與歷史行情等數據。

速率限制

如果您 API 請求超過了限制，將收到帶有狀態碼 429 的回應。 ( 限制細節請參考速率限制 )

功能列表

功能列表依資料類型可分為 盤中行情（intraday）、行情快照（snapshot）、歷史行情（historical）。元富行情 Web API 提供的功能如下：

• /intraday/tickers - 股票或指數列表（依條件查詢）
• /intraday/ticker/{symbol} - 股票基本資料（依代碼查詢）
• /intraday/quote/{symbol} - 股票即時報價（依代碼查詢）
• /intraday/candles/{symbol} - 股票價格Ｋ線（依代碼查詢）
• /intraday/trades/{symbol} - 股票成交明細（依代碼查詢）
• /intraday/volumes/{symbol} - 股票分價量表（依代碼查詢）
• /snapshot/quotes/{market} - 股票行情快照（依市場別）
• /snapshot/movers/{market} - 股票漲跌幅排行（依市場別）
• /snapshot/actives/{market} - 股票成交量值排行（依市場別）
• /historical/candles/{symbol} - 取得 1 年內歷史股價（依代碼查詢）
• /historical/stats/{symbol} - 取得近 52 週股價數據（依代碼查詢）

使用 SDK

元富行情 Web API 提供 Python 、 Node.js SDK 。您可以透過以下方式存取 API：

Python

from masterlink_sdk import MasterlinkSDK, Order

sdk = MasterlinkSDK()

accounts = sdk.login("Your ID", "Your password", "Your cert path", "Your cert password")  # 需登入後，才能取得行情權限

sdk.init_realtime(accounts[0])  # 建立行情連線

reststock = sdk.marketdata.rest_client.stock  

Node.js

const { MasterlinkSDK } = require('masterlink');

const sdk = new MasterlinkSDK();

const accounts = sdk.login("Your ID", "Your Password", "Your Cert Path", "Your Cert Password");

sdk.initRealtime(accounts[0]); // 建立行情連線

const client = sdk.marketdata.restClient

const stock = client.stock;