Skip to content
/api/v1/financials/snapshot-batch

Batch version of /financials/snapshot — latest-TTM derived ratios for up to 100 tickers in a single call.

Batch version of /financials/snapshot — latest-TTM derived ratios for up to 100 tickers in a single call.

10 tokensSince v3.62.0

Why use this

The batch companion to /financials/snapshot: fetch the latest-TTM derived ratio block (ROE, ROA, gross/net/operating/FCF margin, ROIC, debt-to-equity, current/quick ratio, turnovers, interest coverage, YoY/QoQ growth, etc.) for a whole list of tickers in ONE request instead of N per-ticker calls. Built for screeners and dashboards that resolve a candidate list (e.g. from /financials/screen, which returns ticker+company only) and then need each row's ratios — doing that one ticker at a time is an N+1 that is both slow and rate-limit-prone on wide result sets. Per-ticker values are identical to the single-ticker /financials/snapshot ratio block (same latest-TTM source and the same gross_margin fallback); the per-share, cash-runway, and Yahoo-shares fallbacks of the single-ticker endpoint are intentionally omitted (use /financials/snapshot per ticker for those).

Common use case

After /financials/screen returns a candidate list, fetch all their ratios in one call to render the results table without an N+1 of /financials/snapshot calls.

Batch companion to GET /api/v1/financials/snapshot. Returns the latest-TTM derived-ratio block for up to 100 tickers in a single request, so a screener with a candidate list does not have to call the single-ticker snapshot endpoint once per row (an N+1 that is slow and exhausts the financials rate limit on wide result sets). Per-ticker values are identical to the single-ticker endpoint's ratios block (same latest-TTM cf_derived_metrics source and the same gross_margin fallback), but flattened (no category nesting) and scoped to derived ratios only — the per-share, cash-runway, and Yahoo-Finance shares fallbacks of the single-ticker endpoint are intentionally omitted. Pair with GET /api/v1/financials/screen to resolve the candidate list first.

Parameters

NameInRequiredDefaultAllowedDescriptionExample
tickersqueryrequired——Comma-separated list of ticker symbols (canonical hyphen form; case-insensitive, normalized server-side). De-duplicated and capped at 100 — tokens beyond the first 100 are ignored. Unresolvable tickers are returned in `data.not_found` rather than failing the whole request.AAPL,MSFT,KO

Response schema

FieldTypeNullableDescription
data.countintegernoNumber of requested tickers that resolved to a company and are present as keys in `data.ratios` (excludes `not_found`).
data.ratiosobjectnoMap of ticker -> flat ratio object, one key per resolved requested ticker (keyed by the requested symbol). Each value is a flat object of latest-TTM derived metric -> value (un-nested, unlike single-ticker /financials/snapshot which groups ratios by category). A ticker that resolves but has no derived metrics on file maps to an empty object `{}`.
data.ratios.{TICKER}.{metric}numberyesLatest-TTM value of the derived ratio (margins/returns/growth are decimal fractions, e.g. 0.15 = 15%; leverage/liquidity are ratios). Rounded to 6 decimals. Identical to the value /financials/snapshot returns for that metric, including the gross_margin = gross_profit / revenue fallback when gross_margin is not directly derived.
data.not_foundarraynoArray of requested tickers (in requested form) that could not be resolved to a company via the ticker lookup. Empty array when every requested ticker resolved.

Sample response

·
  • "status": "success"
  • "data":
    • "count": 2
    • "ratios":
    • "not_found": []
    }
}

Errors

StatusLabelDescription
200OKRequest succeeded.
400Bad RequestInvalid query, body, or path parameter.
401UnauthorizedMissing or invalid Authorization header / api_Token.
402Payment RequiredInsufficient token balance for this call. Top up
429Too Many RequestsRate limit exceeded for your tier (see /pricing for tier limits). Tier limits
500Server ErrorUnexpected server-side failure. Retry with backoff; report if persistent.

Code samples

curl "https://api.finradar.ai/api/v1/financials/snapshot-batch?api_Token=YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Generate an API key in /account/credentials to run live queries (literal YOUR_API_KEY placeholder shown until then).