POST /api/yahoo/finance/statistics
Price: 1 credit
Get the key statistics of a ticker: valuation, share and short data, margins, dividends, next earnings
Key statistics of a stock or fund as on its Yahoo Finance statistics tab: valuation ratios, share structure and short interest, profitability, balance sheet totals, dividends and splits, and the next earnings date with its consensus.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)symbol string required — Ticker symbol (examples: "AAPL", "JPM", "SPY"; minLength: 1; pattern: \S)@type string (default: "YahooFinanceStatistics")id string requiredcurrency string nullableprice number nullableprevious_close number nullableopen number nullableday_low number nullableday_high number nullablevolume integer nullableaverage_volume integer nullableaverage_volume_10_day integer nullablebid number nullableask number nullablebid_size integer nullableask_size integer nullablemarket_cap number nullablenon_diluted_market_cap number nullablefifty_two_week_low number nullablefifty_two_week_high number nullableall_time_high number nullableall_time_low number nullablefifty_day_average number nullabletwo_hundred_day_average number nullablebeta number nullabletrailing_pe number nullableforward_pe number nullableprice_to_sales number nullabledividend_rate number nullableforward_dividend_yield number nullabletrailing_dividend_rate number nullabledividend_yield number nullablefive_year_average_dividend_yield number nullablepayout_ratio number nullableex_dividend_at integer nullabledividend_at integer nullablefund_yield number nullabletotal_assets number nullablenav_price number nullablereturn_ytd number nullableenterprise_value number nullableprice_to_book number nullablepeg_ratio number nullableenterprise_to_revenue number nullableenterprise_to_ebitda number nullableshares_outstanding integer nullableimplied_shares_outstanding integer nullablefloat_shares integer nullableshares_short integer nullableshares_short_prior_month integer nullableshares_short_prior_month_at integer nullableshort_interest_at integer nullableshort_percent_of_shares number nullableshort_percent_of_float number nullableshort_ratio number nullableinsiders_percent_held number nullableinstitutions_percent_held number nullablebook_value_per_share number nullabletrailing_eps number nullableforward_eps number nullableearnings_quarterly_growth number nullablenet_income_to_common number nullablefifty_two_week_change number nullablesp500_fifty_two_week_change number nullablelast_split_factor string nullablelast_split_at integer nullablelast_dividend_value number nullablelast_dividend_at integer nullablelast_fiscal_year_end_at integer nullablenext_fiscal_year_end_at integer nullablemost_recent_quarter_at integer nullablefund_family string nullablefund_category string nullablelegal_type string nullablefund_inception_at integer nullablebeta_3_year number nullablethree_year_average_return number nullablefive_year_average_return number nullabletotal_cash number nullabletotal_cash_per_share number nullabletotal_debt number nullabledebt_to_equity number nullablequick_ratio number nullablecurrent_ratio number nullabletotal_revenue number nullablerevenue_per_share number nullablegross_profit number nullableebitda number nullableoperating_cash_flow number nullablefree_cash_flow number nullablereturn_on_assets number nullablereturn_on_equity number nullableearnings_growth number nullablerevenue_growth number nullablegross_margin number nullableebitda_margin number nullableoperating_margin number nullableprofit_margin number nullablefinancial_currency string nullableearnings_dates_at array (default: [])earnings_call_dates_at array (default: [])earnings_eps_average number nullableearnings_eps_low number nullableearnings_eps_high number nullableearnings_revenue_average number nullableearnings_revenue_low number nullableearnings_revenue_high number nullableis_earnings_date_estimate boolean nullable422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.412 — Symbol not found Retrying will not help: either the entity does not exist, or the input points at a different one.429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.X-Error — Error message text (present only on error)X-Request-ID — Unique request identifierX-Execution-Time — Execution time in secondsX-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.X-Retry-After — Seconds to wait before retrying. Present only on 429.