Skip to content
Valuation

Get valuation trends

Returns the P/E, P/B, P/S, and dividend yield history of a security over a date range, together with the current value, period average, fair range, historical percentile, industry rank, and industry median. Use it for the valuation block on the Overview tab and the valuation detail on the Analysis tab of the security detail page. Request again when the range changes; the Broker App offers 1-, 3-, 5-, and 10-year ranges.

To overlay the price line, request candlesticks of the same period as kline_type separately. For an index, show the valuation block only when index_show is true, and hide the industry rank and fair range.

GEThttps://api.lbkrs.com/v7/stock-info/valuation

Parameters

counter_idstringqueryRequired

Security ID, such as ST/US/AAPL

kindstringquery

Valuation type. Pass an empty string to get all four series:

  • pe - P/E
  • pb - P/B
  • ps - P/S
  • dvd_yld - Dividend yield

pepbpsdvd_yld

start_datestringqueryRequired

Range start date in yyyyMMdd format

end_datestringqueryRequired

Range end date in yyyyMMdd format. The Broker App passes the day after today

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get valuation trends” operation.
Standard response envelopecodemessagedata
dataobjectdata structure

Valuation trends

kline_typestring

Series period. Use it to request candlesticks for the price overlay:

  • day - Daily
  • week - Weekly
  • month - Monthly
Values
day
week
month
pe_listarray<object>

P/E series

Child attributes
timestampstring

Point time as a Unix timestamp in seconds, returned as a string

pestring

P/E ratio. Present only in pe_list

epsstring

Earnings per share. Present only in pe_list

pbstring

P/B ratio. Present only in pb_list

psstring

P/S ratio. Present only in ps_list

spsstring

Sales per share. Present only in ps_list

dvd_yldstring

Dividend yield as a decimal ratio. Present in dvd_yld_list and dvd_indmed_list

dpsstring

Dividend per share. Present only in dvd_yld_list

valuestring

Industry median. Present in pe_indmed_list, pb_indmed_list, and ps_indmed_list

pb_listarray<object>

P/B series

Child attributes
timestampstring

Point time as a Unix timestamp in seconds, returned as a string

pestring

P/E ratio. Present only in pe_list

epsstring

Earnings per share. Present only in pe_list

pbstring

P/B ratio. Present only in pb_list

psstring

P/S ratio. Present only in ps_list

spsstring

Sales per share. Present only in ps_list

dvd_yldstring

Dividend yield as a decimal ratio. Present in dvd_yld_list and dvd_indmed_list

dpsstring

Dividend per share. Present only in dvd_yld_list

valuestring

Industry median. Present in pe_indmed_list, pb_indmed_list, and ps_indmed_list

ps_listarray<object>

P/S series

Child attributes
timestampstring

Point time as a Unix timestamp in seconds, returned as a string

pestring

P/E ratio. Present only in pe_list

epsstring

Earnings per share. Present only in pe_list

pbstring

P/B ratio. Present only in pb_list

psstring

P/S ratio. Present only in ps_list

spsstring

Sales per share. Present only in ps_list

dvd_yldstring

Dividend yield as a decimal ratio. Present in dvd_yld_list and dvd_indmed_list

dpsstring

Dividend per share. Present only in dvd_yld_list

valuestring

Industry median. Present in pe_indmed_list, pb_indmed_list, and ps_indmed_list

dvd_yld_listarray<object>

Dividend yield series

Child attributes
timestampstring

Point time as a Unix timestamp in seconds, returned as a string

pestring

P/E ratio. Present only in pe_list

epsstring

Earnings per share. Present only in pe_list

pbstring

P/B ratio. Present only in pb_list

psstring

P/S ratio. Present only in ps_list

spsstring

Sales per share. Present only in ps_list

dvd_yldstring

Dividend yield as a decimal ratio. Present in dvd_yld_list and dvd_indmed_list

dpsstring

Dividend per share. Present only in dvd_yld_list

valuestring

Industry median. Present in pe_indmed_list, pb_indmed_list, and ps_indmed_list

cur_pestring

Current P/E

avg_pestring

Average P/E over the range

cur_pbstring

Current P/B

avg_pbstring

Average P/B over the range

cur_psstring

Current P/S

avg_psstring

Average P/S over the range

cur_dvd_yldstring

Current dividend yield as a decimal ratio

avg_dvd_yldstring

Average dividend yield over the range as a decimal ratio

cur_epsstring

Current EPS

cur_bpsstring

Current book value per share

cur_spsstring

Current sales per share

cur_dpsstring

Current dividend per share

eps_currencystring

Currency of per-share metrics

year_epsarray<object>

EPS by fiscal year

Child attributes
end_datestring

Fiscal year end date in yyyy-MM-dd format

epsstring

Earnings per share. Present only in year_eps

bpsstring

Book value per share. Present only in year_bps

spsstring

Sales per share. Present only in year_sps

year_bpsarray<object>

Book value per share by fiscal year

Child attributes
end_datestring

Fiscal year end date in yyyy-MM-dd format

epsstring

Earnings per share. Present only in year_eps

bpsstring

Book value per share. Present only in year_bps

spsstring

Sales per share. Present only in year_sps

year_spsarray<object>

Sales per share by fiscal year

Child attributes
end_datestring

Fiscal year end date in yyyy-MM-dd format

epsstring

Earnings per share. Present only in year_eps

bpsstring

Book value per share. Present only in year_bps

spsstring

Sales per share. Present only in year_sps

ttmobject

Trailing twelve months (TTM) per-share metrics

Child attributes
epsstring

EPS

bpsstring

Book value per share

spsstring

Sales per share

pe_valueobject

Valuation band statistics. For dividend yield, all values are decimal ratios (for example, 0.035 means 3.5%); for P/E, P/B, and P/S they are multiples

Child attributes
lowstring

Lower bound of the fair range

highstring

Upper bound of the fair range

medianstring

Median over the period

minstring

Lowest value over the period

maxstring

Highest value over the period

percentilestring

Historical percentile of the current value within the period, as a decimal ratio (for example, 0.42 means 42%)

pb_valueobject

Valuation band statistics. For dividend yield, all values are decimal ratios (for example, 0.035 means 3.5%); for P/E, P/B, and P/S they are multiples

Child attributes
lowstring

Lower bound of the fair range

highstring

Upper bound of the fair range

medianstring

Median over the period

minstring

Lowest value over the period

maxstring

Highest value over the period

percentilestring

Historical percentile of the current value within the period, as a decimal ratio (for example, 0.42 means 42%)

ps_valueobject

Valuation band statistics. For dividend yield, all values are decimal ratios (for example, 0.035 means 3.5%); for P/E, P/B, and P/S they are multiples

Child attributes
lowstring

Lower bound of the fair range

highstring

Upper bound of the fair range

medianstring

Median over the period

minstring

Lowest value over the period

maxstring

Highest value over the period

percentilestring

Historical percentile of the current value within the period, as a decimal ratio (for example, 0.42 means 42%)

dvd_yld_valueobject

Valuation band statistics. For dividend yield, all values are decimal ratios (for example, 0.035 means 3.5%); for P/E, P/B, and P/S they are multiples

Child attributes
lowstring

Lower bound of the fair range

highstring

Upper bound of the fair range

medianstring

Median over the period

minstring

Lowest value over the period

maxstring

Highest value over the period

percentilestring

Historical percentile of the current value within the period, as a decimal ratio (for example, 0.42 means 42%)

pe_rankstring

Industry rank by P/E, shown with rank_total as rank/total. Show -/- when empty

pb_rankstring

Industry rank by P/B

ps_rankstring

Industry rank by P/S

dvd_yld_rankstring

Industry rank by dividend yield

rank_totalstring

Number of ranked securities in the industry

pe_indmedstring

Industry median P/E

pb_indmedstring

Industry median P/B

ps_indmedstring

Industry median P/S

dvd_indmedstring

Industry median dividend yield as a decimal ratio

pe_indmed_listarray<object>

Industry median P/E series

Child attributes
timestampstring

Point time as a Unix timestamp in seconds, returned as a string

pestring

P/E ratio. Present only in pe_list

epsstring

Earnings per share. Present only in pe_list

pbstring

P/B ratio. Present only in pb_list

psstring

P/S ratio. Present only in ps_list

spsstring

Sales per share. Present only in ps_list

dvd_yldstring

Dividend yield as a decimal ratio. Present in dvd_yld_list and dvd_indmed_list

dpsstring

Dividend per share. Present only in dvd_yld_list

valuestring

Industry median. Present in pe_indmed_list, pb_indmed_list, and ps_indmed_list

pb_indmed_listarray<object>

Industry median P/B series

Child attributes
timestampstring

Point time as a Unix timestamp in seconds, returned as a string

pestring

P/E ratio. Present only in pe_list

epsstring

Earnings per share. Present only in pe_list

pbstring

P/B ratio. Present only in pb_list

psstring

P/S ratio. Present only in ps_list

spsstring

Sales per share. Present only in ps_list

dvd_yldstring

Dividend yield as a decimal ratio. Present in dvd_yld_list and dvd_indmed_list

dpsstring

Dividend per share. Present only in dvd_yld_list

valuestring

Industry median. Present in pe_indmed_list, pb_indmed_list, and ps_indmed_list

ps_indmed_listarray<object>

Industry median P/S series

Child attributes
timestampstring

Point time as a Unix timestamp in seconds, returned as a string

pestring

P/E ratio. Present only in pe_list

epsstring

Earnings per share. Present only in pe_list

pbstring

P/B ratio. Present only in pb_list

psstring

P/S ratio. Present only in ps_list

spsstring

Sales per share. Present only in ps_list

dvd_yldstring

Dividend yield as a decimal ratio. Present in dvd_yld_list and dvd_indmed_list

dpsstring

Dividend per share. Present only in dvd_yld_list

valuestring

Industry median. Present in pe_indmed_list, pb_indmed_list, and ps_indmed_list

dvd_indmed_listarray<object>

Industry median dividend yield series; read dvd_yld

Child attributes
timestampstring

Point time as a Unix timestamp in seconds, returned as a string

pestring

P/E ratio. Present only in pe_list

epsstring

Earnings per share. Present only in pe_list

pbstring

P/B ratio. Present only in pb_list

psstring

P/S ratio. Present only in ps_list

spsstring

Sales per share. Present only in ps_list

dvd_yldstring

Dividend yield as a decimal ratio. Present in dvd_yld_list and dvd_indmed_list

dpsstring

Dividend per share. Present only in dvd_yld_list

valuestring

Industry median. Present in pe_indmed_list, pb_indmed_list, and ps_indmed_list

pe_tipsstring

Explanatory tip for P/E. Display it as is

pb_tipsstring

Explanatory tip for P/B

ps_tipsstring

Explanatory tip for P/S

dvd_yld_tipsstring

Explanatory tip for dividend yield

index_showboolean

Whether to show the valuation block for an index

updated_atstring

Data update time text. Display it as is

Whale Docs