研究数据股票股票数据

股票估值指标接口文档

查询股票估值指标。历史日期返回沉淀估值数据;若查询日期包含最新交易日,会使用盘中可用行情补齐 close、换手率、量比与市值字段。股本按万股返回,市值按元返回,换手率和股息率按百分数值返回;估值字段在亏损或源数据缺失时可能为空。

接口参数与返回字段速查

查询股票估值指标。历史日期返回沉淀估值数据;若查询日期包含最新交易日,会使用盘中可用行情补齐 close、换手率、量比与市值字段。股本按万股返回,市值按元返回,换手率和股息率按百分数值返回;估值字段在亏损或源数据缺失时可能为空。

请求参数

  • apiname(string(valuation),必选):固定接口名称,用于选择对应的数据能力。
  • apikey(string,必选):猫爪数据 API Key。网页在线调试会为已登录用户自动注入,其他调用请从控制台获取。
  • fields(string|null,可选):需要返回的字段列表,多个字段使用英文逗号分隔;可选字段见下方返回字段表。
  • params(object,可选):查询条件对象;具体参数、格式和互斥关系见下方 params 参数表。
  • symbols(string|array<string>,可选):股票代码,支持单个、多个逗号分隔或数组;不传则默认全市场标的。
  • tradedate(string,可选):查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。
  • startdate(string,可选):查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。
  • enddate(string,可选):查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。
  • recentdays(integer,可选):最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。
  • tradedate_offset(integer,可选):相对最新交易日的单日偏移,0 表示最新交易日,-1 表示上一交易日。

返回字段

  • tradedate(string):交易日期 YYYYMMDD
  • symbol(string):股票代码
  • name(string):股票名称
  • code(string|null):股票代码(交易所后缀)
  • close(number):当日收盘价。
  • turnover_rate(number|null):换手率(%)
  • turnover_rate_f(number|null):按自由流通股本计算的换手率。
  • volume_ratio(number|null):量比
  • pe(number|null):市盈率(总市值/净利润,亏损的PE为空)
  • pe_ttm(number|null):市盈率(TTM,亏损的PE为空)
  • pb(number|null):市净率(总市值/净资产)
  • ps(number|null):市销率
  • ps_ttm(number|null):市销率(TTM)
  • dv_ratio(number|null):股息率(%)
  • dv_ttm(number|null):最近十二个月股息率。
  • total_share(number|null):公司总股本。
  • float_share(number|null):可流通股本。
  • free_share(number|null):自由流通口径股本。
  • free_mv(number|null):按自由流通股本计算的市值。
  • total_mv(number|null):按总股本计算的市值。
  • circ_mv(number|null):按流通股本计算的市值。