開始使用

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

身份驗證

富果行情 API 透過 API 金鑰對用戶進行身份驗證（Authentication）。請在發送 API 請求時請加入以下 HTTP 標頭：

X-API-KEY: <YOUR_API_KEY>

速率限制

如果您 API 請求超過了限制，將收到帶有狀態碼 429 的回應。

不同的 API 方案有不同的速率限制，關於速率限制，請參考 行情方案及價格 的說明。

API 端點

富果行情 REST API 端點使用以下位置為前綴：

https://api.fugle.tw/marketdata/v1.0/stock/

API 端點依資料類型可分為 盤中行情（intraday）、行情快照（snapshot）、歷史行情（historical）。富果行情 REST API 提供的端點如下：

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

使用 SDK

富果行情 REST API 提供 Python 與 Node.js SDK。您可以透過以下方式存取 REST API：

Python

from fugle_marketdata import RestClient

client = RestClient(api_key = 'YOUR_API_KEY')
stock = client.stock

Node.js

const { RestClient } = require('@fugle/marketdata');

const client = new RestClient({ apiKey: 'YOUR_API_KEY' });
const stock = client.stock;