ISIN、SEDOL、CIK、货币、交易代码、证券状态、交易时段与代码映射；不提供公告、资讯、研报或披露全文搜索。

get_reference_data · get_trading_status · get_symbol_mapping · get_market_hours

`get_reference_data` 证券参考数据

查询 ISIN、SEDOL、CIK、ADR、货币、交易码表、基础码表、权证关联表、债券码表等参考数据；不提供公告、资讯、研报或披露全文搜索。

调用工具集：reference。业务参数位置：arguments.params。

参数	类型	必填	默认值	可选值与约束	说明
`arguments.endpoint`	`string`	是	未声明	固定值：get_reference_data	选择本端点。
`arguments.params`	`object`	否	{}	未声明	业务参数对象；仅填写目标端点和分支声明的字段。
`market`	`string`	是	未声明	枚举："HK"；"US"；"CN"；"GLOBAL"	市场代码：HK=港股，CN=A股，US=美股，JP=日股，GLOBAL=债券。
`referenceType`	`string`	是	未声明	枚举："isin"；"sedol"；"trade_symbol"；"warrant_related"；"currency"；"basic_symbol"；"cik"；"adr"；"bond_codes"；"yield_codes"	referenceType 选择业务分支；字段适用范围见 parameterBranches。

查询分支：`market="HK"，referenceType="isin"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`isin`	`string`	否	未声明	未声明	非必填，国际证券识别码
`language`	`string`	否	未声明	枚举："简体"；"繁体"；"英文"	Only supports one of: 简体, 繁体, 英文. Default: 简体
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="HK"，referenceType="sedol"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`sedol`	`string`	否	未声明	未声明	非必填，英国及爱尔兰市场常用证券识别码
`language`	`string`	否	未声明	枚举："简体"；"繁体"；"英文"	Only supports one of: 简体, 繁体, 英文. Default: 简体
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="HK"，referenceType="trade_symbol"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`secType`	`string`	否	未声明	未声明	非必填字段，varchar(6)
`listBoard`	`string`	否	未声明	枚举："MAIN"；"GEM"	非必填，可选：MAIN（主板）、GEM（创业板）
`hsceFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`hsccFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`hsiFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`hkToSzFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`hkToShFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`isin`	`string`	否	未声明	未声明	非必填，国际证券识别码
`lotSize`	`integer`	否	未声明	未声明	非必填，证券每手交易单位
`tradeDate`	`string`	否	未声明	未声明	非必填，日期时间格式
`updateTime`	`string`	否	未声明	未声明	非必填，日期时间格式
`language`	`string`	否	未声明	枚举："简体"；"繁体"；"英文"	Only supports one of: 简体, 繁体, 英文. Default: 简体
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="HK"，referenceType="warrant_related"`

参数	类型	必填	默认值	可选值与约束	说明
`warrantCode`	`string`	否	未声明	未声明	非必填
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`language`	`string`	否	未声明	枚举："简体"；"繁体"；"英文"	Only supports one of: 简体, 繁体, 英文. Default: 简体
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="HK"，referenceType="currency"`

参数	类型	必填	默认值	可选值与约束	说明
`currency`	`string`	是	未声明	枚举："AED"；"AFN"；"ALL"；"AMD"；"ANG"；"AOA"；"ARS"；"AUD"；"AWG"；"AZN"；"BAM"；"BBD"；"BDT"；"BGN"；"BHD"；"BIF"；"BMD"；"BND"；"BOB"；"BOV"；"BRL"；"BSD"；"BTN"；"BWP"；"BYN"；"BZD"；"CAD"；"CDF"；"CHF"；"CLF"；"CLP"；"CNH"；"CNY"；"COP"；"COU"；"CRC"；"CUC"；"CUP"；"CVE"；"CZK"；"DJF"；"DKK"；"DOP"；"DZD"；"EGP"；"ERN"；"ETB"；"EUR"；"FJD"；"FKP"；"GBP"；"GBX"；"GEL"；"GHS"；"GIP"；"GMD"；"GNF"；"GTQ"；"GYD"；"HKD"；"HNL"；"HRK"；"HTG"；"HUF"；"IDR"；"ILS"；"ILX"；"INR"；"IQD"；"IRR"；"ISK"；"JMD"；"JOD"；"JPY"；"KES"；"KGS"；"KHR"；"KMF"；"KPW"；"KRW"；"KWD"；"KYD"；"KZT"；"LAK"；"LBP"；"LKR"；"LRD"；"LSL"；"LYD"；"MAD"；"MDL"；"MGA"；"MKD"；"MMK"；"MNT"；"MOP"；"MRU"；"MUR"；"MVR"；"MWK"；"MXN"；"MXV"；"MYR"；"MZN"；"NAD"；"NGN"；"NIO"；"NOK"；"NPR"；"NZD"；"OMR"；"PAB"；"PEN"；"PGK"；"PHP"；"PKR"；"PLN"；"PYG"；"QAR"；"RON"；"RSD"；"RUB"；"RWF"；"SAR"；"SBD"；"SCR"；"SDG"；"SEK"；"SGD"；"SHP"；"SLL"；"SOS"；"SRD"；"SSP"；"STD"；"SYP"；"SZL"；"THB"；"TJS"；"TMT"；"TND"；"TOP"；"TRY"；"TTD"；"TWD"；"TZS"；"UAH"；"UGX"；"USD"；"UYU"；"UZS"；"VES"；"VND"；"VUV"；"WST"；"XAF"；"XAG"；"XAU"；"XCD"；"XDR"；"XOF"；"XPD"；"XPF"；"XPT"；"YER"；"ZAR"；"ZMW"；"ZWL"	货币标识；仅接受该分支声明的类型，不从证券市场推断缺失币种。
`startDate`	`string`	否	未声明	未声明	非必填，格式 yyyy-MM-dd，用于筛选日期范围起点
`endDate`	`string`	否	未声明	未声明	非必填，格式 yyyy-MM-dd，用于筛选日期范围终点
`sort`	`string`	否	未声明	枚举："desc"；"asc"；"DESC"；"ASC"	非必填，desc=倒序，asc=正序，默认 desc
`language`	`string`	否	未声明	枚举："简体"；"繁体"；"英文"	Only supports one of: 简体, 繁体, 英文. Default: 简体

查询分支：`market="HK"，referenceType="basic_symbol"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`listMarket`	`string`	否	未声明	未声明	非必填字段，varchar(10)
`listBoard`	`string`	否	未声明	枚举："MAIN"；"GEM"	非必填，可选：MAIN（主板）、GEM（创业板）
`hkexInstrumentType`	`string`	否	未声明	未声明	非必填字段，varchar(6)
`fiuInstrumentType`	`string`	否	未声明	未声明	示例值：1
`aShareCode`	`string`	否	未声明	未声明	非必填，用于按A股代码筛选
`hsiFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`hsceFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`hsccFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`hkToShFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`hkToSzFlag`	`string`	否	未声明	未声明	非必填，Y=是，N=否
`companyReportKind`	`string`	否	未声明	未声明	非必填字段，varchar(2)
`language`	`string`	否	未声明	枚举："简体"；"繁体"；"英文"	Only supports one of: 简体, 繁体, 英文. Default: 简体
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="US"，referenceType="cik"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`cik`	`string`	否	未声明	未声明	通过CIK码查找
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

查询分支：`market="US"，referenceType="isin"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`isin`	`string`	否	未声明	未声明	非必填，国际证券识别码
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="US"，referenceType="sedol"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`sedol`	`string`	否	未声明	未声明	非必填，英国及爱尔兰市场常用证券识别码
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="US"，referenceType="adr"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="US"，referenceType="trade_symbol"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`cqs`	`string`	否	未声明	未声明	非必填，varchar(32)类型
`isin`	`string`	否	未声明	未声明	非必填，国际证券识别码
`exchange`	`string`	否	未声明	枚举："Q"；"G"；"S"；"N"；"A"；"P"；"Z"；"V"	非必填，varchar(4)类型，由NASDAQ提供，标识股票的上市市场或市场等级 Q=Nasdaq全球精选市场 G=Nasdaq全球市场 S=Nasdaq资本市场 N=NYSE纽约交易所 A=NYSE MKT（AMEX）- 纽约证券交易所美国交易所 P=NYSE Arca - 纽约证券交易所Arca板 Z=BATS交易所 V=Investor's Exchange，LLC - 投资者交易所
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="US"，referenceType="warrant_related"`

参数	类型	必填	默认值	可选值与约束	说明
`warrantCode`	`string`	否	未声明	未声明	非必填
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="US"，referenceType="currency"`

参数	类型	必填	默认值	可选值与约束	说明
`currency`	`string`	是	未声明	枚举："AED"；"AFN"；"ALL"；"AMD"；"ANG"；"AOA"；"ARS"；"AUD"；"AWG"；"AZN"；"BAM"；"BBD"；"BDT"；"BGN"；"BHD"；"BIF"；"BMD"；"BND"；"BOB"；"BOV"；"BRL"；"BSD"；"BTN"；"BWP"；"BYN"；"BZD"；"CAD"；"CDF"；"CHF"；"CLF"；"CLP"；"CNH"；"CNY"；"COP"；"COU"；"CRC"；"CUC"；"CUP"；"CVE"；"CZK"；"DJF"；"DKK"；"DOP"；"DZD"；"EGP"；"ERN"；"ETB"；"EUR"；"FJD"；"FKP"；"GBP"；"GBX"；"GEL"；"GHS"；"GIP"；"GMD"；"GNF"；"GTQ"；"GYD"；"HKD"；"HNL"；"HRK"；"HTG"；"HUF"；"IDR"；"ILS"；"ILX"；"INR"；"IQD"；"IRR"；"ISK"；"JMD"；"JOD"；"JPY"；"KES"；"KGS"；"KHR"；"KMF"；"KPW"；"KRW"；"KWD"；"KYD"；"KZT"；"LAK"；"LBP"；"LKR"；"LRD"；"LSL"；"LYD"；"MAD"；"MDL"；"MGA"；"MKD"；"MMK"；"MNT"；"MOP"；"MRU"；"MUR"；"MVR"；"MWK"；"MXN"；"MXV"；"MYR"；"MZN"；"NAD"；"NGN"；"NIO"；"NOK"；"NPR"；"NZD"；"OMR"；"PAB"；"PEN"；"PGK"；"PHP"；"PKR"；"PLN"；"PYG"；"QAR"；"RON"；"RSD"；"RUB"；"RWF"；"SAR"；"SBD"；"SCR"；"SDG"；"SEK"；"SGD"；"SHP"；"SLL"；"SOS"；"SRD"；"SSP"；"STD"；"SYP"；"SZL"；"THB"；"TJS"；"TMT"；"TND"；"TOP"；"TRY"；"TTD"；"TWD"；"TZS"；"UAH"；"UGX"；"USD"；"UYU"；"UZS"；"VES"；"VND"；"VUV"；"WST"；"XAF"；"XAG"；"XAU"；"XCD"；"XDR"；"XOF"；"XPD"；"XPF"；"XPT"；"YER"；"ZAR"；"ZMW"；"ZWL"	货币标识；仅接受该分支声明的类型，不从证券市场推断缺失币种。
`startDate`	`string`	否	未声明	未声明	非必填，格式 yyyy-MM-dd，用于筛选日期范围起点
`endDate`	`string`	否	未声明	未声明	非必填，格式 yyyy-MM-dd，用于筛选日期范围终点
`sort`	`string`	否	未声明	枚举："desc"；"asc"；"DESC"；"ASC"	非必填，desc=倒序，asc=正序，默认 desc

查询分支：`market="CN"，referenceType="isin"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`isin`	`string`	否	未声明	未声明	非必填，国际证券识别码
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="CN"，referenceType="sedol"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`sedol`	`string`	否	未声明	未声明	非必填，英国及爱尔兰市场常用证券识别码
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

查询分支：`market="CN"，referenceType="currency"`

参数	类型	必填	默认值	可选值与约束	说明
`currency`	`string`	是	未声明	枚举："AED"；"AFN"；"ALL"；"AMD"；"ANG"；"AOA"；"ARS"；"AUD"；"AWG"；"AZN"；"BAM"；"BBD"；"BDT"；"BGN"；"BHD"；"BIF"；"BMD"；"BND"；"BOB"；"BOV"；"BRL"；"BSD"；"BTN"；"BWP"；"BYN"；"BZD"；"CAD"；"CDF"；"CHF"；"CLF"；"CLP"；"CNH"；"CNY"；"COP"；"COU"；"CRC"；"CUC"；"CUP"；"CVE"；"CZK"；"DJF"；"DKK"；"DOP"；"DZD"；"EGP"；"ERN"；"ETB"；"EUR"；"FJD"；"FKP"；"GBP"；"GBX"；"GEL"；"GHS"；"GIP"；"GMD"；"GNF"；"GTQ"；"GYD"；"HKD"；"HNL"；"HRK"；"HTG"；"HUF"；"IDR"；"ILS"；"ILX"；"INR"；"IQD"；"IRR"；"ISK"；"JMD"；"JOD"；"JPY"；"KES"；"KGS"；"KHR"；"KMF"；"KPW"；"KRW"；"KWD"；"KYD"；"KZT"；"LAK"；"LBP"；"LKR"；"LRD"；"LSL"；"LYD"；"MAD"；"MDL"；"MGA"；"MKD"；"MMK"；"MNT"；"MOP"；"MRU"；"MUR"；"MVR"；"MWK"；"MXN"；"MXV"；"MYR"；"MZN"；"NAD"；"NGN"；"NIO"；"NOK"；"NPR"；"NZD"；"OMR"；"PAB"；"PEN"；"PGK"；"PHP"；"PKR"；"PLN"；"PYG"；"QAR"；"RON"；"RSD"；"RUB"；"RWF"；"SAR"；"SBD"；"SCR"；"SDG"；"SEK"；"SGD"；"SHP"；"SLL"；"SOS"；"SRD"；"SSP"；"STD"；"SYP"；"SZL"；"THB"；"TJS"；"TMT"；"TND"；"TOP"；"TRY"；"TTD"；"TWD"；"TZS"；"UAH"；"UGX"；"USD"；"UYU"；"UZS"；"VES"；"VND"；"VUV"；"WST"；"XAF"；"XAG"；"XAU"；"XCD"；"XDR"；"XOF"；"XPD"；"XPF"；"XPT"；"YER"；"ZAR"；"ZMW"；"ZWL"	货币标识；仅接受该分支声明的类型，不从证券市场推断缺失币种。
`startDate`	`string`	否	未声明	未声明	非必填，格式 yyyy-MM-dd，用于筛选日期范围起点
`endDate`	`string`	否	未声明	未声明	非必填，格式 yyyy-MM-dd，用于筛选日期范围终点
`sort`	`string`	否	未声明	枚举："desc"；"asc"；"DESC"；"ASC"	非必填，desc=倒序，asc=正序，默认 desc

查询分支：`market="CN"，referenceType="basic_symbol"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`listMarket`	`string`	否	未声明	枚举："上海证券交易所"；"深圳证券交易所"	非必填，可取值：上海证券交易所、深圳证券交易所，示例值：深圳证券交易所
`listBoard`	`string`	否	未声明	枚举："主板"；"创业板"；"科创板"；"深交所退市整理板"；"上交所风险警示板"	非必填，可选：主板、创业板、科创板、深交所退市整理板、上交所风险警示板
`fiuInstrumentType`	`integer`	否	未声明	未声明	示例值：1
`hkShareCode`	`string`	否	未声明	未声明	非必填，用于按港股代码筛选
`hsiFlag`	`string`	否	未声明	枚举："Y"；"N"	非必填，Y=是，N=否
`hsToHkFlag`	`integer`	否	未声明	枚举："Y"；"N"	非必填，Y=是、N=否
`companyReportKind`	`integer`	否	未声明	枚举：0；1；2；3	非必填，0=一般企业，1=银行，2=保险，3=证券
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="GLOBAL"，referenceType="bond_codes"`

参数	类型	必填	默认值	可选值与约束	说明
`country`	`string`	否	未声明	枚举："CHN"；"HKG"；"USA"；"all"	债券风险所在地（Country of Risk），不传或传 all 表示全部。
`currency`	`string`	否	未声明	枚举："CNY"；"EUR"；"GBP"；"HKD"；"USD"；"all"	货币标识；仅接受该分支声明的类型，不从证券市场推断缺失币种。
`pageNum`	`integer`	否	1	最小值：1	页码，从 1 开始。
`pageSize`	`integer`	否	20	最小值：1	每页记录数，正整数，默认 20。
`region`	`integer`	否	未声明	枚举：1；2；3	地区：1 表示美洲地区，2 表示亚太地区，3 表示欧非中东。
`state`	`integer`	否	未声明	未声明	当前债券状态。
`subtype`	`integer`	否	未声明	枚举：1；2；3；4	债券子类型。
`type`	`integer`	否	未声明	枚举：1；2；3	债券类型

查询分支：`market="GLOBAL"，referenceType="yield_codes"`

参数	类型	必填	默认值	可选值与约束	说明
`country`	`string`	否	未声明	枚举："CHN"；"HKG"；"USA"；"all"	债券风险所在地（Country of Risk），不传或传 all 表示全部。
`pageNum`	`integer`	否	1	最小值：1	页码，从 1 开始。
`pageSize`	`integer`	否	20	最小值：1	每页记录数，正整数，默认 20。
`region`	`integer`	否	未声明	枚举：1；2；3	地区：1 表示美洲地区，2 表示亚太地区，3 表示欧非中东。

请求示例与补充说明

{
  "name": "reference",
  "arguments": {
    "endpoint": "get_reference_data",
    "params": {
      "market": "HK",
      "referenceType": "isin",
      "symbol": "00700.hk"
    }
  }
}

补充说明：

按 market 与 referenceType 选择分支；仅传该分支声明的参数。ISIN/SEDOL 仅回显请求或来源值全空时为 empty，不能据此认定该证券没有标识。
GLOBAL + bond_codes 默认 pageNum=1、pageSize=20。导航按当前请求、实际 list 长度和一致总数重算，sourcePagination 保留原始分页。
后续空页的总数被下游清零时，同筛选条件回查首页；确认越界返回 PAGE_OUT_OF_RANGE，无法确认返回 PAGE_EMPTY_UNCONFIRMED、total/pages=null。首页核验异常仍作为错误返回。
本工具集按完整响应交付，预算为 128,000 字符；超出时返回 RESPONSE_TOO_LARGE，请缩小 pageSize 或批量证券数。
分支 market="HK"，referenceType="basic_symbol"；响应 dataType：object[]
分支 market="HK"，referenceType="basic_symbol"；响应 fieldTypes：{"tradingStatus":"string|null","fiuInstrumentType":"string|null","companyReportKind":"string|null","listMarket":"string|null","tradingCurrency":"string|null"}
分支 market="HK"，referenceType="basic_symbol"；响应 semantics：listMarket 保留来源代码或名称；原码不能跨市场比较，币种 null 不推断。
分支 market="CN"，referenceType="basic_symbol"；响应 dataType：object[]
分支 market="CN"，referenceType="basic_symbol"；响应 fieldTypes：{"tradingStatus":"number|null","fiuInstrumentType":"number|null","companyReportKind":"number|null","listMarket":"string|null","tradingCurrency":"string|null"}
分支 market="CN"，referenceType="basic_symbol"；响应 semantics：listMarket 保留来源代码或名称；原码不能跨市场比较，币种 null 不推断。

返回本工具集 · 返回入参目录

`get_trading_status` 证券与交易状态

查询交易日期、交易时段、除权事件、证券状态、退市列表等状态类数据。

调用工具集：reference。业务参数位置：arguments.params。

参数	类型	必填	默认值	可选值与约束	说明
`arguments.endpoint`	`string`	是	未声明	固定值：get_trading_status	选择本端点。
`arguments.params`	`object`	否	{}	未声明	业务参数对象；仅填写目标端点和分支声明的字段。
`market`	`string`	是	未声明	枚举："HK"；"US"；"CN"；"JP"；"GLOBAL"	市场代码：HK=港股，CN=A股，US=美股，JP=日股，GLOBAL=债券。
`statusType`	`string`	是	未声明	枚举："trade_date"；"session"；"exright"；"security"；"delisted"；"current"；"bond_session"；"yield_session"	statusType 选择业务分支；字段适用范围见 parameterBranches。

查询分支：`market="HK"，statusType="trade_date"`

参数	类型	必填	默认值	可选值与约束	说明
`date`	`string`	否	未声明	未声明	锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。
`filterStatus`	`string`	否	"Y"	枚举："Y"；"N"；"H"；"ALL"	交易日状态：Y=交易日，N=非交易日，H=半日交易（仅港股），ALL=不筛选状态。
`orderMode`	`integer`	否	1	枚举：0；1	查询方向：0=以 date 为结束点向前查询，1=以 date 为起点向后查询，包含锚定日。
`stockConnect`	`string`	否	未声明	枚举："NB"；"SB"	日历范围：NB=北向，SB=南向；不传使用本市场日历。通道休市不代表交易所休市。
`pageNum`	`integer`	否	1	最小值：1	页码，从 1 开始。
`pageSize`	`integer`	否	20	最小值：1	每页记录数，正整数，默认 20。

查询分支：`market="HK"，statusType="session"`

参数	类型	必填	默认值	可选值与约束	说明
`board`	`string`	否	未声明	枚举："MAIN"；"GEM"；"NASD"；"ETS"	市场类别筛选：MAIN=主板、GEM=创业板、NASD=NASDAQ AMX市场、ETS=扩充交易证券；不传返回全部类别。不是交易时段 ID，不支持 symbol/symbols 筛选。
`timeMode`	`integer`	否	0	枚举：0；1	时间模式：0=实时，1=延时。

查询分支：`market="HK"，statusType="exright"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

查询分支：`market="HK"，statusType="security"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	本地精确筛选停复牌列表；未命中不表示正常交易。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1000	本地按代码筛选停复牌列表；一次查询。

查询分支：`market="US"，statusType="trade_date"`

参数	类型	必填	默认值	可选值与约束	说明
`date`	`string`	否	未声明	未声明	锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。
`orderMode`	`integer`	否	0	枚举：0；1	查询方向：0=以 date 为结束点向前查询，1=以 date 为起点向后查询，包含锚定日。
`filterStatus`	`string`	否	"Y"	枚举："Y"；"N"；"ALL"	交易日状态：Y=交易日，N=非交易日，H=半日交易（仅港股），ALL=不筛选状态。
`pageNum`	`integer`	否	1	最小值：1	页码，从 1 开始。
`pageSize`	`integer`	否	20	最小值：1	每页记录数，正整数，默认 20。

查询分支：`market="US"，statusType="session"`

此分支无需额外业务参数。

查询分支：`market="US"，statusType="exright"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

查询分支：`market="US"，statusType="delisted"`

参数	类型	必填	默认值	可选值与约束	说明
`date`	`integer`	否	未声明	未声明	锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。
`exchange`	`string`	否	未声明	枚举："Q"；"N"；"A"；"OTC"	美股退市列表的市场类别：Q、N、A、OTC；对应 market，不是组合市场 US。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1000	证券代码数组；只支持单证券的分支最多传 1 个。
`symbol`	`string`	否	未声明	未声明	单证券查询写法，与 symbols 二选一。

查询分支：`market="US"，statusType="security"`

参数	类型	必填	默认值	可选值与约束	说明
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1000	证券代码数组；只支持单证券的分支最多传 1 个。
`symbol`	`string`	否	未声明	未声明	单证券查询写法，与 symbols 二选一。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

查询分支：`market="CN"，statusType="trade_date"`

参数	类型	必填	默认值	可选值与约束	说明
`date`	`string`	否	未声明	未声明	锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。
`orderMode`	`integer`	否	0	枚举：0；1	查询方向：0=以 date 为结束点向前查询，1=以 date 为起点向后查询，包含锚定日。
`filterStatus`	`string`	否	"Y"	枚举："Y"；"N"；"ALL"	交易日状态：Y=交易日，N=非交易日，H=半日交易（仅港股），ALL=不筛选状态。
`stockConnect`	`string`	否	未声明	枚举："NB"；"SB"	日历范围：NB=北向，SB=南向；不传使用本市场日历。通道休市不代表交易所休市。
`pageNum`	`integer`	否	1	最小值：1	页码，从 1 开始。
`pageSize`	`integer`	否	20	最小值：1	每页记录数，正整数，默认 20。

查询分支：`market="CN"，statusType="session"`

参数	类型	必填	默认值	可选值与约束	说明
`board`	`string`	否	"1"	枚举："1"；"3"；"6"	主板1，创业板3，科创板6，不填默认所有

查询分支：`market="CN"，statusType="exright"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

查询分支：`market="CN"，statusType="current"`

此分支无需额外业务参数。

查询分支：`market="CN"，statusType="security"`

参数	类型	必填	默认值	可选值与约束	说明
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1000	证券代码数组；只支持单证券的分支最多传 1 个。
`symbol`	`string`	否	未声明	未声明	单证券查询写法，与 symbols 二选一。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

查询分支：`market="JP"，statusType="trade_date"`

参数	类型	必填	默认值	可选值与约束	说明
`date`	`string`	否	未声明	未声明	锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。
`filterStatus`	`string`	否	"ALL"	枚举："Y"；"N"；"ALL"	交易日状态：Y=交易日，N=非交易日，H=半日交易（仅港股），ALL=不筛选状态。
`orderMode`	`integer`	否	0	枚举：0；1	查询方向：0=以 date 为结束点向前查询，1=以 date 为起点向后查询，包含锚定日。
`pageNum`	`integer`	否	1	最小值：1	页码，从 1 开始。
`pageSize`	`integer`	否	20	最小值：1	每页记录数，正整数，默认 20。

查询分支：`market="JP"，statusType="session"`

参数	类型	必填	默认值	可选值与约束	说明
`board`	`string`	否	未声明	未声明	股票代码
`timeMode`	`integer`	否	0	枚举：0；1	时间模式：0=实时，1=延时。

查询分支：`market="JP"，statusType="security"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	未声明	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

查询分支：`market="GLOBAL"，statusType="bond_session"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	"US91282CHZ77"	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="GLOBAL"，statusType="yield_session"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	"US91282CHZ77"	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

请求示例与补充说明

{
  "name": "reference",
  "arguments": {
    "endpoint": "get_trading_status",
    "params": {
      "market": "CN",
      "statusType": "security",
      "symbols": [
        "600519.sh"
      ]
    }
  }
}

补充说明：

CN/US 的 statusType=security 支持 symbol 或 symbols，二者互斥且至少提供一项。来源为静态证券基础资料，statusBasis=basic_info；不据此承诺实时可交易状态。
securityStatus/marketStatus 保留来源原码，0 也是有效原值；未确认的中文码义为 null。statusAvailability=available 仅表示获得原码，missing 表示缺少有效值。
证券状态查询按有效结果计算 coverage/missingSymbols；全缺失为 empty/REFERENCE_VALUE_UNAVAILABLE。缺项不能证明证券不存在。
交易日历使用 date 锚定查询；stockConnect 表示通道日历，不能等同于交易所日历。US delisted 的交易所筛选字段是 exchange，market 固定为 US。
不同市场的 session.status、securityStatus、marketStatus 含义不同，不能混用；交易时段码义与字段定义见各分支响应约定。
本工具集按完整响应交付，预算为 128,000 字符；超出时返回 RESPONSE_TOO_LARGE，请缩小 pageSize 或批量证券数。
分支 market="HK"，statusType="session"；响应 dataType：object[]
分支 market="HK"，statusType="session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","market":"下游市场类别代码：主板、创业板及供应商定义的其他证券市场类别；不是请求的 HK 市场代码，也不是交易时段 ID。","marketName":"下游市场类别中文含义，沿用供应商定义；未知码为 null。","subId":"交易时段 ID；与 market 市场类别分别解释。","subIdName":"交易时段中文含义；未知码为 null。","controlFlag":"控制标识原码。","controlFlagName":"控制标识中文含义；未知码为 null。"}
分支 market="HK"，statusType="session"；响应 valueMappings：{"status":{"0":"未知","10":"暂停","20":"开盘前","30":"开盘","40":"收盘前","50":"收盘","100":"当天闭市"},"market":{"MAIN":"主板","GEM":"创业板","NASD":"NASDAQ AMX市场","ETS":"扩充交易证券"},"subId":{"0":"当天闭市","1":"订单输入","2":"订单对盘","3":"持续交易","4":"订单对盘","5":"订单输入","7":"暂停","100":"未开市","101":"不可取消","102":"交易所干预","103":"收市","104":"订单取消","105":"参考定价","106":"不可取消","107":"随机收盘","108":"随机对盘"},"controlFlag":{"0":"自动","1":"手动（表示这一天的正常日程无效）"}}
分支 market="HK"，statusType="session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="US"，statusType="session"；响应 dataType：object
分支 market="US"，statusType="session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"当前美东时间；不是交易时段边界或行情更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。当前美东时间；不是交易时段边界或行情更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
分支 market="US"，statusType="session"；响应 valueMappings：{"status":{"0":"休市中","1":"盘中交易","3":"已收盘","-1":"盘前交易","-2":"盘后交易"}}
分支 market="US"，statusType="session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="US"，statusType="security"；响应 dataType：object[]
分支 market="US"，statusType="security"；响应 statusBasis：basic_info
分支 market="US"，statusType="security"；响应 sourceEndpoint：/v1/stock/basic/info
分支 market="US"，statusType="security"；响应 semantics：证券状态来源于静态基础资料；securityStatus/marketStatus 保留原码，字典及更新时间尚未确认，不能用于实时可交易判断。
分支 market="US"，statusType="security"；响应 fieldDescriptions：{"symbol":"来源证券代码","canonicalSymbol":"归一化股票代码","name":"证券名称","nameCn":"中文名称","nameEn":"英文名称","securityStatus":"证券状态原码；0 是有效原值，但未确认中文含义。","marketStatus":"市场状态原码；不等同于其他状态接口的 status。","securityStatusName":"证券状态中文含义；未确认时为 null。","marketStatusName":"市场状态中文含义；未确认时为 null。","listingDate":"上市日期","delistingDate":"退市日期；null 不代表已确认未退市。","statusAvailability":"available=取得证券状态原码；missing=未取得有效证券状态。available 不代表可交易。","missingReason":"DOWNSTREAM_VALUE_UNAVAILABLE=下游未提供有效证券状态；不能据此确认证券不存在。"}
分支 market="CN"，statusType="session"；响应 dataType：object[]
分支 market="CN"，statusType="session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","board":"板块代码：1=主板、3=创业板、6=科创板。"}
分支 market="CN"，statusType="session"；响应 valueMappings：{}
分支 market="CN"，statusType="session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="CN"，statusType="security"；响应 dataType：object[]
分支 market="CN"，statusType="security"；响应 statusBasis：basic_info
分支 market="CN"，statusType="security"；响应 sourceEndpoint：/v1/stock/basic/info
分支 market="CN"，statusType="security"；响应 semantics：证券状态来源于静态基础资料；securityStatus/marketStatus 保留原码，字典及更新时间尚未确认，不能用于实时可交易判断。
分支 market="CN"，statusType="security"；响应 fieldDescriptions：{"symbol":"来源证券代码","canonicalSymbol":"归一化股票代码","name":"证券名称","nameCn":"中文名称","nameEn":"英文名称","securityStatus":"证券状态原码；0 是有效原值，但未确认中文含义。","marketStatus":"市场状态原码；不等同于其他状态接口的 status。","securityStatusName":"证券状态中文含义；未确认时为 null。","marketStatusName":"市场状态中文含义；未确认时为 null。","listingDate":"上市日期","delistingDate":"退市日期；null 不代表已确认未退市。","statusAvailability":"available=取得证券状态原码；missing=未取得有效证券状态。available 不代表可交易。","missingReason":"DOWNSTREAM_VALUE_UNAVAILABLE=下游未提供有效证券状态；不能据此确认证券不存在。"}
分支 market="JP"，statusType="session"；响应 dataType：object
分支 market="JP"，statusType="session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","tradeStatus":"来源交易标识；保留原码，未确认完整字典。"}
分支 market="JP"，statusType="session"；响应 valueMappings：{"status":{"0":"未开盘","1":"盘前竞价","2":"等待开盘","3":"交易中","4":"午间休市","5":"收盘竞价","6":"已收盘","7":"休市中","8":"盘后交易"}}
分支 market="JP"，statusType="session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="GLOBAL"，statusType="bond_session"；响应 dataType：object
分支 market="GLOBAL"，statusType="bond_session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
分支 market="GLOBAL"，statusType="bond_session"；响应 valueMappings：{}
分支 market="GLOBAL"，statusType="bond_session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="GLOBAL"，statusType="yield_session"；响应 dataType：object
分支 market="GLOBAL"，statusType="yield_session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
分支 market="GLOBAL"，statusType="yield_session"；响应 valueMappings：{}
分支 market="GLOBAL"，statusType="yield_session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。

返回本工具集 · 返回入参目录

`get_symbol_mapping` 证券代码映射

查询证券代码名称映射、指数映射。

调用工具集：reference。业务参数位置：arguments.params。

参数	类型	必填	默认值	可选值与约束	说明
`arguments.endpoint`	`string`	是	未声明	固定值：get_symbol_mapping	选择本端点。
`arguments.params`	`object`	否	{}	未声明	业务参数对象；仅填写目标端点和分支声明的字段。
`market`	`string`	是	未声明	枚举："HK"；"US"	市场代码：HK=港股，CN=A股，US=美股，JP=日股，GLOBAL=债券。
`referenceType`	`string`	是	未声明	枚举："stock"；"index"	referenceType 选择业务分支；字段适用范围见 parameterBranches。

查询分支：`market="HK"，referenceType="stock"`

参数	类型	必填	默认值	可选值与约束	说明
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1000	证券代码数组；只支持单证券的分支最多传 1 个。
`symbol`	`string`	否	未声明	未声明	单证券查询写法，与 symbols 二选一。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

查询分支：`market="HK"，referenceType="index"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	是	未声明	未声明	指数代码：恒生指数使用 HSI 或 HSI.HI，不使用股票后缀 HSI.hk。

查询分支：`market="US"，referenceType="stock"`

参数	类型	必填	默认值	可选值与约束	说明
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1000	证券代码数组；只支持单证券的分支最多传 1 个。
`symbol`	`string`	否	未声明	未声明	单证券查询写法，与 symbols 二选一。

至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。

请求示例与补充说明

{
  "name": "reference",
  "arguments": {
    "endpoint": "get_symbol_mapping",
    "params": {
      "market": "HK",
      "referenceType": "stock",
      "symbols": [
        "00700.hk",
        "00388.hk"
      ]
    }
  }
}

补充说明：

HK/US 股票映射保留来源记录及顺序，按归一化代码匹配请求。coverage=complete/partial/none 表示有效映射覆盖，missingSymbols 保留缺项的原始请求代码。
别名或重复请求不按行数判缺失；有效映射至少需要来源名称非空。全缺失或全空回显返回 empty/REFERENCE_VALUE_UNAVAILABLE，部分缺失返回数据和 warning。
证券代码和指数代码使用不同命名空间；港股指数映射使用 HSI 或 HSI.HI。
本工具集按完整响应交付，预算为 128,000 字符；超出时返回 RESPONSE_TOO_LARGE，请缩小 pageSize 或批量证券数。

返回本工具集 · 返回入参目录

`get_market_hours` 市场交易时段

查询当前交易时段状态；是 get_trading_status(session) 的别名，不是完整交易日程。

调用工具集：reference。业务参数位置：arguments.params。

参数	类型	必填	默认值	可选值与约束	说明
`arguments.endpoint`	`string`	是	未声明	固定值：get_market_hours	选择本端点。
`arguments.params`	`object`	否	{}	未声明	业务参数对象；仅填写目标端点和分支声明的字段。
`market`	`string`	是	未声明	枚举："HK"；"US"；"CN"；"JP"；"GLOBAL"	市场代码：HK=港股，CN=A股，US=美股，JP=日股，GLOBAL=债券。
`statusType`	`string`	否	未声明	枚举："bond"；"yield"	statusType 选择业务分支；字段适用范围见 parameterBranches。

查询分支：`market="HK"`

参数	类型	必填	默认值	可选值与约束	说明
`board`	`string`	否	未声明	枚举："MAIN"；"GEM"；"NASD"；"ETS"	市场类别筛选：MAIN=主板、GEM=创业板、NASD=NASDAQ AMX市场、ETS=扩充交易证券；不传返回全部类别。不是交易时段 ID，不支持 symbol/symbols 筛选。
`timeMode`	`integer`	否	0	枚举：0；1	时间模式：0=实时，1=延时。

查询分支：`market="US"`

此分支无需额外业务参数。

查询分支：`market="CN"`

参数	类型	必填	默认值	可选值与约束	说明
`board`	`string`	否	"1"	枚举："1"；"3"；"6"	主板1，创业板3，科创板6，不填默认所有

查询分支：`market="JP"`

参数	类型	必填	默认值	可选值与约束	说明
`board`	`string`	否	未声明	未声明	股票代码
`timeMode`	`integer`	否	0	枚举：0；1	时间模式：0=实时，1=延时。

查询分支：`market="GLOBAL"，statusType="bond"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	"US91282CHZ77"	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

查询分支：`market="GLOBAL"，statusType="yield"`

参数	类型	必填	默认值	可选值与约束	说明
`symbol`	`string`	否	"US91282CHZ77"	未声明	证券代码，例如 00700.hk、600519.sh、AAPL.us。
`symbols`	`string[]`	否	未声明	最少项数：1；最多项数：1	symbol 的单元素数组写法；此分支不支持多证券查询。

请求示例与补充说明

{
  "name": "reference",
  "arguments": {
    "endpoint": "get_market_hours",
    "params": {
      "market": "HK",
      "board": "MAIN"
    }
  }
}

补充说明：

按市场选择交易时段分支；HK/JP 支持 timeMode，US/CN 不接受该参数。GLOBAL 必须按 bond/yield 选择分支并填写标识。
时间使用带偏移的 ISO 8601，sourceTime 保留来源原值；时段状态码按市场解释。HK 的市场、状态、子时段和控制标识含义见响应约定。
本工具集按完整响应交付，预算为 128,000 字符；超出时返回 RESPONSE_TOO_LARGE，请缩小 pageSize 或批量证券数。
分支 market="HK"；响应 dataType：object[]
分支 market="HK"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","market":"下游市场类别代码：主板、创业板及供应商定义的其他证券市场类别；不是请求的 HK 市场代码，也不是交易时段 ID。","marketName":"下游市场类别中文含义，沿用供应商定义；未知码为 null。","subId":"交易时段 ID；与 market 市场类别分别解释。","subIdName":"交易时段中文含义；未知码为 null。","controlFlag":"控制标识原码。","controlFlagName":"控制标识中文含义；未知码为 null。"}
分支 market="HK"；响应 valueMappings：{"status":{"0":"未知","10":"暂停","20":"开盘前","30":"开盘","40":"收盘前","50":"收盘","100":"当天闭市"},"market":{"MAIN":"主板","GEM":"创业板","NASD":"NASDAQ AMX市场","ETS":"扩充交易证券"},"subId":{"0":"当天闭市","1":"订单输入","2":"订单对盘","3":"持续交易","4":"订单对盘","5":"订单输入","7":"暂停","100":"未开市","101":"不可取消","102":"交易所干预","103":"收市","104":"订单取消","105":"参考定价","106":"不可取消","107":"随机收盘","108":"随机对盘"},"controlFlag":{"0":"自动","1":"手动（表示这一天的正常日程无效）"}}
分支 market="HK"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="US"；响应 dataType：object
分支 market="US"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"当前美东时间；不是交易时段边界或行情更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。当前美东时间；不是交易时段边界或行情更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
分支 market="US"；响应 valueMappings：{"status":{"0":"休市中","1":"盘中交易","3":"已收盘","-1":"盘前交易","-2":"盘后交易"}}
分支 market="US"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="CN"；响应 dataType：object[]
分支 market="CN"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","board":"板块代码：1=主板、3=创业板、6=科创板。"}
分支 market="CN"；响应 valueMappings：{}
分支 market="CN"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="JP"；响应 dataType：object
分支 market="JP"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","tradeStatus":"来源交易标识；保留原码，未确认完整字典。"}
分支 market="JP"；响应 valueMappings：{"status":{"0":"未开盘","1":"盘前竞价","2":"等待开盘","3":"交易中","4":"午间休市","5":"收盘竞价","6":"已收盘","7":"休市中","8":"盘后交易"}}
分支 market="JP"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="GLOBAL"，statusType="bond"；响应 dataType：object
分支 market="GLOBAL"，statusType="bond"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
分支 market="GLOBAL"，statusType="bond"；响应 valueMappings：{}
分支 market="GLOBAL"，statusType="bond"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
分支 market="GLOBAL"，statusType="yield"；响应 dataType：object
分支 market="GLOBAL"，statusType="yield"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
分支 market="GLOBAL"，statusType="yield"；响应 valueMappings：{}
分支 market="GLOBAL"，statusType="yield"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。

返回本工具集 · 返回入参目录