Standardized metric time-series for MANY companies in ONE request — the multi-security form of GET /api/v1/xbrl/timeseries.

The multi-security form of GET /api/v1/xbrl/timeseries: POST a list of up to 50 tickers or CIKs and the same options, and receive each company's standardized metric time-series in ONE metered request — the network-efficient way to hydrate a peer group, a watchlist, or a whole screen result. The per-entity body is byte-identical to what a single GET /api/v1/xbrl/timeseries would return (same standardization ladder, same provenance/basis/as_of/ratios/template semantics, same currency handling), so a batch and a per-company call never disagree. Selectors resolve independently: an unknown or unresolvable ticker/CIK returns a status:"error" entry with a machine-readable code and never fails the rest of the batch (partial success, exactly like POST /api/v1/cusip/batch). A request-wide error (an unknown metric key, an over-limit list, an empty list, or a cursor/period_offset in the body) is a single 400 for the whole call. Entities are assembled serially inside one database session (no fan-out), so the batch is a strict efficiency win over N separate HTTP calls with no extra database load. Multi-security retrieval is table stakes for a terminal-grade fundamentals API — professional fundamentals platforms return a field matrix across a security list from one request; the request/response shape here is documented above. Billing note: the endpoint currently bills the flat batch cost (10 tokens) — the shared token meter debits one fixed cost per request and refunds that one debit on failure; meta.resolved reports the entity count so an N-per-entity multiplier can be added once the meter grows a variable-charge primitive.

Earnings per share. For eps_basic and eps_diluted, the corresponding individual US-GAAP fact takes priority. If it is unavailable, an eligible historical us-gaap:EarningsPerShareBasicAndDiluted fact can supply either or both metrics; both retain that combined source concept and its reported per-share value. Structural fallback rejects an explicitly basic-only US-GAAP or IFRS fact for diluted earnings per share, and vice versa. If that opposite kind is the only evidence, the requested metric remains missing. Existing period, currency and consolidation checks still apply; quarter and trailing-twelve-month calculation methods are unchanged. This supports already-filed combined facts, whose tag was deprecated in the 2022 taxonomy (FASB FAQ 2.14).