# Quotation Definitions
# Cumulative Filter Properties
StockField
NONEunknown
CHANGE_RATEYield
AMPLITUDEAmplitude
VOLUMEAverage daily trading volume
TURNOVERAverage daily turnover
TURNOVER_RATETurnover rate
# Asset Types
AssetClass
UNKNOWUnknown
STOCKStocks
BONDBonds
COMMODITYCommodities
CURRENCY_MARKETCurrency markets
FUTUREFutures
SWAPSwaps
# Corporate Action
# Dark Disk Status
DarkStatus
NONENo grey market trading
TRADINGOngoing grey market trading
ENDGrey market trading finished
# Financial Filter Properties
StockField
NONEunknown
NET_PROFITNet profit
NET_PROFIX_GROWTHNet profit growth rate
SUM_OF_BUSINESSOperating income
SUM_OF_BUSINESS_GROWTHYear-on-year growth rate of operating income
NET_PROFIT_RATENet profit rate
GROSS_PROFIT_RATEGross profit margin
DEBT_ASSET_RATEAsset-liability ratio
RETURN_ON_EQUITY_RATEReturn on equity
ROICReturn on invested capital
ROA_TTMReturn on assets TTM
EBIT_TTMEarnings before interest and tax TTM
EBITDAEarnings before interest, tax, depreciation and amortization
OPERATING_MARGIN_TTMOperating profit margin TTM
EBIT_MARGINEBIT margin
EBITDA_MARGINEBITDA margin
FINANCIAL_COST_RATEFinancial cost rate
OPERATING_PROFIT_TTMOperating profit TTM
SHAREHOLDER_NET_PROFIT_TTMNet profit attributable to the parent company
NET_PROFIT_CASH_COVER_TTMThe proportion of cash income in profit
CURRENT_RATIOCurrent ratio
QUICK_RATIOQuick ratio
CURRENT_ASSET_RATIOLiquidity rate
CURRENT_DEBT_RATIOCurrent debt ratio
EQUITY_MULTIPLIEREquity multiplier
PROPERTY_RATIOEquity ratio
CASH_AND_CASH_EQUIVALENTSCash and cash equivalent
TOTAL_ASSET_TURNOVERTotal asset turnover rate
FIXED_ASSET_TURNOVERFixed asset turnover rate
INVENTORY_TURNOVERInventory turnover rate
OPERATING_CASH_FLOW_TTMOperating cash flow TTM
ACCOUNTS_RECEIVABLENet accounts receivable
EBIT_GROWTH_RATEYear-on-year growth rate of EBIT
OPERATING_PROFIT_GROWTH_RATEYear-on-year growth rate of operating profit
TOTAL_ASSETS_GROWTH_RATEYear-on-year growth rate of total assets
PROFIT_TO_SHAREHOLDERS_GROWTH_RATEYear-on-year growth rate of net profit attributed to parent company owner
PROFIT_BEFORE_TAX_GROWTH_RATEYear-on-year growth rate of total profit
EPS_GROWTH_RATEYear-on-year growth rate of EPS
ROE_GROWTH_RATEYear-on-year growth rate of ROE
ROIC_GROWTH_RATEYear-on-year growth rate of ROIC
NOCF_GROWTH_RATEYear-on-year growth rate of operating cash flow
NOCF_PER_SHARE_GROWTH_RATEYear-on-year growth rate of operating cash flow per share
OPERATING_REVENUE_CASH_COVEROperating cash cover ratio
OPERATING_PROFIT_TO_TOTAL_PROFITOperating profit ratio
BASIC_EPSBasic earnings per share
DILUTED_EPSDiluted earnings per share
NOCF_PER_SHARENet operating cash flow per share
# Financial Filter Properties Period
FinancialQuarter
NONEunknown
ANNUALannual report
FIRST_QUARTERFirst quarter report
INTERIMInterim report
THIRD_QUARTERThird quarter report
MOST_RECENT_QUARTERLatest quarter report
# Custom indicator attributes
StockField
NONEUnknown
PRICElatest price
MA5Simple moving average
MA55-day simple moving average (Not recommended)
MA1010-day simple moving average (Not recommended)
MA2020-day simple moving average (Not recommended)
MA3030-day simple moving average (Not recommended)
MA6060-day simple moving average (Not recommended)
MA120120-day simple moving average (Not recommended)
MA250250-day simple moving average (Not recommended)
RSIRSI
EMAExponential moving average
EMA55-day exponential moving average (Not recommended)
EMA1010-day exponential moving average (Not recommended)
EMA2020-day exponential moving average (Not recommended)
EMA3030-day exponential moving average (Not recommended)
EMA6060-day exponential moving average (Not recommended)
EMA120120-day exponential moving average (Not recommended)
EMA250250-day exponential moving average (Not recommended)
KDJ_KK value of KDJ indicator
KDJ_DD value of KDJ indicator
KDJ_JJ value of KDJ indicator
MACD_DIFFDIFF value of MACD indicator
MACD_DEADEA value of MACD indicator
MACDMACD value of MACD indicator
BOLL_UPPERUPPER value of BOLL indicator
BOLL_MIDDLERMIDDLER value of BOLL indicator
BOLL_LOWERLOWER value of BOLL indicator
VALUECustom value (stock_field1 does not support this field)
# Indicator language type
IndicatorLangType
UNKNOWNNo filter
MYLANGMyLang
PYTHONPython
# Indicator search mode
IndicatorSearchMode
PARTIALPartial match (default)
EXACTExact match; also returns script field
# Indicator parameter value type
Possible values for the type field in indicator input value dict.
# Indicator shape
When type is SHAPE, value is the enum name string below.
# Indicator line type
When type is LINE, value is the enum name string below.
# Indicator parameter value
Indicator input value dict maps to this Protobuf message; SDK converts to Python values.
# Indicator input parameter
Structure of inputs elements returned by get_indicator_list.
# Indicator output parameter
Metadata for one output line; matches outputs elements in push-indicator-calc callback.
# Relative position
RelativePosition
NONEUnknown
MOREStock_field1 is greater than stock_field2
LESSStock_field1 is less than stock_field2
CROSS_UPStock_field1 cross over stock_field2
CROSS_DOWNStock_field1 cross below stock_field2
# Pattern attributes
PatternField
NONE未知
MA_ALIGNMENT_LONGMA bullish alignment (MA5 > MA10 > MA20 > MA30 > MA60 for two consecutive days, and the closing price of the day is greater than the closing price of the previous day)
MA_ALIGNMENT_SHORTMA bearish alignment (MA5 < MA10 < MA20 < MA30 < MA60 for two consecutive days, and the closing price of the day is less than the closing price of the previous day)
EMA_ALIGNMENT_LONGEMA bullish alignment (EMA5 > EMA10 > EMA20 > EMA30 > EMA60 for two consecutive days, and the closing price of the day is greater than the closing price of the previous day)
EMA_ALIGNMENT_SHORTEMA bearish alignment (EMA5 < EMA10 < EMA20 < EMA30 < MA60 for two consecutive days, and the closing price of the day is less than the closing price of the previous day)
RSI_GOLD_CROSS_LOWRSI low golden cross (short-term RSI crosses over long-term RSI below 50 (short-term RSI of the previous day is less than long-term RSI, short-term RSI of the current day is greater than long-term RSI))
RSI_DEATH_CROSS_HIGHRSI high dead cross (short-term RSI crosses below long-term RSI above 50 (short-term RSI of the previous day is greater than long-term RSI, short-term RSI of the current day is less than long-term RSI))
RSI_TOP_DIVERGENCERSI top divergence (two adjacent candlestick peaks, the CLOSE of the later peak > the CLOSE of the earlier peak, the RSI12 value of the later peak < the RSI12 value of the earlier peak)
RSI_BOTTOM_DIVERGENCERSI bottom divergence (two adjacent candlestick troughs, the CLOSE of the later trough < the CLOSE of the earlier trough, the RSI12 value of the later trough > the RSI12 value of the earlier trough)
KDJ_GOLD_CROSS_LOWKDJ low golden cross (D value is less than or equal to 30, and the K value of the previous day is less than the D value, and the K value of the day is greater than the D value)
KDJ_DEATH_CROSS_HIGHKDJ high death cross (D value is greater than or equal to 70, and the K value of the previous day is greater than the D value, and the K value of the day is less than the D value)
KDJ_TOP_DIVERGENCEKDJ top divergence (two adjacent candlestick peaks, the CLOSE of the later peak > the CLOSE of the earlier peak, the J value of the later peak < the J value of the earlier peak)
KDJ_BOTTOM_DIVERGENCEKDJ bottom divergence (two adjacent candlestick troughs, the CLOSE of the later trough < the CLOSE of the earlier trough, the J value of the later trough > the J value of the earlier trough)
MACD_GOLD_CROSS_LOWMACD golden cross (DIFF crosses over DEA (DIFF is less than DEA of the previous day, and DIFF is greater than DEA of the current day))
MACD_DEATH_CROSS_HIGHMACD dead cross (DIFF crosses below DEA (DIFF is greater than DEA of the previous day, and DIFF is less than DEA of the current day))
MACD_TOP_DIVERGENCEMACD top divergence (two adjacent candlestick peaks, the CLOSE of the later peak > the CLOSE of the earlier peak, the MACD value of the later peak < the MACD value of the earlier peak)
MACD_BOTTOM_DIVERGENCEMACD bottom deviation (two adjacent candlestick troughs, the CLOSE of the later trough < the CLOSE of the earlier trough, the MACD value of the later trough > the MACD value of the earlier trough)
BOLL_BREAK_UPPERBreak up bollinger upper bound (the stock price of the previous day was lower than the upper bound, and the stock price of the current day is greater than the upper bound)
BOLL_BREAK_LOWERBreak up bollinger lower bound (the stock price of the previous day was greater than the lower bound, and the stock price of the current day is less than the lower bound)
BOLL_CROSS_MIDDLE_UPCross over bollinger mid line (the stock price of the previous day was lower than the mid line, and the stock price of the current day is greater than the mid line)
BOLL_CROSS_MIDDLE_DOWNCross below bollinger mid line (the stock price of the previous day was greater than the mid line, and the stock price of the current day is less than the mid line)
# Watchlist Group Type
UserSecurityGroupType
NONEunknown
CUSTOMCustom groups
SYSTEMSystem groups
ALLAll groups
# Index Option Category
IndexOptionType
NONEunknown
NORMALOrdinary index option
SMALLSmall Index Options
# Listing Time
IpoPeriod
NONEunknown
TODAYListed today
TOMORROWTo be listed tomorrow
NEXTWEEKTo be listed next week
LASTWEEKHas been listed last week
LASTMONTHHas been listed last month
# Warrant Issuer
Issuer
UNKNOWunknown
SGSociete Generale
BPBNP Paribas
CSCredit Suisse
CTCiti Bank
EAThe Bank of East Aisa
GSGoldman Sachs
HSHSBC
JPJPMorgan Chase
MBMacquarie Bank
SCStandard Chartered Bank
UBUnion Bank of Switzerland
BIBank of China
DBDeutsche Bank
DCDaiwa Bank
MLMerrill Lynch
NMNomura Bank
RBRabobank
RSThe Royal Bank of Scotland
BCBarclays
HTHaitong Bank
VTBank Vontobel
KCKBC Bank
MSMorgan Stanley
GJGuotai Junan
XZDBS Bank
HUHuatai
KSKorea Investment
CICITIC Securities
# Candlestick Field
KL_FIELD
ALLAll
DATE_TIMETime
HIGHHigh
OPENOpen
LOWLow
CLOSEClose
LAST_CLOSEClose of the previous K-line
TRADE_VOLVolume
TRADE_VALTurnover
TURNOVER_RATETurnover rate
PE_RATIOP/E ratio
CHANGE_RATEYield
# Candlestick Type
KLType
NONEunknown
K_1M1 minute candlestick
K_3M3 minutes candlestick
K_5M5 minutes candlestick
K_15M15 minutes candlestick
K_30M30 minutes candlestick
K_60M60 minutes candlestick
K_10M10 minutes candlestick
K_120M120 minutes candlestick (2 hours)
K_180M180 minutes candlestick (3 hours)
K_240M240 minutes candlestick (4 hours)
K_DAY1 day candlestick
K_WEEK1 week candlestick
K_MON1 month candlestick
K_QUARTER1 quarter candlestick
K_YEAR1 year candlestick
# Period Type
PeriodType
INTRADAYIntraday
DAYDay
WEEKWeek
MONTHMonth
# Price Reminder Market Status
PriceReminderMarketStatus
UNKNOWunknown
OPENMarket opens
US_PREPre-market of US stocks
US_AFTERAfter-hours of US stocks
US_OVERNIGHTOvernight trading session of US stocks
# Watchlist Operation
ModifyUserSecurityOp
NONEUnknown
ADDAdd
DELDelete
MOVE_OUTRemove from group
# Option Type (by Exercise Time)
OptionAreaType
NONEunknown
AMERICANAmerican Option
EUROPEANEuropean Option
BERMUDABermuda Option
# Option in/out of The Money
OptionCondType
ALLAll
WITHINIn the money
OUTSIDEOut of the money
# Option Type (by Direction)
OptionType
ALLall
CALLCall option
PUTPut option
# Option Strategy Type
OptionStrategyType
NONEUnknown
SINGLESingle option
COVEREDCovered
SPREADVertical spread
STRADDLEStraddle
STRANGLEStrangle
COLLARCollar
BUTTERFLYButterfly
CONDORCondor
IRON_BUTTERFLYIron butterfly
IRON_CONDORIron condor
CALENDAR_SPREADCalendar spread
DIAGONAL_SPREADDiagonal spread
CUSTOMCustom
# News Sub Type
NewsSubType
ALLAll
NEWSNews
NOTICENotice
RATINGRating
# Plate Set Type
Plate
ALLAll plates
INDUSTRYIndustry plate
REGIONRegional plate
CONCEPTConcept plate
OTHEROther plates
# Price Reminder Frequency
PriceReminderFreq
NONEUnknown
ALWAYSKeep reminding
ONCE_A_DAYOnce a day
ONCEOnly remind once
# Price Reminder Type
PriceReminderType
NONEUnknown
PRICE_UPPrice rise to
PRICE_DOWNPrice fall to
CHANGE_RATE_UPDaily increase rate exceeds
CHANGE_RATE_DOWNDaily decline rate exceeds
FIVE_MIN_CHANGE_RATE_UPIncreate rate in 5 minutes exceeds
FIVE_MIN_CHANGE_RATE_DOWNDecline rate in 5 minutes exceeds
VOLUME_UPVolume exceeds
TURNOVER_UPTurnover exceeds
TURNOVER_RATE_UPTurnover rate exceeds
BID_PRICE_UPBid price higher than
ASK_PRICE_DOWNAsk price lower than
BID_VOL_UPBid volume higher than
ASK_VOL_UPAsk volume higher than
THREE_MIN_CHANGE_RATE_UPIncreate rate in 3 minutes exceeds
THREE_MIN_CHANGE_RATE_DOWNDecline rate in 3 minutes exceeds
# Warrant in/out of the Money
PriceType
UNKNOWUnknown
OUTSIDEOut of the money
WITH_INIn the money
# Quote Push Type
PushDataType
UNKNOWUnknown
REALTIMEReal-time data
BYDISCONNPull supplementary data (up to 50) during disconnection from Futu server
CACHENon-real-time non-supplementary data
# Quote Market
Market
NONEUnknown market
HKHK market
USUS market
SHShanghai market
SZShenzhen market
SGSingapore market
JPJapanese market
AUAustralian market
MYMalaysian market
CACanadian market
FXForex market
CCCryptocurrency market
# Market State
MarketState
Corresponding time period of each market state, click here to learn more
NONENo trading
AUCTIONPre-market trading
WAITING_OPENWaiting for opening
MORNINGMorning session
RESTLunch break
AFTERNOONAfternoon session / Regular trading hours for U.S stock market
CLOSEDMarket closed
PRE_MARKET_BEGINPre-market trading of U.S stock market
PRE_MARKET_ENDPre-market ending of U.S stock market
AFTER_HOURS_BEGINAfter-hours trading of U.S stock market
AFTER_HOURS_ENDMarket closed of U.S. stock market
OVERNIGHTOvernight trading of U.S. stock market
NIGHT_OPENNight market trading hours
NIGHT_ENDNight market closed
NIGHTNight market trading hours for U.S. index options
TRADE_AT_LASTLate trading hours for U.S. index options
FUTURE_DAY_OPENDay market trading hours
FUTURE_DAY_BREAKDay market break
FUTURE_DAY_CLOSEDay market closed
FUTURE_DAY_WAIT_OPENFutures market wait for opening
HK_CASAfter-hours bidding for HK stocks
FUTURE_NIGHT_WAITFutures night market wait for opening (Obsolete)
FUTURE_AFTERNOONFutures afternoon (Obsolete)
FUTURE_SWITCH_DATEWaiting for U.S. futures opening
FUTURE_OPENTrading hours of U.S. futures
FUTURE_BREAKBreak of U.S. futures
FUTURE_BREAK_OVERTrading hours of U.S. futures after break
FUTURE_CLOSEMarket closed of U.S. futures
STIB_AFTER_HOURS_WAITAfter-hours matching period on the Sci-tech innovation plate (Obsolete)
STIB_AFTER_HOURS_BEGINAfter-hours trading on the Sci-tech innovation plate begins (Obsolete)
STIB_AFTER_HOURS_ENDAfter-hours trading on the Sci-tech innovation plate ends (Obsolete)
# US Stock Session
Session
NONEUnknown
RTHUS Stocks Regular trading hours
ETHUS Stocks Pre/Post + regular trading hours
OVERNIGHTUS Stocks Overnight trading hours (only applied to Trade API)
ALLUS Stocks 24H trading hours (applied to Quote API & Trade API)
# Quote Authorities
QotRight
UNKNOWUnknown
BMPBMP (subscription is not supported for this permission)
LEVEL1Level1
LEVEL2Level2
SFHK Securities FullTick Quotes
NONo permission
# Associated * Data Type
SecurityReferenceType
UNKNOWUnknown
WARRANTWarrants for stocks
FUTUREContracts related to futures main
# Candlestick Adjustment Type
AuType
NONEActual
QFQAdjust forward
HFQAdjust backward
# Stock Status
SecurityStatus
NONEUnknown
NORMALNormal status
LISTINGTo be listed
PURCHASINGPurchasing
SUBSCRIBINGSubscribing
BEFORE_DRAK_TRADE_OPENINGBefore the grey market trading opens
DRAK_TRADINGOngoing grey market trading
DRAK_TRADE_ENDGrey market trading closed
TO_BE_OPENTo be open
SUSPENDEDSuspended
CALLEDCalled
EXPIRED_LAST_TRADING_DATEExpired latest trading date
EXPIREDExpired
DELISTEDDelisted
CHANGE_TO_TEMPORARY_CODEDuring the company action, the trading was closed and transferred to the temporary code trading
TEMPORARY_CODE_TRADE_ENDTemporary trading ends
CHANGED_PLATE_TRADE_ENDPlate changed, the old code is not available for trading
CHANGED_CODE_TRADE_ENDThe code has been changed, the old code is not available for trading
RECOVERABLE_CIRCUIT_BREAKERRecoverable circuit breaker
UN_RECOVERABLE_CIRCUIT_BREAKERUnrecoverable circuit breaker
AFTER_COMBINATIONAfter-hours matchmaking
AFTER_TRANSATIONAfter-hours trading
# Stock Type
SecurityType
NONEUnknown
BONDBonds
BWRTBlanket warrants
STOCKStocks
ETFETFs
WARRANTWarrants
IDXIndexs
PLATEPlates
DRVTOptions
PLATESETPlate sets
FUTUREFutures
CRYPTOCryptocurrency
# Set Price Reminder Operation Type
SetPriceReminderOp
NONEUnknown
ADDAdd
DELDelete
ENABLEEnable
DISABLEDisable
MODIFYModify
DEL_ALLDelete all (delete all price alerts under the specified stock)
# Sort Direction
SortDir
NONENot sorted
ASCENDAscending
DESCENDDescending
# Sort Field
SortField
NONEUnknown
CODECode
CUR_PRICELatest price
PRICE_CHANGE_VALPrice changed
CHANGE_RATEYield
STATUSStatus
BID_PRICEBid price
ASK_PRICEAsk price
BID_VOLBid volume
ASK_VOLAsk volume
VOLUMEVolume
TURNOVERTurnover
AMPLITUDEAmplitude
SCOREComprehensive score
PREMIUMPremium
EFFECTIVE_LEVERAGEEffective leverage
DELTAHedging value
IMPLIED_VOLATILITYImplied volatility
TYPEType
STRIKE_PRICEStrike price
BREAK_EVEN_POINTBreak even point
MATURITY_TIMEMaturity date
LIST_TIMEListing date
LAST_TRADE_TIMELastest trading day
LEVERAGELeverage ratio
IN_OUT_MONEYIn/out of the money %
RECOVERY_PRICERecovery price
CHANGE_PRICEChange price
CHANGEChange ratio
STREET_RATEOutstanding percentage (the propotioin of retail investors)
STREET_VOLOutstanding quantity (the volume held by retail investors)
WARRANT_NAMEWarrant name
ISSUERIssuer
LOT_SIZELot size
ISSUE_SIZEIssue size
UPPER_STRIKE_PRICEUpper bound
LOWER_STRIKE_PRICELower bound
INLINE_PRICE_STATUSIn/out of bounds
PRE_CUR_PRICELatest price of pre-market
AFTER_CUR_PRICELatest price of after-hours
PRE_PRICE_CHANGE_VALPre-market changes
AFTER_PRICE_CHANGE_VALAfter-hours changes
PRE_CHANGE_RATEPre-market change rate %
AFTER_CHANGE_RATEAfter-hours change rate %
PRE_AMPLITUDEPre-market amplitude %
AFTER_AMPLITUDEAfter-hours amplitude %
PRE_TURNOVERPre-market turnover
AFTER_TURNOVERAfter-hours turnover
LAST_SETTLE_PRICELast settle price
POSITIONPosition
POSITION_CHANGEDaily increase of position
MARKET_CAPMarket cap, for use with Qot_GetValuationPlateStockList
VALUATIONValuation, for use with Qot_GetValuationPlateStockList
FORWARD_VALUATIONForward valuation, for use with Qot_GetValuationPlateStockList
HISTORICAL_PERCENTILEHistorical percentile, for use with Qot_GetValuationPlateStockList
HOLDER_QUANTITYNumber of shares held, for use with shareholder protocols
SHARE_CHANGE_NUMChange in shares held, for use with shareholder protocols
HOLDING_DATEHolding date, for use with shareholder protocols
HOLDER_PCT_CHANGEChange ratio in holdings, for use with shareholder protocols
HOLDER_CHANGE_AMOUNTChange amount in holdings, for use with shareholder protocols
HOLDER_PCTHolding percentage, for use with shareholder protocols
# Sort Order
SortType
NONEUnknown
DESCDescending
ASCAscending
# Financial Report Type
F10Type
NONEUnknown
Q1Single quarter report, Q1
Q2Single quarter report, Q2
Q3Single quarter report, Q3
Q4Single quarter report, Q4
Q6Cumulative quarter report, Q6 (Q1+Q2)
Q9Cumulative quarter report, Q9 (Q1+Q2+Q3)
ANNUALAnnual report
QUARTERLYSingle quarter combination (Q1, Q2, Q3, Q4)
QUARTERLY_ANNUALSingle quarter + annual report
MUL_QUARTERLYCumulative quarter reports (Q1, Q6, Q9, Annual)
# Earnings Publication Time Type
EarningsPubTimeType
NONEUnknown
PRE_MARKETPre-market
AFTER_MARKETAfter-market
DURING_MARKETDuring market hours
# Valuation Type
ValuationType
NONEUnknown
PEP/E ratio
PBP/B ratio
PSP/S ratio
# Financial Statements Type
FinancialStatementsType
NONEUnknown
INCOMEIncome statement
BALANCE_SHEETBalance sheet
CASH_FLOWCash flow statement
MAIN_INDEXKey metrics
# Revenue Breakdown Dimension Type
RevenueBreakdownType
NONEUnknown
PRODUCTProduct
INDUSTRYIndustry
REGIONRegion
BUSINESSBusiness
# Analyst Rating
ResearchRatingType
NONEUnknown
SELLSell
UNDERPERFORMUnderperform
HOLDHold
BUYBuy
STRONG_BUYStrong Buy
# Research Rating Dimension Type
ResearchRatingDimensionType
NONEUnknown
INSTITUTIONInstitution dimension (default)
ANALYSTAnalyst dimension
# Morningstar Rating Type
MorningstarRatingType
NONEUnknown
QUANTITATIVEQuantitative rating (system model)
QUALITATIVEQualitative rating (analyst-assigned)
# Valuation Historical Interval Type
ValuationIntervalType
NONEUnknown
MONTH33 months
MONTH66 months
YEAR11 year
YEAR22 years
YEAR33 years
YEAR55 years
YEAR1010 years
YEAR2020 years
YEAR3030 years
SINCE2019Since 2019
# Corporate Action Reform Type
ReformType
NONEUnknown
STOCK_SPLITStock split
STOCK_MERGEStock merge
BONUS_SHAREBonus share
CAPITALIZATION_OF_RESERVESCapitalization of reserves
RIGHTS_ISSUERights issue
NEW_SHARE_ISSUANCENew share issuance
CASH_DIVIDENDCash dividend
SPECIAL_DIVIDENDSpecial dividend
SPINOFFSpinoff
# Holding Changes Filter Type
HoldingChangesFilterType
NONEAll (default)
INCREASEIncrease
DECREASEDecrease
NEW_INNew position
CLOSE_OUTClose out
# Holder Detail Institution Type
HolderDetailType
DEFAULTDefault, no filter — server-side default logic applies
ALLAll
UNCLASSIFIEDOther institutions
TRADITIONAL_INVESTMENT_MANAGERTraditional investment manager
HEDGE_FUND_MANAGERHedge fund
VC_OR_PEVenture capital / private equity
CORPORATE_PENSION_PLAN_SPONSORCorporate pension plan
FOUNDATION_FUND_SPONSORFoundation fund
INSURANCE_COMPANYInsurance company
BANK_OR_INVESTMENT_BANKBank / investment bank
FAMILY_OFFICES_OR_TRUSTFamily office / trust
SOVEREIGN_WEALTH_FUNDSovereign wealth fund
REITREIT
STRUCTURED_FINANCE_POOL_MANAGERStructured finance pool manager
UNION_PENSION_PLAN_SPONSORUnion pension plan
GOVERNMENT_PENSION_PLAN_SPONSORGovernment pension plan
ENDOWMENT_FUND_SPONSOREndowment fund
INDIVIDUAL_INSIDERSIndividual
ISSUE_SPONSORED_ADRADS
CORPORATIONS_PUBLICPublic corporation
CORPORATIONS_PRIVATEPrivate corporation
STATE_OWNED_SHARESState-owned shares
# Company Profile Field Type
CompanyProfileFieldType
SOURCE_TEXTText
LINK_TYPELink
INDEPENDENT_TITLEIndependent title
# Broker Net Buy/Sell Direction
BuySellType
NONEUnknown
NET_BUYNet buy
NET_SELLNet sell
# Option Volatility Query Time Period Type
OptionVolatilityTimePeriodType
NONEUnknown
WEEKWeek
MONTHMonth (default)
QUARTERQuarter
HALF_YEARHalf year
YEARYear
# Option Implied Volatility Status Type
OptionImpvolStatusType
IMPVOL_FLUCTUATINGOption implied volatility is fluctuating
IMPVOL_OVERVALUEDOption implied volatility is overvalued
IMPVOL_UNDERVALUEDOption implied volatility is undervalued
# Simple Filter Properties
StockField
NONEunknown
STOCK_CODEStock code, does not accept list inputs as an interval
STOCK_NAMEStock name, does not accept list inputs as an interval
CUR_PRICEThe latest price
CUR_PRICE_TO_HIGHEST52_WEEKS_RATIO(CP - WH52) / WH52
CP: Current price
WH52: 52-week high
Corresponding to the “percentage from 52-week high” on the PC terminalCUR_PRICE_TO_LOWEST52_WEEKS_RATIO(CP - WL52) / WL52
CP: Current price
WL52: 52-week low
Corresponding to the “percentage from 52-week low” on the PC terminalHIGH_PRICE_TO_HIGHEST52_WEEKS_RATIO(TH - WH52) / WH52
TH: Today's high
WH52: 52-week high
LOW_PRICE_TO_LOWEST52_WEEKS_RATIO(TL - WL52) / WL52
TL: Today's low
WL52: 52-week low
VOLUME_RATIOVolume ratio
BID_ASK_RATIOBid-ask ratio
LOT_PRICEPrice per lot
MARKET_VALMarket value
PE_ANNUALTrailing P/E
PE_TTMP/E TTM
PB_RATEP/B ratio
CHANGE_RATE_5MINChange rate in 5 minutes
CHANGE_RATE_BEGIN_YEARPrice change rate from this year
PS_TTMP/S TTM
PCF_TTMPCF TTM
TOTAL_SHARETotal number of shares
FLOAT_SHAREShares outstanding
FLOAT_MARKET_VALMarket value outstanding
# Subscription Type
SubType
NONEUnknown
QUOTEBasic quote
ORDER_BOOKOrder book
TICKERTick-by-tick
RT_DATATime Frame
K_DAYDaily candlesticks
K_5M5 minutes candlesticks
K_15M15 minutes candlesticks
K_30M30 minutes candlesticks
K_60M60 minutes candlesticks
K_1M1 minute candlesticks
K_WEEKWeekly candlesticks
K_MONMonthly candlesticks
BROKERBroker's queue
K_QURATERSeasonal candlesticks
K_YEARAnnual candlesticks
K_3M3 minutes candlesticks
K_10M10 minutes candlesticks
K_120M120 minutes candlesticks (2 hours)
K_180M180 minutes candlesticks (3 hours)
K_240M240 minutes candlesticks (4 hours)
ORDER_BOOK_ODDOdd lot order book
# Order Book Type
OrderBookType
NORMALNormal order book (default)
ODDOdd lot order book
# Transaction Direction
TickerDirect
NONEunknown
BUYActive buy
SELLActive sell
NEUTRALNeutral transaction
# Tick-by-Tick Transaction Type
TickerType
UNKNOWNUnknown
AUTO_MATCHRegular sale
LATEPre-market trade
NON_AUTO_MATCHNon-regular sale
INTER_AUTO_MATCHRegular sale for same broker
INTER_NON_AUTO_MATCHNon-regular sale for same broker
ODD_LOTOdd lot trade
AUCTIONAuction trade
BULKBunched trade
CRASHCash trade
CROSS_MARKETIntermarket sweep
BULK_SOLDBunched sold trade
FREE_ON_BOARDPrice variation trade
RULE127_OR155Rule 127 (NYSE only) or Rule 155 (NYSE MKT only)
DELAYDelay the transaction
MARKET_CENTER_CLOSE_PRICEMarket center close price
NEXT_DAYNext day
MARKET_CENTER_OPENINGMarket center opening trade
PRIOR_REFERENCE_PRICEPrior reference price
MARKET_CENTER_OPEN_PRICEMarket center open price
SELLERSeller
TForm T(pre-open and post-close market trade)
EXTENDED_TRADING_HOURSExtended trading hours/sold out of sequence
CONTINGENTContingent trade
AVERAGE_PRICEAverage price trade
OTC_SOLDSold(out of sequence)
ODD_LOT_CROSS_MARKETOdd lot cross trade
DERIVATIVELY_PRICEDDerivatively priced
REOPENINGP_RICEDRe-Opening price
CLOSING_PRICEDClosing price
COMPREHENSIVE_DELAY_PRICEConsolidated late price per listing packet
OVERSEASOne party to the transaction is not a member of the Hong Kong Stock Exchange and is an over-the-counter transaction
# Check The Market on The Trading Day
TradeDateMarket
NONEUnknown
HKHK market
USUS market
CNA-share market
NTNorthbound Trading
STSouthbound Trading
JP_FUTUREJapanese future market
SG_FUTURESingapore future market
# Type of Trading Day
TradeDateType
WHOLEWhole day trading
MORNINGTrading in the morning, closed in the afternoon
AFTERNOONTrading in the afternoon, closed in the morning
# Warrant Status
WarrantStatus
NONEUnknown
NORMALNormal status
SUSPENDSuspended
STOP_TRADEStop trading
PENDING_LISTINGWaiting to be listed
# Warrant Type
WrtType
NONEUnknown
CALLLong warrants
PUTShort warrants
BULLCall warrants
BEARPut warrants
INLINEInline Warrants
# Exchange Type
ExchType
NONEUnknown
HK_MAINBOARDHKEx·Main Board
HK_GEMBOARDHKEx·GEM
HK_HKEXHKEx
US_NYSENYSE
US_NASDAQNASDAQ
US_PINKOTC Mkt
US_AMEXAMEX
US_OPTIONUS
US_NYMEXNYMEX
US_COMEXCOMEX
US_CBOTCBOT
US_CMECME
US_CBOECBOE
CN_SHSH Stock Ex
CN_SZSZ Stock Ex
CN_STIBSTAR
SG_SGXSGX
JP_OSEOSE
CC_CRYPTOCryptocurrency Exchange
# Quote Common Parameter Header
QotHeader
message QotHeader
{
optional int32 securityFirm = 1; //Security firm identifier, see Trd_Common.SecurityFirm
}
2
3
4
# Security Identification
Security
message Security
{
required int32 market = 1; //QotMarket, quote market
required string code = 2; //Code
}
2
3
4
5
# Candlestick data
KLine
message KLine
{
required string time = 1; //String of timestamp (Format: yyyy-MM-dd HH:mm:ss)
required bool isBlank = 2; //Whether it is a point with empty content, if it is true, only time information
optional double highPrice = 3; //High
optional double openPrice = 4; //Open
optional double lowPrice = 5; //Low
optional double closePrice = 6; //Close
optional double lastClosePrice = 7; //Close of the previous K-line
optional int64 volume = 8; //Volume
optional double turnover = 9; //Turnover
optional double turnoverRate = 10; // Turnover rate (this field is in decimal form, so 0.2 is equivalent to 20%)
optional double pe = 11; //P/E ratio
optional double changeRate = 12; //Yield (This field is in percentage form, so 20 is equivalent to 20%.)
optional double timestamp = 13; //Timestamp
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# Option Specific Fields of The Underlying Quote
OptionBasicQotExData
message OptionBasicQotExData
{
required double strikePrice = 1; //Strike price
required int32 contractSize = 2; //Contract size (integer)
optional double contractSizeFloat = 17; //Contract size (float)
required int32 openInterest = 3; //Number of open positions
required double impliedVolatility = 4; //Implied volatility (This field is in percentage form, so 20 is equivalent to 20%.)
required double premium = 5; //Premium (This field is in percentage form, so 20 is equivalent to 20%.)
required double delta = 6; //Greek value Delta
required double gamma = 7; //Greek value Gamma
required double vega = 8; //Greek value Vega
required double theta = 9; //Greek value Theta
required double rho = 10; //Greek value Rho
optional int32 netOpenInterest = 11; //Net open contract number , only HK options support this field
optional int32 expiryDateDistance = 12; //The number of days from the expiry date, a negative number means it has expired.
optional double contractNominalValue = 13; //Contract nominal amount , only HK options support this field
optional double ownerLotMultiplier = 14; //Equal number of underlying stocks, index options do not have this field , only HK options support this field
optional int32 optionAreaType = 15; //OptionAreaType, option type (by exercise time).
optional double contractMultiplier = 16; //Contract multiplier
optional int32 indexOptionType = 18; //Qot_Common.IndexOptionType, index option type
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# Futures Specific Fields of The Base Quote
FutureBasicQotExData
message FutureBasicQotExData
{
required double lastSettlePrice = 1; //Close yesterday
required int32 position = 2; //Hold position
required int32 positionChange = 3; //Daily change in position
optional int32 expiryDateDistance = 4; //The number of days from the expiration date
}
2
3
4
5
6
7
# Basic Quotation
BasicQot
message BasicQot
{
required Security security = 1; //Stock
optional string name = 24; // stock name
required bool isSuspended = 2; //whether trading is suspended
required string listTime = 3; //listed date string (This field is deprecated. Format: yyyy-MM-dd)
required double priceSpread = 4; //Spread
required string updateTime = 5; //Update time string of the latest price (Format: yyyy-MM-dd HH:mm:ss), not applicable to other fields
required double highPrice = 6; //High
required double openPrice = 7; //Open
required double lowPrice = 8; //low
required double curPrice = 9; //The latest price
required double lastClosePrice = 10; //Close yesterday
required int64 volume = 11; //Volume
required double turnover = 12; //Turnover
required double turnoverRate = 13; //Turnover rate (This field is in percentage form, so 20 is equivalent to 20%.)
required double amplitude = 14; //Amplitude (This field is in percentage form, so 20 is equivalent to 20%.)
optional int32 darkStatus = 15; //Grey market trading status
optional OptionBasicQotExData optionExData = 16; //Option specific field
optional double listTimestamp = 17; //Time stamp of listing date (This field is deprecated.)
optional double updateTimestamp = 18; //Update timestamp of the latest price, not applicable to other fields
optional PreAfterMarketData preMarket = 19; //Pre-market data
optional PreAfterMarketData afterMarket = 20; //After-hours data
optional int32 secStatus = 21; //Security status
optional FutureBasicQotExData futureExData = 22; //Futures specific field
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Before And After Data
PreAfterMarketData
//US stocks support pre-market and after-hours data
//The Sci-tech Innovation Plate only supports after-hours data: trading volume, turnover
message PreAfterMarketData
{
optional double price = 1; //Pre-market or after-hours## Price
optional double highPrice = 2; //Pre-market or after-hours## High
optional double lowPrice = 3; //Pre-market or after-hours## Low
optional int64 volume = 4; //Pre-market or after-hours## Volume
optional double turnover = 5; //Pre-market or after-hours## Turnover
optional double changeVal = 6; //Pre-market or after-hours## Change in price
optional double changeRate = 7; //Pre-market or after-hours## Yield (This field is in percentage form, so 20 is equivalent to 20%.)
optional double amplitude = 8; //Pre-market or after-hours## Amplitude (This field is in percentage form, so 20 is equivalent to 20%.)
}
2
3
4
5
6
7
8
9
10
11
12
13
# Time Frame Data
TimeShare
message TimeShare
{
required string time = 1; //Time string (Format: yyyy-MM-dd HH:mm:ss)
required int32 minute = 2; //Minutes after 0 o'clock
required bool isBlank = 3; //Whether the content is empty, if true, it contents only time
optional double price = 4; //Current price
optional double lastClosePrice = 5; //Close yesterday
optional double avgPrice = 6; //Average price
optional int64 volume = 7; //Volume
optional double turnover = 8; //Turnover
optional double timestamp = 9; //Timestamp
}
2
3
4
5
6
7
8
9
10
11
12
# Basic Static Information of Securities
SecurityStaticBasic
message SecurityStaticBasic
{
required Qot_Common.Security security = 1; //Stock
required int64 id = 2; //Stock ID
required int32 lotSize = 3; //Lot size, the option type represents the number of shares in a contract
required int32 secType = 4; //Qot_Common.SecurityType, stock type
required string name = 5; //Stock name
required string listTime = 6; //Listing time string (This field is deprecated. Format: yyyy-MM-dd)
optional bool delisting = 7; //Delisted or not
optional double listTimestamp = 8; //Listing timestamp (This field is deprecated.)
optional int32 exchType = 9; //Qot_Common.ExchType, Exchange Type
}
2
3
4
5
6
7
8
9
10
11
12
13
# Warrant Additional Static Information
WarrantStaticExData
message WarrantStaticExData
{
required int32 type = 1; //Qot_Common.WarrantType, Warrant Type
required Qot_Common.Security owner = 2; //The underlying stock
}
2
3
4
5
# Option Additional Static Information
OptionStaticExData
message OptionStaticExData
{
required int32 type = 1; //Qot_Common.OptionType, option
required Qot_Common.Security owner = 2; //Underlying stock
required string strikeTime = 3; //Exercise date (Format: yyyy-MM-dd)
required double strikePrice = 4; //Strike price
required bool suspend = 5; //Suspended or not
required string market = 6; //Issuance market name
optional double strikeTimestamp = 7; //Exercise date timestamp
optional int32 indexOptionType = 8; //Qot_Common.IndexOptionType, type of index option, only valid for index option
optional int32 expirationCycle = 9; // Qot_Common.ExpirationCycle, type of option expiration cycle
optional int32 optionStandardType = 10; // Qot_Common.OptionStandardType, type of option standard
optional int32 optionSettlementMode = 11; // OptionSettlementMode, mode of option settlement
}
2
3
4
5
6
7
8
9
10
11
12
13
14
# Additional Static Information About Futures
FutureStaticExData
message FutureStaticExData
{
required string lastTradeTime = 1; //The lastest trading day, only future non-main contracts have this field
optional double lastTradeTimestamp = 2; //The lastest trading day timestamp, only future non-main contracts have this field
required bool isMainContract = 3; //Futures main contract or not
}
2
3
4
5
6
# Securities Static Information
SecurityStaticInfo
message SecurityStaticInfo
{
required SecurityStaticBasic basic = 1; //Basic security information
optional WarrantStaticExData warrantExData = 2; //Additional information for warrants
optional OptionStaticExData optionExData = 3; //Additional information for options
optional FutureStaticExData futureExData = 4; //Additional information for futures
}
2
3
4
5
6
7
# Brokerage
Broker
message Broker
{
required int64 id = 1; //Broker ID
required string name = 2; //Broker name
required int32 pos = 3; //Broker position
//The following fields are specific to SF quote
optional int64 orderID = 4; //Exchange order ID, which is different from the order ID returned by the trading interface
optional int64 volume = 5; //Number of shares in order
}
2
3
4
5
6
7
8
9
10
# Tick-by-Tick
Ticker
message Ticker
{
required string time = 1; //Time string (Format: yyyy-MM-dd HH:mm:ss)
required int64 sequence = 2; //Unique identification
required int32 dir = 3; //TickerDirection, buy or sell direction
required double price = 4; //Price
required int64 volume = 5; //Volume
required double turnover = 6; // turnover
optional double recvTime = 7; //Local timestamp of received push data, used to locate delay
optional int32 type = 8; //TickerType, type by pen
optional int32 typeSign = 9; //Pattern-by-stroke type sign
optional int32 pushDataType = 10; //Used to distinguish push situations, this field is only available when pushing
optional double timestamp = 11; //time stamp}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
# Transaction File Details
OrderBookDetail
message OrderBookDetail
{
required int64 orderID = 1; //Exchange order ID, which is different from the order ID returned by the trading interface
required int64 volume = 2; //Number of shares in order
}
2
3
4
5
# Order Book
OrderBook
message OrderBook
{
required double price = 1; //Order price
required int64 volume = 2; //Order quantity
required int32 orederCount = 3; //Number of commissioned orders
repeated OrderBookDetail detailList = 4; //Order information, unique to HK SF, US LV2 market
}
2
3
4
5
6
7
# Changes in Holdings
ShareHoldingChange
message ShareHoldingChange
{
required string holderName = 1; //Holder name (institution name or fund name or executive name)
required double holdingQty = 2; //Current number of holdings
required double holdingRatio = 3; //Current shareholding percentage (This field is in percentage form, so 20 is equivalent to 20%.)
required double changeQty = 4; //The number of changes from the previous time
required double changeRatio = 5; //The percentage of change from the last time (This field is in percentage form, so 20 is equivalent to 20%.. It is the ratio relative to itself, not to total. For example, if the total share capital is 10,000 shares, holding 100 shares, the shareholding percentage is 1%, if 50 shares are sold, the change ratio is 50% instead of 0.5%)
required string time = 6; //Release time (Format: yyyy-MM-dd HH:mm:ss)
optional double timestamp = 7; //Timestamp
}
2
3
4
5
6
7
8
9
10
# Single Subscription Type Information
SubInfo
message SubInfo
{
required int32 subType = 1; //Qot_Common.SubType, subscription type
repeated Qot_Common.Security securityList = 2; //Subscribe to securities of this type of market
}
2
3
4
5
# Single Connection Subscription Information
ConnSubInfo
message ConnSubInfo
{
repeated SubInfo subInfoList = 1; //The connection subscription information
required int32 usedQuota = 2; //The subscription quota that the connection has used
required bool isOwnConnData = 3; //Used to distinguish whether it is self-connected data
optional int32 securityFirm = 4; //Security firm identifier, see Trd_Common.SecurityFirm
}
2
3
4
5
6
7
# Plate Information
PlateInfo
message PlateInfo
{
required Qot_Common.Security plate = 1; //Plate
required string name = 2; //Plate name
optional int32 plateType = 3; //Plate type, only 3207 (to get the plate to which the stock belongs) agreement returns this field
}
2
3
4
5
6
# Adjustment Information
Rehab
message Rehab
{
required string time = 1; //Time string (Format: yyyy-MM-dd)
required int64 companyActFlag = 2; //CompanyAct combination flag bit, which specifies whether certain field values are valid
required double fwdFactorA = 3; //Adjustments factor A
required double fwdFactorB = 4; //Adjustments factor B
required double bwdFactorA = 5; //Adjustments factor A
required double bwdFactorB = 6; //Adjustments factor B
optional int32 splitBase = 7; //Stock split (for example, 1 split 5, Base is 1, Ert is 5)
optional int32 splitErt = 8;
optional int32 joinBase = 9; //Reverse stock split (for example, 50 in 1, Base is 50, Ert is 1)
optional int32 joinErt = 10;
optional int32 bonusBase = 11; //Bonus shares (for example, 10 free 3, Base is 10, Ert is 3)
optional int32 bonusErt = 12;
optional int32 transferBase = 13; //Transfer bonus shares (for example, 10 to 3, Base is 10, Ert is 3)
optional int32 transferErt = 14;
optional int32 allotBase = 15; //Allotment (for example, 10 get 2 free, allotment price is 6.3 yuan, Base is 10, Ert is 2, and Price is 6.3)
optional int32 allotErt = 16;
optional double allotPrice = 17;
optional int32 addBase = 18; //Additional shares (for example, 10 get 2 free, additional issuance price is 6.3 yuan, Base is 10, Ert is 2, and Price is 6.3)
optional int32 addErt = 19;
optional double addPrice = 20;
optional double dividend = 21; //Cash dividend (for example, if every 10 shares are paid out 0.5 yuan, the field value is 0.05)
optional double spDividend = 22; //Special dividend (for example, if a special dividend is 0.5 yuan for every 10 shares, the value of this field is 0.05)
optional double timestamp = 23; //Timestamp
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
- For CompanyAct combination flag bit, refer to CompanyAct.
# Combo Leg Information
ComboLeg
message ComboLeg
{
required Qot_Common.Security security = 1; //Stock / option
optional int32 side = 2; //Direction, refer to Trd_Common.TrdSide
optional double qtyRatio = 3; //Quantity ratio
optional uint64 positionID = 4; //Position ID. Fill in only when closing moomoo JP positions; must be the positionID from option strategy view positions when showOptionStrategyView=True.
}
2
3
4
5
6
7
# Expiration Cycle
ExpirationCycle
NONEUnknown
WEEKWeekly options
MONTHMonthly options
END_OF_MONTHEnd-Of-Monthly options
QUARTERLYQuarterly options
WEEKMONMonthly options-Monday
WEEKTUEMonthly options-Tuesday
WEEKWEDMonthly options-Wednesday
WEEKTHUMonthly options-Thursday
WEEKFRIMonthly options-Friday
# Option Standard Type
OptionStandardType
NONEUnknown
STANDARDstandard options
NON_STANDARDnon-standard options
# Option Settlement Mode
OptionSettlementMode
NONEUnknown
AMAsian Pricing
PMPath-Dependent
# Stock Holder
StockHolder
NONEUnknown
INSTITUTEInstitute
FUNDFund
EXECUTIVEExecutives
# Screening V2 - SimpleField
Used for the
add_simple_field(field, values)method of get_stock_screen. All numeric fields accept raw values; OpenD performs magnification conversion automatically.
| field | Meaning | values |
|---|---|---|
| 1 | MARKET | ScrMarket: HK=1, US=2, CN=3, SG=4, CA=5, AU=6, JA=7, MY=8 |
| 2 | EXCHANGE / Listing venue | See QotMarket |
| 3 | INDEX_ID | Index constituent ID |
| 4 | USE_WATCHLIST | 0=No, 1=Yes |
| 5 | HAS_ADR Whether the stock has a related ADR | 0/1 |
| 6 | HAS_OPTION Whether the stock has options | 0/1 |
| 7 | HAS_WARRANT Whether the stock has warrants | 0/1 |
| 8 | HAS_FUTURE Whether the stock has futures | 0/1 |
| 9 | HAS_AH_STOCK Whether the stock has an A/H counterpart | 0/1 |
| 10 | IS_ISLAMIC Islamic stock | 0/1 |
| 11 | NORTH_BOUND_ID Northbound plate | Shanghai/Shenzhen Connect ID |
| 12 | MM_EXCLUSIVE_ID Moomoo exclusive plate | Plate ID |
For the full enum, see the
SimpleField/ScrMarketclasses instock_screen_const.pyof the SDK.
# Screening V2 - SimpleProperty
Used by
add_simple_property(name, lower, upper)andadd_retrieve_simple(name). Common factors are listed below; all numeric values are raw.
| name | Meaning |
|---|---|
| 2101 | LONG_MARGIN_ALLOWED Whether margin (long) is allowed (0/1) |
| 2103 | SHORT_MARGIN_ALLOWED Whether short selling is allowed (0/1) |
| 2201 | PRICE Last price |
| 2202 | OPEN_PRICE Open price |
| 2203 | LAST_CLOSE Previous close |
| 2204 | HIGH Today's high |
| 2205 | LOW Today's low |
| 2217 | VOLUME_RATIO Volume ratio |
| 2218 | BID_ASK_RATIO Bid-ask ratio |
| 2301 | MARKET_CAP Market cap |
| 2302 | PE_ANNUAL Static PE |
| 2303 | PE_TTM PE TTM |
| 2304 | PB Price/Book |
| 2305 | DIVIDEND_RATIO Dividend yield |
| 2306 | LISTED_DATE Listing date (timestamp) |
| 2307 | LISTED_DAYS Days since listing |
See the
SimplePropertyclass for the full enum (including margin trading, pre/post-market, overnight session, high-precision quotes, etc., 60+ items in total).
# Screening V2 - CumulativeProperty
Used by
add_cumulative_property(name, days, lower, upper)andadd_retrieve_cumulative(name, days). Requires thedaysargument.
| name | Meaning |
|---|---|
| 3101 | PRICE_CHANGE Price change |
| 3102 | PRICE_CHANGE_PCT Price change ratio (%) |
| 3103 | AMPLITUDE Price amplitude (%) |
| 3104 | AVG_VOLUME Average volume |
| 3105 | AVG_TURNOVER Average turnover |
| 3106 | TURNOVER_RATIO Turnover ratio (%) |
| 3107 | HIGH_TO_N_DAY_HIGH (today's high - N-day high) / N-day high |
| 3108 | LOW_TO_N_DAY_LOW (today's low - N-day low) / N-day low |
| 3109 | PRICE_CHANGE_HP High-precision price change |
# Screening V2 - FinancialProperty
Used by
add_financial_property(name, term, year, lower, upper)andadd_retrieve_financial(name, term, year). Requires thetermargument.
Common factors (see the
FinancialPropertyclass for the full enum, covering profitability / solvency / operating / growth / cash flow / financial surprise, 100+ items in total)name Meaning 4101 NET_PROFIT Net profit 4102 NET_PROFIT_GROWTH Net profit growth rate 4105 REVENUE Revenue 4106 REVENUE_GROWTH Revenue growth rate 4107 NET_PROFIT_RATIO Net profit margin 4108 GROSS_PROFIT_RATIO Gross profit margin 4109 DEBT_TO_ASSETS Debt-to-assets ratio 4110 ROE Return on equity 4202 ROIC Return on invested capital 4801 BASIC_EPS Basic EPS 4901 TOTAL_SHARE Total shares 4903 FLOAT_MARKET_CAP Float market cap 4904 PS_TTM Price-to-sales (TTM) 4905 PCF_TTM Price-to-cash-flow (TTM) Term (
Termenum)term Meaning 1 / 2 / 3 / 4 Q1 / Q2 / Q3 / Q4 single quarter 6 Q6 interim report (cumulative) 9 Q9 third-quarter report (cumulative) 10 LATEST Latest single quarter 100 ANNUAL Annual report (FY) 200~204 SURPRISE_LATEST series (financial forecast)
# Screening V2 - Indicator / Pattern / Period / Position
Used by
add_indicator_positional/add_indicator_pattern/add_retrieve_indicator.
Indicatortechnical indicators (first_indicator_name/second_indicatorofadd_indicator_positional)name Meaning 1 PRICE Last price 11~17 MA5 / MA10 / MA20 / MA30 / MA60 / MA120 / MA250 18 MA Dynamic simple moving average (requires indicator_params) 21~27 EMA5 / EMA10 / EMA20 / EMA30 / EMA60 / EMA120 / EMA250 28 EMA Dynamic exponential moving average 31~33 KDJ_K / KDJ_D / KDJ_J (KDJ(9,3,3)) 41~43 MACD_DIF / MACD_DEA / MACD_MACD (MACD(12,26,9)) 51 RSI_12 52 RSI Dynamic 61~63 BOLL_UPPER / BOLL_MIDDLE / BOLL_LOWER (BOLL(20,2)) 71 RVOL Dynamic relative volume Pattern(nameofadd_indicator_pattern)name Meaning 1 / 2 MA bullish / bearish alignment 3 / 4 EMA bullish / bearish alignment 11 / 12 KDJ low-level golden cross / high-level death cross 13 / 14 KDJ top divergence / bottom divergence 21 / 22 MACD low-level golden cross / high-level death cross 23 / 24 MACD top divergence / bottom divergence 31 / 32 RSI low-level golden cross / high-level death cross 33 / 34 RSI top divergence / bottom divergence Periodperiod Meaning 1 / 2 / 3 / 4 1 / 3 / 5 / 15 minutes 5 HOUR_1 1 hour 6 MINUTE_30 30 minutes 11 / 21 / 31 DAY / WEEK / MONTH Positionposition Meaning 1 OVER first is above second 2 BELOW first is below second 3 CROSS_UP first crosses above second 4 CROSS_DOWN first crosses below second ScrSortDirsort direction (directionofset_sort/add_sort)direction Meaning 1 ASC ascending 2 DESC descending 3 ABS_ASC absolute-value ascending 4 ABS_DESC absolute-value descending
# Screening V2 - BasicProperty / Retrieve fields
Used by retrieve methods such as
add_retrieve_basic(name). Other retrieve methods likeadd_retrieve_simple/add_retrieve_cumulative/add_retrieve_financialshare the SimpleProperty / CumulativeProperty / FinancialProperty IDs above.
BasicPropertybasic propertiesname Meaning Notes 1101 CODE Stock code sval 1102 NAME Stock name sval 1103 INDUSTRY Industry sval
Each result fills
sval(1)/ival(2)/aval(3)/dval(4)according to itsvalue_type. When ival is an enum code,enum_nameis decoded by the SDK (e.g. K-line shape returns'DOUBLE_BOTTOMS').
# Option Screening - OptUnderlyingIndicator
Used by
add_underlying_filter(indicator_type, ...)andadd_underlying_retrieve(indicator_type)of get_option_screen.
| indicator_type | Meaning | Notes |
|---|---|---|
| 101 | STOCK_LIST Specified underlying range | Pass a list of security code strings directly in values, e.g. ["US.AAPL", "HK.00700"] |
| 103 | PLATE Specified plate | Not yet supported on the backend; passing it raises an error |
| 106 | INDEX_LIST Specified index type | |
| 201 | VOLUME Total volume | |
| 202 | OPEN_INTEREST Total open interest | |
| 203 | IV Underlying implied volatility | |
| 204 | HV Underlying historical volatility | |
| 205 | IV_RANK | |
| 206 | IV_PERCENTILE | |
| 207 / 208 | IV_CHANGE / IV_CHANGE_RATIO | |
| 209 / 210 | IV_HV_RATIO / IV_HV_SPREAD | |
| 401 | MARKET_CAP Underlying market cap | |
| 402 | STOCK_PRICE Underlying last price | |
| 403 | CHANGE_RATIO Change ratio |
# Option Screening - OptIndicator
Used by
add_option_filter(indicator_type, ...)andadd_option_retrieve(indicator_type).
| indicator_type | Meaning | Notes |
|---|---|---|
| 1001 | STRIKE_PRICE Strike price | |
| 1002 | LEFT_DAY Days to expiration | |
| 1003 | OPTION_TYPE Option type | 1=CALL, 2=PUT |
| 1004 | EXERCISE_TYPE Exercise type | 1=American, 2=European |
| 1005 | EXPIRATION_TYPE Expiration type | 1=Weekly, 2=Monthly, 3=Quarterly |
| 1007 | STRIKE_DATE_TIMESTAMP Maturity date timestamp (seconds) | |
| 2001 | IN_THE_MONEY | 0=OTM, 1=ITM |
| 2002~2005 | PRICE / MID_PRICE / BID_PRICE / ASK_PRICE | |
| 2006~2009 | BID_ASK_SPREAD / BID_VOLUME / ASK_VOLUME / BID_ASK_VOLUME_RATIO | |
| 2010 | CHANGE_RATIO Change ratio | |
| 2011 / 2012 | VOLUME / TURNOVER | |
| 2013 / 2014 | OPEN_INTEREST / OPEN_INTEREST_MARKET_CAP | |
| 2018 | VOL_OI_RATIO | |
| 2021 | PREMIUM | Only sort/retrieve, filter is not supported |
| 3001 / 3002 / 3003 | IMPLIED_VOLATILITY / HISTORY_VOLATILITY / IV_HV_RATIO | |
| 3004~3008 | DELTA / GAMMA / VEGA / THETA / RHO | |
| 3009 / 3010 | LEVERAGE_RATIO / EFFECTIVE_GEARING | |
| 3011 / 3012 | BUY_TO_BEP / SELL_TO_BEP | |
| 3013 / 3014 | BUY_PROFIT_PROBABILITY / SELL_PROFIT_PROBABILITY | |
| 3015~3018 | INTRINSIC_VALUE_PER / TIME_VALUE_PER / ITM_DEGREE / OTM_DEGREE | |
| 3019 / 3020 | ITM_PROBABILITY / OTM_PROBABILITY |
# Warrant Screening V2 - WarrantField
Used by
add_interval_filter(field_id, ...)/add_choice_filter(field_id, choices)/add_sort(field_id, desc)of get_warrant_screen. All numeric fields accept raw values.
| field_id | Meaning | Filter type |
|---|---|---|
| 1 | CODE Security code | choice (text) |
| 2 | NAME Stock name | choice (text) |
| 4 | ISSUER_ID Issuer ID | choice |
| 5 | STOCK_OWNER Underlying stock ID | choice (accepts "HK.00700") |
| 6 | WARRANT_TYPE Warrant type | choice: 1=Call, 2=Put, 3=Bull, 4=Bear, 5=Inline |
| 7 | CONVERSION_RATIO Conversion ratio | interval |
| 8 | CURRENT_PRICE Current price | interval |
| 9 | STREET_RATIO Street ratio | interval |
| 10 | VOLUME | interval |
| 11 | MATURITY_DATE Maturity date (timestamp seconds) | interval |
| 12 | STRIKE_PRICE Strike price | interval |
| 13 | PREMIUM | interval (can be negative) |
| 14 | RECOVERY_PRICE Recovery price | interval |
| 15 | IMPLIED_VOLATILITY | interval |
| 16 | LEVERAGE_RATIO | interval |
| 17 | PRICE_RECOVERY_RATIO Underlying distance to recovery price % | interval |
| 18 | DELTA | interval |
| 19 | STATUS Warrant status | choice: 0=Normal, 1=Suspended, 2=Pre-IPO |
| 20 | IPO_TIME Listing time (timestamp seconds) | interval |
| 21 / 22 | BUY_VOL / SELL_VOL Bid / Ask volume | interval |
| 23 | EFFECTIVE_LEVERAGE | interval |
| 24 | LAST_CLOSE_PRICE Previous close | interval |
| 25 | TURNOVER | interval |
| 26 / 27 | SELL_PRICE / BUY_PRICE | interval |
| 28 / 29 | HIGH_PRICE / LOW_PRICE | interval |
| 30 | RATIO_ITM_OTM In/Out of the money | interval (can be negative) |
| 31 | BREAK_EVEN_POINT | interval |
| 32 | AMPLITUDE | interval |
| 33 | SCORE_FAXING SG score | interval |
| 34 | LAST_TRADE_DATE Last trade date (timestamp seconds) | interval |
| 35 | STREET_VOLUME Street volume | interval |
| 36 | LOT_SIZE Lot size | interval |
| 37 | ISSUE_SIZE Issue size | interval |
| 38 | IPO_PRICE IPO price | interval |
| 39 / 40 | LOWER_STRIKE_PRICE / UPPER_STRIKE_PRICE | interval (Inline only) |
| 41 | IW_PRICE_STATUS Inside / outside the range | choice |
| 42 | SENSITIVITY | interval |
| 43 | CONVERSION_PRICE Conversion price | interval |
| 44 / 45 | CHANGE_RATE / CHANGE_VALUE Change ratio / amount | interval |
| 51 | SCORE Composite score | interval |
| 52 | FILTER_NO_TRADE Filter out warrants with no trades | choice: 0=No, 1=Yes |
| 53 | CURRENCY_CODE Currency | choice |
| 54 | STOCK_OWNER_PRICE Underlying stock price | interval |
# Warrant Screening V2 - WarrantMarket / WarrantType / WarrantStatus
Common enums for
WarrantScreenRequest(warrant_market=...)andadd_choice_filter.
WarrantMarketmarket Meaning 1 HK Hong Kong 4 SG Singapore 15 MY Malaysia WarrantType(choice values for field_id=6)value Meaning 1 CALL 2 PUT 3 BULL 4 BEAR 5 INLINE WarrantStatus(choice values for field_id=19)value Meaning 0 NORMAL 1 SUSPEND Suspended 2 PRE_IPO Pre-IPO
# Option Market Type
OptionMarket
UNKNOWNUnknown
US_SECURITYUS Equity Options
US_INDEXUS Index Options
HK_SECURITYHK Equity Options
HK_INDEXHK Index Options
# Option Statistic Data Type
OptionStatisticDataType
UNKNOWNUnknown
VOLUMEVolume
OPEN_INTERESTOpen Interest
# Option HV Time Range
OptionHVTimeRange
UNKNOWNUnknown
THIRTY_DAY30 Days
SIXTY_DAY60 Days
NINETY_DAY90 Days
ONE_TWENTY_DAY120 Days
THREE_SIXTY_FIVE_DAY365 Days
# Option Rank Type
OptionRankType
UNKNOWNUnknown
VOLUMEVolume
TURNOVERTurnover
OIOpen Interest
OI_INCREMENTOI Increment (Daily)
OI_DECREMENTOI Decrement (Daily)
OI_MARKET_CAPOI Market Cap
OI_MARKET_CAP_INCREMENTOI Market Cap Increment (Daily)
OI_MARKET_CAP_DECREMENTOI Market Cap Decrement (Daily)
CHANGE_RATEChange Rate
IVImplied Volatility
# Zero DTE Sort Type
ZeroDteSortType
UNKNOWNUnknown
VOLUMEOption Volume
IVImplied Volatility
CHANGE_RATEChange Rate
OPEN_INTERESTOpen Interest
MARKET_CAPMarket Cap
# Zero DTE Indicator Type
ZeroDteIndicatorType
UNKNOWNUnknown
OWNER_LISTWatchlist
HAS_EARNINGS_THIS_WEEKHas Earnings This Week (0=All, 1=Yes, 2=No)
VOLUMETotal Option Volume
OPEN_INTERESTTotal Open Interest
IVImplied Volatility(%)
HVHistorical Volatility(%)
IV_RANKIV Rank(%)
IV_PERCENTILEIV Percentile(%)
PRICELast Price
CHANGE_RATEChange Rate(%)
# Zero DTE Contract Sort Type
ZeroDteContractSortType
UNKNOWNUnknown
VOLUMEVolume
OPEN_INTERESTOpen Interest
IVImplied Volatility
DELTADelta
# Zero DTE Contract Indicator Type
ZeroDteContractIndicatorType
UNKNOWNUnknown
OPTION_TYPEOption Direction (1=Call, 2=Put)
VOLUMEVolume
OPEN_INTERESTOpen Interest
IVImplied Volatility(%)
DELTADelta
GAMMAGamma
THETATheta
VEGAVega
RHORho
PRICELast Price
CHANGE_RATEChange Rate(%)
BREAK_EVEN_POINTBreak Even Point
TO_BEPDistance to BEP(%)
BUY_PROFIT_PROBABILITYBuy Profit Probability(%)
SELL_PROFIT_PROBABILITYSell Profit Probability(%)
# Earnings Sort Type
EarningsSortType
UNKNOWNUnknown
EARNINGS_DATEEarnings Date (Default)
VOLUMEOption Volume
IVImplied Volatility
MARKET_CAPMarket Cap
CHANGE_RATIOChange Rate
PRICELast Price
IV_RANKIV Rank
IV_PERCENTILEIV Percentile
HVHistorical Volatility
OPEN_INTERESTOpen Interest
LAST_REPORT_IV_CRUSHLast IV Crush
HISTORY_REPORT_IV_CRUSHHistorical IV Crush
LAST_REPORT_CHG_RATIOLast Earnings Day Change
HISTORY_REPORT_CHG_RATIOHistorical Earnings Day Change
ESTIMATE_EPS_YOYEstimated EPS YoY
ESTIMATE_REVENUE_YOYEstimated Revenue YoY
EXPECTED_MOVE_RATIOExpected Move
# Stock Category
StockCategory
ALLAll
EQUITYEquity
ETFETF
# Earnings Publication Type
EarningsPubType
UNKNOWNUnknown
BEFOREPre-market
AFTERAfter-hours
# Earnings Indicator Type
EarningsIndicatorType
UNKNOWNUnknown
OWNER_LISTWatchlist
INDEX_COMPONENTIndex Component
PLATEIndustry/Sector
MARKET_CAPMarket Cap
EXPIRATION_TYPEExpiration Type
IVImplied Volatility(%)
LAST_REPORT_IV_CRUSHLast IV Crush(%)
HISTORY_REPORT_IV_CRUSHHistorical IV Crush(%)
IV_RANKIV Rank(%)
IV_PERCENTILEIV Percentile(%)
VOLUMEOption Volume
OPEN_INTERESTOpen Interest
PRICELast Price
CHANGE_RATIOChange Rate(%)
EXPECTED_MOVE_RATIOExpected Move(%)
LAST_REPORT_CHG_RATIOLast Earnings Day Change(%)
HISTORY_REPORT_CHG_RATIOHistorical Earnings Day Change(%)
ESTIMATE_REVENUE_YOYEstimated Revenue YoY(%)
ESTIMATE_EPS_YOYEstimated EPS YoY(%)
EARNINGS_DAY_RANGEDays to Earnings
# Seller Type
SellerType
UNKNOWNUnknown
COVERED_CALLCovered Call
CASH_SECURED_PUTCash Secured Put
# Seller Sort Type
SellerSortType
UNKNOWNUnknown
ANNUALIZED_RETURNAnnualized Return (Default)
INTERVAL_RETURNInterval Return
ITM_PROBABILITYITM Probability
PREMIUMPremium
# Seller Indicator Type
SellerIndicatorType
UNKNOWNUnknown
OWNER_LISTWatchlist
STOCK_CATEGORYStock Category
VOLUMETotal Option Volume
OPEN_INTERESTTotal Open Interest
IVUnderlying IV(%)
HVUnderlying HV(%)
IV_RANKIV Rank(%)
IV_PERCENTILEIV Percentile(%)
MARKET_CAPMarket Cap
PRICELast Price
CHANGE_RATEChange Rate(%)
PLATESector
EXPIRATION_TYPEExpiration Type
LEFT_DAYSDays to Expiry
OPTION_TYPEOption Direction (1=Call, 2=Put)
OPTION_EXPIRATION_TYPEOption Expiration Type
STRIKE_DATE_TIMESTAMPExpiry Date Timestamp (sec)
PREMIUMPremium
ANNUALIZED_RETURNAnnualized Return(%)
INTERVAL_RETURNInterval Return(%)
OTM_DEGREEOTM Degree(%)
OTM_PROBABILITYOTM Probability(%)
OPTION_IVOption IV(%)
BID_PRICEBid Price
ASK_PRICEAsk Price
OPTION_VOLUMEOption Volume
OPTION_OPEN_INTERESTOption Open Interest
# Underlying Rank Sort Type
UnderlyingRankSortType
UNKNOWNUnknown
VOLUMETotal Volume
VOLUME_RATIOPut/Call Volume Ratio
OPEN_INTERESTTotal Open Interest
OPEN_INTEREST_RATIOPut/Call OI Ratio
PRICELast Price
PRICE_CHANGEChange Rate
IVIV
IV_CHANGEIV Change
HVHV
HV_CHANGEHV Change
IV_RANKIV Rank
IV_PERCENTILEIV Percentile
MARKET_CAPMarket Cap
# Underlying Rank Indicator Type
UnderlyingRankIndicatorType
UNKNOWNUnknown
OWNER_LISTWatchlist
STOCK_CATEGORYStock Category
VOLUMETotal Volume
OPEN_INTERESTTotal Open Interest
IVIV(%)
HVHV(%)
IV_RANKIV Rank(%)
IV_PERCENTILEIV Percentile(%)
IV_CHANGEIV Change(%)
HV_CHANGEHV Change(%)
VOLUME_RATIOVolume P/C Ratio(%)
OI_RATIOOI P/C Ratio(%)
MARKET_CAPMarket Cap
PRICELast Price
CHANGE_RATEChange Rate(%)
# Option Rank Indicator Type
OptionRankIndicatorType
UNKNOWNUnknown
STOCK_CATEGORYStock Category
MARKET_CAPMarket Cap
OWNER_LISTWatchlist
UNDERLYING_IVUnderlying IV(%)
UNDERLYING_HVUnderlying HV(%)
IV_RANKIV Rank(%)
IV_PERCENTILEIV Percentile(%)
IVImplied Volatility(%)
OPTION_TYPEDirection (Call/Put)
LEFT_DAYSDays to Expiry
IN_THE_MONEYITM/OTM (0=OTM, 1=ITM)
VOLUMEVolume
OPEN_INTERESTOpen Interest
DELTADelta
GAMMAGamma
THETATheta
VEGAVega
RHORho
# Expiration Type
ExpirationType
UNKNOWNUnknown
MONTHLYMonthly
WEEKLYWeekly
END_OF_MONTHEnd of Month
QUARTERLYQuarterly
# Index Component Type
IndexComponentType
UNKNOWNUnknown
DJIDow Jones
IXICNASDAQ Composite
NDXNASDAQ 100
SPXS&P 500
# Option Event Ticker Direction
EventTickerType
UNKNOWNUnknown
BUYActive Buy
SELLActive Sell
NEUTRALNeutral
# Option Event Order Type
AlertOrderType
NORMALNormal Order
SWEEPSweep
CROSSCross
FLOORFloor
# Strategy Type
TickerStrategy
UNKNOWNUnknown
SINGLE_LEGSingle Leg
MULTI_LEGMulti Leg
# Market Sentiment
MarketSentiment
UNKNOWNUnknown
BEARISHBearish
BULLISHBullish
NEUTRALNeutral
# Corporate Action Type
CorporateActionType
NONENone/Unknown
SPLITStock Split
JOINReverse Split
BONUS_STOCKBonus Share
INTO_SHARESBonus Issue
ALLOTRights Issue
ADDAdditional Issuance
DIVIDENDDividend
SPECIAL_DIVIDENDSpecial Dividend
SPIN_OFFSpin Off
# In/Out of The Money Type
InTheMoneyType
UNKNOWNUnknown
INIn The Money (ITM)
OUTOut of The Money (OTM)
# Event Indicator Type
EventIndicatorType
OWNER_LISTUnderlying list (security_list)
INDUSTRY_PLATEIndustry plate list (security_list)
CONCEPT_PLATEConcept plate list (security_list)
CORPORATE_ACTIONCorporate action type (value_list, CorporateActionType)
MARKET_CAPMarket cap (range)
OPTION_TYPECALL(1)/PUT(2) (value_list)
MONEY_TYPEITM(1)/OTM(2) (value_list)
STRIKE_PRICEStrike price (range)
EXPIRY_DAYSDays to expiry (range)
OTMOTM ratio (%) (range)
TICKER_TYPETicker direction (value_list, EventTickerType)
VOLUMEVolume (range)
TURNOVERTurnover (range)
PRICEPrice (range)
TIMEEvent time (range, Unix seconds)
MAX_DAY_NUMDay range (value_list, 0=today, 1=last 2 days ...)
ORDER_TYPEOrder type (value_list, AlertOrderType)
STRATEGYStrategy type (value_list, TickerStrategy)
SENTIMENTMarket sentiment (value_list, MarketSentiment)
TOTAL_VOLUMETotal option volume (range)
TOTAL_OITotal open interest (range)
VO_RATIOVolume/OI ratio (%) (range)
IVImplied volatility (%) (range)
DELTADelta (range)
GAMMAGamma (range)
VEGAVega (range)
THETATheta (range)
RHORho (range)
# Alert Operation Type
AlertOpType
UNKNOWNUnknown
ADDAdd
DELETEDelete
MODIFYModify
ENABLEEnable
DISABLEDisable
DELETE_ALLDelete All