Skip to content

Naming Dictionary

Enumeration value lookup table for all quote APIs. Fields referencing enums in API docs link back here.

sec_status (Security Status)

ValueDescription
NORMALNormal
LISTINGPending listing
PURCHASINGIPO subscription in progress
SUBSCRIBINGSubscribing
BEFORE_DARK_TRADE_OPEINGBefore dark pool opening
DARK_TRADINGDark pool trading
DARK_TRAD_ENDDark pool closed
TO_BE_OPENAwaiting market open
SUSPENDEDSuspended
CALLEDCalled back (CBBC)
EXPIRED_LAST_TRADING_DATEPast last trading date
EXPIREDExpired
DELISTEDDelisted
CHANGE_TO_TEMPORARY_CODEChanged to temporary code
TEMPORARY_CODE_TRADE_ENDTemporary code trading ended
CHANGED_PLATE_TRADE_ENDBoard changed, old code trading ended
CHANGED_CODE_TRAD_ENDCode changed, old code trading ended
RECOVERABLE_CIRCUIT_BREAKERRecoverable circuit breaker
UNRECOVERABLE_CIRCUIT_BREAKERUnrecoverable circuit breaker
AFTER_COMBINATIONAfter-hours matching
AFTER_TRANSACTIONAfter-hours trading
DARK_TRADE_SUSPENDDark pool suspended
EXPIRED_LAST_TRADING_TIMEPast last trading time
N/AUnknown / No mapping

dark_status (Dark Pool Status)

ValueDescription
TRADINGDark pool trading
ENDDark pool closed
N/ANot in dark pool

option_type (Option Direction)

ValueDescription
CALLCall
PUTPut
""Not an option

option_area_type (Option Exercise Type)

ValueDescription
AMERICANAmerican option
EUROPEANEuropean option
BERMUDABermuda option
""Not an option

trust_assetClass (Trust Fund Asset Class)

ValueDescription
STOCKEquity
BONDBond
COMMODITYCommodity
CURRENCY_MARKETMoney market
FUTUREFutures
SWAPSwap

ktype (K-line Type)

ValueDescription
11 minute
2Day
3Week
4Month
5Year
65 minutes
715 minutes
830 minutes
960 minutes
103 minutes
11Quarter
14120 minutes
15240 minutes
2610 minutes
29180 minutes

autype (Adjustment Type)

ValueDescription
0No adjustment
1Forward adjusted (excluding dividends)
2Backward adjusted (excluding dividends)
3Forward adjusted (including dividends)
4Backward adjusted (including dividends)

extended_time (Pre/Post Market Switch, US 1-min K-line only)

ValueDescription
0Default (exclude pre/post market)
1Include pre/post market
2Include overnight session

request_section (rt-data Trading Session, get_rt_data only)

ValueDescription
NORMALRegular session (default; HK includes dark pool)
FULLFull session including pre/post market (US only, excludes overnight)
PREMARKETUS pre-market
AFTERHOURSUS after-hours
HK_DARKHK dark pool
OVERNIGHTUS overnight

capital_flow_section (capital_flow Trading Session, request param; get_capital_flow only)

ValueDescription
NORMALRegular session (default; HK includes dark pool)
FULLFull session including pre/post market
PREMARKETPre-market only
AFTERHOURSAfter-hours only

capital_flow_history_period_type (capital_flow_history Period Type, request param)

ValueDescription
DAYDaily aggregation (default)
WEEKWeekly aggregation
MONTHMonthly aggregation

trade_section (Trading Session Type, response; by market)

ValueDescription
AUCTIONHK auction session
MORNINGHK morning session
AFTERNOONHK afternoon session
NIGHTNight session
US_PREMARKETUS pre-market
US_AFTERHOURSUS after-hours
HK_DARKHK dark pool
FUT_PART1Futures session 1
FUT_PART2Futures session 2
STIB_AFTERHOURSSTAR Market after-hours
US_OVERNIGHTUS overnight
US_REGULARUS regular session
DEFAULTDefault (general markets)
REGULARRegular session
US_INDEX_OPT_REGULARUS index option regular
US_INDEX_OPT_GLOBALUS index option global
US_INDEX_OPT_CURBUS index option CURB
JP_INDEX_OPT_NIGHTJP index option night
JP_INDEX_OPT_REGULARJP index option regular

trade_date_type (Trading Day Type, response)

ValueDescription
WHOLEFull-day trading
MORNINGMorning only
AFTERNOONAfternoon only

ticker_direction (Tick Direction)

ValueDescription
BUYBuy
SELLSell
NEUTRALNeutral (direction undetermined)

tick_type (Tick Trade Type)

Sourced from backend TickerType enum (32 values in total, listed by market usage frequency; rare values may still appear in specific products or historical data).

ValueDescription
UNKNOWNUnknown
AUTO_MATCHAutomatch (most common in HK)
LATELate trade
NON_AUTO_MATCHNon-automatch
ODD_LOTOdd lot
AUCTIONAuction
BULKBlock trade
OVERSEASOverseas trade
UNAUTO_MATCH_OFFNon-automatch off-exchange
NON_DIRECT_OFFNon-direct off-exchange
OVERSEAS_OFFOverseas off-exchange
AUTO_MATCH_OFFAutomatch off-exchange
BULK_OFFBlock trade off-exchange
LATE_OFFLate trade off-exchange
AUCTION_OFFAuction off-exchange
ODD_LOT_OFFOdd lot off-exchange
EVENINGEvening session trade
ACCEPT_ELECTRONICElectronic accepted
OUT_HOUR_CONTRACTAfter-hours contract
BANK_CHARGECCASS charge
ELECTRONICElectronic trade
HIGH_DENSITYHigh-density trade
INTERMEDIATE_PRICEIntermediate price trade
AT_AUCTIONAt-auction
AUCTION_LIMITAuction limit
AT_AUCTION_LIMITAt-auction limit
ENHANCE_LIMITEnhanced limit
HOT_QUOTEHot quote
MARKETMarket order
ROUND_LOTRound lot
SPECIAL_LOTSpecial lot
ODD_AND_SPECIAL_LOTOdd and special lot

period_type (Tick Period Type)

ValueDescription
NORMALRegular session
BEFOREPre-market
AFTERAfter-hours
OVERNIGHTOvernight

stock_type (Security Type)

ValueDescription
BONDExchange-traded bond
WEALTH_MANAGEWealth management fund
STOCKEquity
ETFETF / REIT / Trust
WARRANTWarrant (CBBC / Inline warrant)
IDXIndex
PLATESector / Plate
DRVTOption
FUTUREFutures
FOREXForex
CRYPTOCryptocurrency
OTC_STRUCT_NOTESWealth management structured notes
PLATESETPlate set
SECURITY_PORTFOLIOSecurity portfolio
ECMacro data
OPPORTUNITY_PORTFOLIOOpportunity portfolio
OLD_OTC_STRUCT_NOTESLegacy structured notes
PREDICTIONEvent contract
TOKENIZED_FUNDTokenized fund

state (Security Lifecycle State)

ValueDescription
NORMALNormal
PENDING_LISTINGPending listing
IPO_PURCHASING_CNA-share IPO subscription
IPO_PURCHASING_OTHEROther market IPO subscription
DARK_TRADE_PENDINGDark pool pending open
DARK_TRADE_HAPPENINGDark pool trading
DARK_TRADE_ENDDark pool closed
TO_BE_OPENAwaiting open
SUSPENDEDSuspended
CALLEDCalled back (CBBC)
EXPIRED_LAST_TRADING_DATELast trading date
EXPIREDExpired
DELISTEDDelisted
CHANGE_TO_TEMPORARY_CODEChanged to temporary code
TEMPORARY_CODE_END_TRADINGTemporary code trading ended
CHANGED_PLATE_END_TRADINGBoard changed, trading ended
CHANGED_CODE_END_TRADINGCode changed, trading ended
CIRCUIT_BREAKER_RECOVERABLERecoverable circuit breaker
CIRCUIT_BREAKER_UNRECOVERABLEUnrecoverable circuit breaker
AFTER_COMBINATIONAfter-hours matching
AFTER_TRANSACTIONAfter-hours trading
DARK_TRADE_SUSPENDDark pool suspended
EXPIRED_LAST_TRADING_TIMEPast last trading time

stock_child_type (Warrant Sub-type)

ValueDescription
N/ANot a warrant or unknown
CALLCall warrant
PUTPut warrant
BULLBull CBBC
BEARBear CBBC
INLINEInline warrant

action_type (Corporate Action Type, get_rehab)

ValueDescription
SPLITStock split
JOINReverse split
BONUS_STKBonus shares
INTOSHARESShare conversion (capital reserve)
ALLOTRights issue
ADDAdditional issue
DIVIDENDDividend
SPECIALDIVIDENDSpecial dividend
SPINOFFSpin-off

divi_mode (Dividend Adjustment Mode, get_rehab request param)

ValueDescription
compatLegacy compatibility (not recommended)
exclude_diviExclude dividends (Yahoo / Bloomberg convention)
include_diviInclude dividends (default; A-share / moomoo convention)

plate_type (Plate Type, response)

ValueDescription
INDUSTRYIndustry sector (GICS / SW classification)
CONCEPTConcept / Theme sector
REGIONRegional sector (SH/SZ A-share only)
OTHEROther sectors

market_state (Market Trading State, get_market_state response)

Maps to proto QotMarketState / MarketStatus, covering 0–37 in full; the API returns enum names (strings) directly.

ValueDescription
NONE (0)No trading / Unsupported market / Not open
AUCTION (1)Auction
WAITING_OPEN (2)Waiting for open
MORNING (3)Morning session
REST (4)Lunch break
AFTERNOON (5)Afternoon session
CLOSED (6)Closed
MAAUCTION (7)Matching Auction
PRE_MARKET_BEGIN (8)US pre-market begin
PRE_MARKET_END (9)US pre-market end
AFTER_HOURS_BEGIN (10)US after-hours begin
AFTER_HOURS_END (11)US after-hours end
FUTU_SWITCH_DATE (12)moomoo date switch
NIGHT_OPEN (13)Derivatives night session open
NIGHT_END (14)Derivatives night session close
FUTURE_DAY_OPEN (15)Futures day session open
FUTURE_DAY_BREAK (16)Futures day session break
FUTURE_DAY_CLOSE (17)Futures day session close
FUTURE_DAY_WAIT_OPEN (18)Futures day session waiting
HK_CAS (19)HK Closing Auction Session
FUTURE_NIGHT_WAIT (20)Futures night session waiting
FUTURE_AFTERNOON (21)Futures afternoon open (deprecated)
FUTURE_SWITCH_DATE (22)Derivatives date switch
FUTURE_OPEN (23)Derivatives open
FUTURE_BREAK (24)Derivatives break
FUTURE_BREAK_OVER (25)Derivatives break over
FUTURE_CLOSE (26)Derivatives close
STIB_AFTER_HOURS_WAIT (27)STAR Market after-hours matching wait
STIB_AFTER_HOURS_BEGIN (28)STAR Market after-hours begin
STIB_AFTER_HOURS_END (29)STAR Market after-hours end
CLOSE_AUCTION (30)Closing auction
AFTERNOON_END (31)Closed
NIGHT (32)Night session trading
OVERNIGHT_BEGIN (33)US overnight begin
OVERNIGHT_END (34)US overnight end
TRADE_AT_LAST (35)Trade at last
TRADE_AUCTION (36)Trade auction
OVERNIGHT (37)US overnight session

trade_section_type (Trading Session Type Numeric, get_market_state response)

Maps to proto quote_trade_section_type.TradeSectionType; the API returns raw integer values.

ValueDescription
US_PREMARKET (5)US pre-market
US_AFTERHOURS (6)US after-hours
US_OVERNIGHT (11)US overnight
US_REGULAR (12)US regular
DEFAULT (20)Default (HK / SH / SZ / Crypto / Forex)
REGULAR (21)Single session (US option regular)
US_INDEX_OPTION_REGULAR (22)US index option regular
US_INDEX_OPTION_GLOBAL (23)US index option global
US_INDEX_OPTION_CURB (24)US index option CURB
JP_INDEX_OPTION_NIGHT (25)JP index option night
JP_INDEX_OPTION_REGULAR (26)JP index option regular

market (Market Prefix)

The market request parameter used in plate and market screening APIs.

ValueDescription
HKHong Kong
USUnited States
SHShanghai A-share
SZShenzhen A-share
SGSingapore
JPJapan
AUAustralia
CACanada
MYMalaysia

SH and SZ share the same A-share plate set (calling SH or SZ is equivalent).

plate_class (Plate Classification)

ValueDescription
ALLAll plates
INDUSTRYIndustry plate
REGIONRegional plate (SH / SZ only)
CONCEPTConcept plate
OTHEROther plates

sort_field (Plate Stock Sort Field, get_plate_stock request param)

ValueDescription
NONENo sort (default, backend order)
CODEStock code
CHANGE_RATEChange rate
NAMEStock name
MARKET_VALTotal market cap
PRICE_CHANGE_VALPrice change value
CUR_PRICECurrent price
PRICE_CHANGE_SPEEDPrice change speed
TURNOVERTurnover
VOLUMEVolume
PRICE_HIGHESTHighest price
PRICE_LOWESTLowest price
PRICE_OPENOpening price
PRICE_LASTPrevious close
PEP/E ratio
ASK_PRICEAsk price
BID_PRICEBid price
ASK_VOLAsk volume
BID_VOLBid volume
TURNOVER_RATIOTurnover ratio
BUYSELL_RATIOBuy/sell ratio
VOLUME_RATIOVolume ratio
AMPLITUDEAmplitude
TOTAL_SHARESTotal shares
CIRC_TOTAL_SHARESCirculating shares
CIRC_MARKET_VALUECirculating market cap
DIVIDEND_RATIO_TTMDividend yield TTM
DIVIDEND_RATIO_LFYDividend yield LFY (last fiscal year)
PREMIUMPremium (warrants/CBBCs)
PRICE_RISE_COUNTConsecutive rise days
MARGINABLEMarginable
MORTGAGE_RATEMargin ratio
SHORT_SELLINGShort sellable
SHORT_REF_RATEShort selling reference rate
LONG_MARGIN_INITIAL_RATIOLong initial margin ratio
SHORT_MARGIN_INITIAL_RATIOShort initial margin ratio
IPO_PRICEIPO price
LIST_TIMEListing time
IPO_PEIPO P/E
IPO_PRICE_CHANGE_RATIOIPO cumulative change rate
CONTINUOUS_RISE_DAY_CNTIPO consecutive rise days
FIRST_DAY_PCRFirst day change rate
FIRST_DAY_REAL_PCRFirst day actual change rate
ISSUE_SIZEIssue size
PRE_CUR_PRICEPre-market current price
PRE_PRICE_CHANGE_VALPre-market price change value
PRE_CHANGE_RATEPre-market change rate
AFTER_CUR_PRICEAfter-hours current price
AFTER_PRICE_CHANGE_VALAfter-hours price change value
AFTER_CHANGE_RATEAfter-hours change rate
PRE_AMPLITUDEPre-market amplitude
AFTER_AMPLITUDEAfter-hours amplitude
PRE_TURNOVERPre-market turnover
AFTER_TURNOVERAfter-hours turnover
PRE_VOLUMEPre-market volume
AFTER_VOLUMEAfter-hours volume
HSG_HOLD_NUMStock Connect holdings
HSG_HOLD_RATIOStock Connect holdings ratio
CHANGE_RATIO_5_DAYS5-day change rate
CHANGE_RATIO_10_DAYS10-day change rate
CHANGE_RATIO_20_DAYS20-day change rate
CHANGE_RATIO_60_DAYS60-day change rate
CHANGE_RATIO_120_DAYS120-day change rate
CHANGE_RATIO_250_DAYS250-day change rate
CHANGE_RATIO_YEARYTD change rate
CHANGE_RATIO_5_MIN5-minute change rate
ADR_CODEADR related code
ADR_PRICEADR price
ADR_DIFF_PRICEADR premium/discount amount
ADR_DIFF_PERADR premium/discount percentage
ADR_CONVERTION_RATIOADR conversion ratio
ADR_RATIOADR ratio
ADR_TRAD_VOLADR trading volume
HSG_HOLD_AMOUNTStock Connect holdings amount
ADR_PRICE_HKADR HK related price
HSG_DAY_FLOWStock Connect daily flow
HSG_WEEK_FLOWStock Connect weekly flow
HSG_MONTH_FLOWStock Connect monthly flow
HSG_QUATER_FLOWStock Connect quarterly flow
TTM_PETTM P/E
ANNUAL_PEStatic P/E
BMP_PRICEDark pool price
BMP_PRICE_CHANGE_VALDark pool price change value
BMP_PRICE_CHANGE_RATEDark pool change rate
WEIGHTPlate weight
EFFECT_DOTImpact points
US_FUTURE_DEFAULTUS futures default sort
LAST_SETTLE_PRICELast settlement price (futures)
POSITIONOpen interest (futures)
POSITION_CHANGEDaily position change (futures)
LAST_TRADE_TIMELast trade time (futures)
EN_NAMEEnglish name
DARK_CHANGE_RATIODark pool change rate (legacy)
DARK_CHANGE_VALDark pool change value (legacy)
PBP/B ratio
TRUST_AUMTrust fund AUM
TRADE_INFOTrade info
CURRENCY_CODECurrency code
MATURITY_DATEMaturity date (warrants/convertible bonds)
RELATION_WEIGHTRelated weight
CONVERT_PREMINUM_RATIOConvertible bond premium rate
STRB_PREMIUM_RATIOStraddle warrant premium rate
PUT_LEVER_PRICEPut warrant leverage price
CALL_LEVER_PRICECall warrant leverage price
STRB_VALUEStraddle warrant value
CONVERT_STOCK_PRICEConvertible bond conversion price
WRNT_LAST_TRADE_DATEWarrant last trade date
CHANGE_RATIO_3_YEAR3-year change rate
JA_NAMEJapanese name
OVERNIGHT_PRICEOvernight price
OVERNIGHT_TURNOVEROvernight turnover
OVERNIGHT_VOLUMEOvernight volume
OVERNIGHT_AMPLITUDEOvernight amplitude
OVERNIGHT_PRICE_CHANGE_VALOvernight price change value
OVERNIGHT_CHANGE_RATEOvernight change rate
HOTPopularity
ETF_LEVERAGEETF leverage
DIVIDEND_TTMTTM dividend
PAYOUT_RATIO_LFYPayout ratio LFY
DISTRIBUTION_FREQUENCYDistribution frequency
MAX_DIVIDEND_GROW_YEARMax consecutive dividend growth years
DIVIDEND_INCREASE_RATE_1YEAR1-year dividend growth rate
AVERAGE_DIVIDEND_YIELD_5YEAR5-year average dividend yield
CHANGE_RATIO_24H24-hour change rate
DEBT_ASSET_RATIODebt-to-asset ratio
TH_NAMEThai name

price_type (Price Sort Basis, get_plate_stock request param)

ValueDescription
NORMALRegular price (default)
BEFOREPre-market price
AFTERAfter-hours price
OVERNIGHTOvernight price

statement_type (Financial Statement Type, request param)

ValueDescription
1Income statement
2Balance sheet
3Cash flow statement
4Key indicators

financial_type (Financial Period Type, request/response param)

ValueDescription
1Q1
2H1 (half year)
3Q3
4Q4
5Q6 (cumulative H1)
6Q9 (cumulative 3 quarters)
7Annual
10Latest (request param only)

financial_structure (Financial Structure ID, response)

Different statement_type values map to different structure sets; the same statement_type may map to different structures across markets (e.g., HK income statement → 5, US income statement → 8). Agents typically don't need to parse structure directly — each item_list element in the response already includes an inline display_name.

ValueDescriptionstatement_type
1Income Statement (US GAAP, Banking)1 Income
2Income Statement (US GAAP, Insurance)1 Income
3Income Statement (US GAAP, Industrial)1 Income
4Balance Sheet (US GAAP, Banking)2 Balance
5Income Statement (HK / IAS, General)1 Income
6Balance Sheet (HK / IAS, General)2 Balance
7Cash Flow Statement (US GAAP)3 Cash Flow
8Income Statement (US GAAP, General)1 Income
9Balance Sheet (US GAAP, General)2 Balance
10Income Statement (CN / CAS, Industrial)1 Income
11Balance Sheet (HK / IAS, Banking)2 Balance
12Income Statement (HK / IAS, Banking)1 Income
13Cash Flow Statement (HK / IAS)3 Cash Flow
14Key Indicators – Per Share4 Key Indicators
15Key Indicators – Profitability4 Key Indicators
16Key Indicators – Solvency4 Key Indicators
17Key Indicators – Growth4 Key Indicators
18Key Indicators – Operating Efficiency4 Key Indicators
19Key Indicators – Cash Flow4 Key Indicators

expiration_cycle (Option Expiration Cycle)

ValueDescription
MONTHMonthly
WEEKWeekly
END_OF_MONTHEnd of month
QUARTERLYQuarterly
WEEKMONMonday expiry
WEEKTUETuesday expiry
WEEKWEDWednesday expiry
WEEKTHUThursday expiry
WEEKFRIFriday expiry
N/AUnknown

index_option_type (Index Option Type, request param)

ValueMarketDescription
1HKHang Seng Index (HSI)
2HKH-shares Index (HSCEI)
3HKMini-HSI
4HKMini-HSCEI
5HKHang Seng TECH Index (HSTECH)
1000USFallback index option
1001USVIX
1002USSPX
1003USXSP
1004USNDX
1005USEFS
1006USMXS
1007USDJX
1008USOEX
1009USSIXB
1010USSIXI
1011USSIXM
1012USSIXU
1013USSIXV
1014USXEO
1015USBKX
1016USXAU
1017USOSX
1018USSOX
1019USUTY
1020USRUT
1021USSIXRE
1022USXND
1023USCBTX
1024USMBTX
2001JPN225
2002JPN225M
2003JPTOPIX

filter_standard (Standard/Non-standard Option Filter, request param)

ValueDescription
ALLAll (default)
STANDARDStandard options only
NON_STANDARDNon-standard options only (FLEX / adjusted contracts)

holder_type (Holder Type, request/response param)

Used in get_shareholders_holding_changes as holder_type (English text) / holder_type_id (numeric). Also used in get_shareholders_holder_detail as request_type (additionally includes 1000=All, default 1000).

holder_type_idholder_typeDescription
1Other InstitutionOther institution
2Traditional Investment ManagerTraditional investment manager
3Hedge Fund Manager / CTAHedge fund
4VC / PE FirmVenture capital / Private equity
5Corporate Pension Plan SponsorCorporate pension
6Foundation Fund SponsorFoundation fund
7Insurance CompanyInsurance company
8Bank / Investment BankBank / Investment bank
9Family Office / TrustFamily office / Trust
10Sovereign Wealth FundSovereign wealth fund
11REIT / Real Estate Investment ManagerREIT
12Structured Finance Pool ManagerStructured finance manager
13Union Pension Plan SponsorUnion pension
14Government Pension Plan SponsorGovernment pension
15Endowment Fund SponsorEndowment fund
100Individual InsiderIndividual
200ADR IssuerADS
300Public CorporationPublic corporation
400Private CorporationPrivate corporation
500State-Owned SharesState-owned shares

pub_type (Financial Report Disclosure Timing, response)

ValueDescription
0Same day (unspecified pre/post market)
1Pre-market
2Post-market

delivery_type (Delivery Type, get_future_info)

ValueDescription
UNKNOWNUnknown / Unspecified
PHYSICALPhysical delivery
CASHCash settlement

query_time_period (Option Volatility Query Period, request param)

ValueDescription
11 week
21 month (default)
33 months
46 months
51 year

impvol_status (Implied Volatility Analysis Status, response)

ValueDescription
FLUCTUATINGFluctuating
OVERVALUEDOvervalued
UNDERVALUEDUndervalued