Snapshot Actives

info

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

取得股票成交量值排行（依市場別），系統更新頻率為每五秒更新一次。

GET /snapshot/actives/{market}

Parameters

Name	Type	Description
market*	string	市場別，可選 TSE 上市；OTC 上櫃；ESB 興櫃一般板；TIB 臺灣創新板；PSB 興櫃戰略新板
trade*	string	成交量／成交值，可選 volume 成交量；value 成交值
type	string	標的類型，可選 ALLBUT0999 包含一般股票、特別股及 ETF ； COMMONSTOCK 為一般股票

Response

Name	Type	Description
date*	string	日期
time*	string	時間
market*	string	市場別
trade*	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/actives/TSE?trade=value' \
  -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.actives(market='TSE', trade='value')

Node.js

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

const client = new RestClient({ apiKey: 'YOUR_API_KEY' });
client.stock.snapshot.actives({ market: 'TSE', trade: 'value })
  .then(data => console.log(data));

Response Body：

{
  "date": "2023-05-29",
  "time": "140000",
  "market": "TSE",
  "trade": "value",
  "data": [
    {
      "type": "EQUITY",
      "symbol": "2330",
      "name": "台積電",
      "openPrice": 574,
      "highPrice": 574,
      "lowPrice": 564,
      "closePrice": 568,
      "change": 2,
      "changePercent": 0.35,
      "tradeVolume": 54538,
      "tradeValue": 31019803000,
      "lastUpdated": 1685338200000000
    },
    {
      "type": "EQUITY",
      "symbol": "3231",
      "name": "緯創",
      "openPrice": 66,
      "highPrice": 69.2,
      "lowPrice": 65.9,
      "closePrice": 68,
      "change": 3,
      "changePercent": 4.62,
      "tradeVolume": 202089,
      "tradeValue": 13763365000,
      "lastUpdated": 1685338200000000
    },
    {
      "type": "EQUITY",
      "symbol": "3661",
      "name": "世芯-KY",
      "openPrice": 1555,
      "highPrice": 1660,
      "lowPrice": 1550,
      "closePrice": 1660,
      "change": 150,
      "changePercent": 9.93,
      "tradeVolume": 6937,
      "tradeValue": 11264055000,
      "lastUpdated": 1685338200000000
    },
    ......
  ]
}