Skip to main content

Query Stock Quote Information (Batch)

querySymbolSnapshot

info

For version >=2.2.5

tip

This feature is for querying product information such as daily upper and lower price limits and does not include real-time quote updates.

Input Parameters

ParameterAccountDescription
accountAccountAccount
marketTypeMarketType (Optional)(default = Common)Market type: supports Common (regular lot), IntradayOdd (odd lot during trading hours), Fixing (closing auction)
stockTypesList StockType (Optional)(default = Stock)Product category: Stock (stocks), ConvertBond (convertible bonds), ETF_and_ETN (ETFs and ETNs)

Result

ParameterTypeDescription
isSuccessboolWhether the request was successful
dataSymbolQuote[]Returned quote information
messagestringError message when isSuccess = false

Symbol Information (SymbolQuote Fields)

Return type : Object

ParameterTypeDescription
marketstringMarkets
symbolstringSymbol
istibOrPsbboolWhether it is TIB or PSB board
marketTypestringMarket type
statusnumberStatus (bitmask sum) 0 :All forbidden, 1:Exempted from margin short selling price constraint,2: Exempted from SBL short selling price constraint, 4: Available sale after buy day trading, 8: Available buy after sale day trading
referencePricenumberReference price
unitnumberTrading unit
updateTimestringUpdate time
limitupPricenumberUpper price limit
limitdownPricenumberLower price limit
openPricenumberOpening price
highPricenumberHighest price
lowPricenumberLowest price
lastPricenumberLatest traded price
totalVolumenumberTotal traded volume
totalTransactionnumberTotal number of trades (Reserved field, not currently in use)
totalValuenumberTotal traded value
lastSizenumberLatest traded volume
lastTransactionnumberLatest number of trades (Reserved field, not currently in use)
lastValuenumberLatest traded value
bidPricenumberBest bid price
bidVolumenumberBest bid volume
askPricenumberBest ask price
askVolumenumberBest ask volume
Supported Products

TAIEX and TAISDAQ securities

info

Status example: status 15 means all four capabilities are enabled (1 + 2 + 4 + 8). Status 12 means buy-first and sell-first day trading are enabled (4 + 8).

Request Example

const { StockType } = require('fubon-neo');

sdk.stock.querySymbolSnapshot(accounts.data[0]) // Default
sdk.stock.querySymbolSnapshot(accounts.data[0], MarketType.Common, [StockType.Stock])

Response Example

{
isSuccess : true,
message : ,
data : [ {
market : TAIEX, // string - Market
symbol : 2330, // string - Symbol
istibOrPsb : false, // bool - Whether the security is listed on TIB or PSB
marketType : Common, // string - Market type (cash equity)
status : 15, // number - Status (bitmask sum)
referencePrice : 780, // double - Reference price (previous trading day close)
unit : 1000, // number - Trading unit
updateTime : , // string - Update Time
limitupPrice : 858, // number - Upper price limit
limitdownPrice : 702, // number - Lower price limit
openPrice : 1155, // number - Opening price
highPrice : 1160, // number - Highest price
lowPrice : 1145, // number - Lowest price
lastPrice : 1145, // number - Latest traded price
totalVolume : 20501, // number - Total traded volume
totalTransaction : 0, // number - Total number of trades (Reserved field, not currently in use)
totalValue : 23551095000, // number - Total traded value
lastSize : 6673, // number - Latest traded volume
lastTransaction : 0, // number - Latest number of trades (Reserved field, not currently in use)
lastValue : 7640585000, // number - Latest traded value
bidPrice : 1145, // number - Best bid price
bidVolume : 1549, // number - Best bid volume
askPrice : 1150, // number - Best ask price
askVolume : 4169 // number - Best ask volume
},
{
market : TAIEX, // string - Market
symbol : 2881, // string - Symbol
...
} ]
}