Snapshot Movers

info

屬於 開發者 及 進階用戶 方案的專屬功能！

取得股票漲跌幅排行（依市場別），系統更新頻率為每五秒更新一次。

GET /snapshot/movers/{market}

Parameters

Name	Type	Description
market*	string	市場別
direction*	string	上漲／下跌，可選 up 上漲；down 下跌
change*	string	漲跌／漲跌幅，可選 percent 漲跌幅；value 漲跌
type	string	標的類型，可選 ALLBUT0999 包含一般股票、特別股及 ETF；COMMONSTOCK 為一般股票
gt	number	篩選大於漲跌／漲跌幅的股票
gte	number	篩選大於或等於漲跌／漲跌幅的股票
lt	number	篩選小於漲跌／漲跌幅的股票
lte	number	篩選小於或等於漲跌／漲跌幅的股票
eq	number	篩選等於漲跌／漲跌幅的股票

Response

Name	Type	Description
date*	string	日期
time*	string	時間
market*	string	市場別
change*	string	漲跌／漲跌幅
data*	object[]	快照資料
data[0].type	string	Ticker 類型
data[0].symbol	string	股票代碼
data[0].name	string	股票簡稱
data[0].openPrice	number	開盤價
data[0].highPrice	number	最高價
data[0].lowPrice	number	最低價
data[0].closePrice	number	收盤價
data[0].change	number	漲跌
data[0].changePercent	number	漲跌幅
data[0].tradeVolume	number	成交量
data[0].tradeValue	number	成交金額
data[0].lastPrice	number	最後一筆成交價；當日尚無成交時不回傳
data[0].lastUpdated	number	快照時間

Example

cURL

curl -X 'GET' \
  'https://api.fugle.tw/marketdata/v1.0/stock/snapshot/movers/TSE?direction=up&change=percent' \
  -H 'X-API-KEY: <YOUR_API_KEY>'

Python

from fugle_marketdata import RestClient

client = RestClient(api_key='YOUR_API_KEY')
stock = client.stock
print(stock.snapshot.movers(market='TSE', direction='up', change='percent'))

Node.js

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

const client = new RestClient({ apiKey: 'YOUR_API_KEY' });
client.stock.snapshot.movers({ market: 'TSE', direction: 'up', change: 'percent' })
  .then(data => console.log(data));

Response Body：

{
  "date": "2026-10-08",
  "time": "140000",
  "market": "TSE",
  "change": "percent",
  "data": [
    {
      "type": "EQUITY",
      "symbol": "2424",
      "name": "隴華",
      "openPrice": 9.68,
      "highPrice": 9.79,
      "lowPrice": 9.41,
      "closePrice": 9.79,
      "change": 0.89,
      "changePercent": 10,
      "tradeVolume": 90,
      "tradeValue": 869130,
      "lastPrice": 9.79,
      "lastUpdated": 1791437400000000
    },
    {
      "type": "EQUITY",
      "symbol": "3447",
      "name": "展達",
      "openPrice": 28.1,
      "highPrice": 30.25,
      "lowPrice": 27.6,
      "closePrice": 30.25,
      "change": 2.75,
      "changePercent": 10,
      "tradeVolume": 668,
      "tradeValue": 19768350,
      "lastPrice": 30.25,
      "lastUpdated": 1791437400000000
    },
    {
      "type": "EQUITY",
      "symbol": "2466",
      "name": "冠西電",
      "openPrice": 180.5,
      "highPrice": 198.5,
      "lowPrice": 180,
      "closePrice": 198.5,
      "change": 18,
      "changePercent": 9.97,
      "tradeVolume": 1573,
      "tradeValue": 298524500,
      "lastPrice": 198.5,
      "lastUpdated": 1791437400000000
    },
    ......
  ]
}