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].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
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": "2023-05-29",
  "time": "133500",
  "market": "TSE",
  "change": "percent",
  "data": [
    {
      "type": "EQUITY",
      "symbol": "2901",
      "name": "欣欣",
      "openPrice": 27.1,
      "highPrice": 29.7,
      "lowPrice": 27.1,
      "closePrice": 29.7,
      "change": 2.7,
      "changePercent": 10,
      "tradeVolume": 640,
      "tradeValue": 18824300,
      "lastUpdated": 1685338200000000
    },
    {
      "type": "EQUITY",
      "symbol": "2345",
      "name": "智邦",
      "openPrice": 357.5,
      "highPrice": 357.5,
      "lowPrice": 346.5,
      "closePrice": 357.5,
      "change": 32.5,
      "changePercent": 10,
      "tradeVolume": 9350,
      "tradeValue": 3331334500,
      "lastUpdated": 1685338200000000
    },
    {
      "type": "EQUITY",
      "symbol": "3025",
      "name": "星通",
      "openPrice": 42.3,
      "highPrice": 44.65,
      "lowPrice": 41.8,
      "closePrice": 44.65,
      "change": 4.05,
      "changePercent": 9.98,
      "tradeVolume": 25625,
      "tradeValue": 1114127050,
      "lastUpdated": 1685338200000000
    },
    ......
  ]
}