Price snapshot (fundamentals)

Latest quote for one ticker. Call this when the user asks what the price is now or how the stock is moving today; for history use /fundamentals/prices. price is the last trade in ANY session; price_session says which (the closing auction print, stamped just after the bell, is regular) and as_of when. Sessions, US Eastern: pre 04:00-09:30, regular 09:30-16:00, post 16:00-20:00 (half-days: regular to 13:00, post to 17:00), closed otherwise and on weekends and exchange holidays. market_session (and session, the same value) is the session when the answer is served. day_change = price - prev_close, and day_change_percent is that over prev_close in percent points (1.5 = 1.5%); prev_close is the regular-session close of prev_close_date. Outside regular hours they include extended-hours trading. Every change is the exact price difference and every percent has 6 significant figures. For how the stock did in its latest regular session use regular_session {date, status in_progress|closed, open, high, low, close (null until final, 5 minutes after the bell), last, volume (whole shares, extended hours included: once the session is final, the daily aggregate's, the figure /fundamentals/prices serves; while it forms, the live day bar's running tally, which can differ by a few hundred shares), prev_close, prev_close_date, change, change_percent}; for the move since that close use extended_hours {session pre|post, price, as_of, reference_close, reference_close_date, change, change_percent}, null in regular hours or when the last trade was a regular-session trade. day_* is the bar of day_bar_date (before the open, the previous session's); day_volume is its running tally in whole shares. bid/ask are served only while the exchange is in a session, and only a quote set during that session (quote_as_of, when the quote last changed, at or after the session's start); else null. session_detail_status says why a session field is null: partial (a date or an earlier close could not be established) or unavailable. State the session and date with any move; never report an extended-hours move as a session's change. CRYPTO: pass asset_class=crypto for BTC/ETH/SOL/LTC/LINK etc. Several crypto symbols are ALSO US-listed equity tickers (BTC is a Grayscale trust at ~$29; LINK is Interlink Electronics), so a bare ticker returns the EQUITY. Never use an equity price for a crypto asset. Check is_stale before using the price. VALUATION (equity, on the live price, when valuation_status is 'ok'; otherwise null): pe_ttm = price / eps_ttm (diluted, four consecutive fiscal quarters, today's share basis); forward_pe = pe_ttm / (1 + the latest fiscal year's EPS growth, or net-income growth when a split sits between the years), trailing arithmetic, NOT an analyst consensus; dividend_yield is a FRACTION (0.0225 = 2.25%): split-adjusted regular cash dividends with an ex-date in the last 365 days over the price, null for a non-payer; dividend_yield_indicated uses the latest declared regular dividend x payments per year; dividend gives the per-share figures, dates and status; units names each unit.

A 200 is a JSON envelope: ok: true and this endpoint's own fields (see Fundamentals). It carries X-Request-ID, the credit headers (X-Credits-Cost, X-Credits-Remaining, X-Credits-Receipt, X-Credits-Settlement) and the rate-limit headers.

A 200 is billed even when it holds no data (an empty list, null, found: false), so check those fields. Pricing & credits explains the credit headers.

No error is billed. The body is { "ok": false, "error", "detail", "request_id" }; read the code from error.

This table lists what the spec declares for this route. Error responses lists every code FIRM sends, with when to retry.