Snapshot Actives
股票成交量值排行(依市場別)
snapshot/actives/{market}
Parameters
| Name | Type | Description |
|---|---|---|
market* | string | 市場別,可選 TSE 上市;OTC 上櫃;ESB 興櫃一般板;TIB 臺灣創新板 |
trade* | string | 成交量/成交值,可選 volume 成交量;value 成交值 |
type | string | 標的類型,可選 ALLBUT0999 包含一般股票、特別股及 ETF ; COMMONSTOCK 為一般股票 |
Response
| Name | Type | Description |
|---|---|---|
date* | string | 日期 |
time* | string | 時間 |
market* | string | 市場別 |
trade* | string | 成交量/成交值 |
data* | object[] | 快照資料 |
>> type | string | Ticker 類型 |
>> symbol | string | 股票代碼 |
>> name | string | 股票簡稱 |
>> openPrice | number | 開盤價 |
>> highPrice | number | 最高價 |
>> lowPrice | number | 最低價 |
>> closePrice | number | 收盤價 |
>> change | number | 漲跌 |
>> changePercent | number | 漲跌幅 |
>> tradeVolume | number | 成交量 |
>> tradeValue | number | 成交金額 |
>> lastPrice | number | 最後一筆成交價;當日尚無成交時不回傳 |
>> lastUpdated | number. | 快照時間 |
info
'*' 表示必揭示欄位。
Example
- Python
- Node.js
- C#
from fubon_neo.sdk import FubonSDK, Order
sdk = FubonSDK()
accounts = sdk.login("Your ID", "Your password", "Your cert path", "Your cert password") # 需登入後,才能取得行情權限
sdk.init_realtime() # 建立行情連線
reststock = sdk.marketdata.rest_client.stock
# reststock.snapshot.actives(market='TSE', trade='value') # 2.2.3 及以前版本
## 2.2.4 及以後版本 (使用 Exception 進行例外處理)
from fubon_neo.fugle_marketdata.rest.base_rest import FugleAPIError
try:
reststock.snapshot.actives(market='TSE', trade='value')
except FugleAPIError as e:
print(f"Error: {e}")
print("------------")
print(f"Status Code: {e.status_code}") # 例: 429
print(f"Response Text: {e.response_text}") # 例: {"statusCode":429,"message":"Rate limit exceeded"}
const { FubonSDK } = require('fubon-neo');
const sdk = new FubonSDK();
const accounts = sdk.login("Your ID", "Your Password", "Your Cert Path", "Your Cert Password");
sdk.initRealtime(); // 建立行情連線
const client = sdk.marketdata.restClient
client.stock.snapshot.actives({ market: 'TSE', trade: 'value' })
.then(data => console.log(data));
using FubonNeo.Sdk;
using FugleMarketData.QueryModels;
var sdk = new FubonSDK();
var result = sdk.Login("Your ID", "Your Password", "Your Cert Path", "Your Cert Password");
sdk.InitRealtime(); // 建立行情連線
var rest = sdk.MarketData.RestClient.Stock;
var quote = await rest.Snapshot.Actives(FugleMarketData.QueryModels.MarketType.TSE, FugleMarketData.QueryModels.TradeType.Value);
var quote_cont = quote.Content.ReadAsStringAsync().Result;
Console.WriteLine(quote_cont);
Response Body:
{
"date": "2026-10-08",
"time": "140000",
"market": "TSE",
"trade": "value",
"data": [
{
"type": "EQUITY",
"symbol": "2330",
"name": "台積電",
"openPrice": 2550,
"highPrice": 2575,
"lowPrice": 2550,
"closePrice": 2550,
"change": -35,
"changePercent": -1.35,
"tradeVolume": 20154,
"tradeValue": 51508925000,
"lastPrice": 2550,
"lastUpdated": 1791437400000000
},
{
"type": "EQUITY",
"symbol": "2408",
"name": "南亞科",
"openPrice": 522,
"highPrice": 537,
"lowPrice": 522,
"closePrice": 532,
"change": 18,
"changePercent": 3.5,
"tradeVolume": 62584,
"tradeValue": 33256374000,
"lastPrice": 532,
"lastUpdated": 1791437400000000
},
{
"type": "EQUITY",
"symbol": "2454",
"name": "聯發科",
"openPrice": 4800,
"highPrice": 4850,
"lowPrice": 4690,
"closePrice": 4690,
"change": -145,
"changePercent": -3,
"tradeVolume": 6377,
"tradeValue": 30281030000,
"lastPrice": 4690,
"lastUpdated": 1791437400000000
},
......
]
}