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 us-gaap:EarningsPerShareBasicAndDiluted fact, or the company's own earnings-per-share element, can supply either or both metrics; each retains its source concept and its reported per-share value. Its meaning comes from the filing's own presentation: the line as printed in the filed document where the page capture binds it, read under the heading printed above it when the line names only its result ("Net earnings"); otherwise the line label of the filing's own stored statement, accepted only when the filing's own net income over its weighted-average shares for the same period reproduces the value (where a diluted weighted-average count is filed separately, the diluted quotient too, unless income from continuing operations is a loss). For this check a figure the company marked exact is read at the precision it was printed, and income that includes the noncontrolling interest's share is not used where the filing reports that share; the value served is always the company's own figure. A standard basic or diluted line printed under a heading that names both supplies both. A line or heading that names two or more classes of common stock together ("per Class A and Class B common stock"), or a parent's share with its operating partnership's unit ("per common share or unit"), reads as the company-wide result; a single class, units alone, a partnership unit or a preferred series does not. 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. With provenance=full, a row whose identity rests on a filed line carries an eps_identity_evidence entry in relationship_provenance.source_lineage.transformations: the binding (captured_inline_fact or filed_presentation_label), the line labels, any header_labels read, and for a statement line its label_provenance and own_facts proof (status, case, input fact numbers, quotients and control number); rows derived from it carry the entry too. 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).