Latest fact per consolidated series
const url = 'https://api.stockalloy.com/api/b2b/facts/latest';const options = { method: 'POST', headers: {'X-API-Key': '<X-API-Key>', 'Content-Type': 'application/json'}, body: '{"ticker":"DECK","metric_id":"us-gaap#RevenueFromContractWithCustomerExcludingAssessedTax"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.stockalloy.com/api/b2b/facts/latest \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <X-API-Key>' \ --data '{ "ticker": "DECK", "metric_id": "us-gaap#RevenueFromContractWithCustomerExcludingAssessedTax" }'Returns the most recent consolidated fact for every series of a company (one row per series). Ideal for “current snapshot” views.
Pass metric_id to get a small, focused response — metric-scoped requests are never capped and never filtered.
Unscoped requests (no metric_id) are a browse-everything export: dei# cover-page tags (auditor IDs, addresses, cover-date share counts) are excluded unless include_dei: true, and the response is capped at limit rows (default 100, max 500). When rows are dropped by the cap, the envelope carries truncated: true and total_available.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
Stock ticker, e.g. DECK.
Zero-padded 10-digit SEC CIK, e.g. 0000910521.
Company set (search endpoints only).
Company set (search endpoints only).
Optional XBRL metric ID filter, e.g. us-gaap#Revenues. Facts endpoints require a single-company scope (ticker or cik).
Unscoped requests only: include dei# cover-page tags (auditor IDs, addresses, cover-date share counts) in the browse-everything export. Excluded by default. Ignored when metric_id is provided — metric-scoped requests always return the requested metric, dei# or not.
Unscoped requests only: maximum rows returned (default 100, max 500). When more series exist, the envelope sets truncated: true and total_available. Ignored when metric_id is provided — metric-scoped responses are never capped.
Example
{ "ticker": "DECK", "metric_id": "us-gaap#RevenueFromContractWithCustomerExcludingAssessedTax"}Responses
Section titled “Responses”Latest fact rows (one per series).
object
Echoes the request filter.
Present only on unscoped requests when the row cap dropped rows.
Uncapped row count (after the default dei# exclusion). Present only alongside truncated.
object
Stable public key for this fact (sha256 hex).
Stable public key for the series this fact belongs to (company × metric × dimension slice × unit).
XBRL concept ID, e.g. us-gaap#Revenues.
Human-readable metric name.
duration:START..END for flows or instant:DATE for balances.
Calendar quarter (1-4) in which the period ends.
E.g. monetary:USD, shares, pure.
E.g. monetary, shares, pure.
Exact decimal value as a string (full units, not thousands). Equal to value_scaled_int × 10^scale.
Exact integer significand as a string.
Power-of-ten exponent applied to value_scaled_int.
SEC accession number of the winning filing.
E.g. 10-K, 10-Q, 10-K/A.
True when the fact’s period matches the filing’s own reporting period (as opposed to a restated prior period).
Opens the SEC filing with this figure highlighted (https://stockalloy.com/api/evidence/{id}/open?...).
Example
{ "scope": "company", "ticker": "DECK", "cik": "0000910521", "metric_id": "us-gaap#RevenueFromContractWithCustomerExcludingAssessedTax", "count": 1, "rows": [ { "fact_key": "29123d4395a3…(64-char key)", "series_key": "1662173f5414…(64-char key)", "cik": "0000910521", "current_ticker": "DECK", "metric_id": "us-gaap#RevenueFromContractWithCustomerExcludingAssessedTax", "metric_label": "Revenue", "period_key": "duration:2024-04-01..2025-03-31", "period_kind": "duration", "period_start": "2024-04-01", "period_end": "2025-03-31", "period_end_year": 2025, "period_end_quarter": 1, "unit_signature": "monetary:USD", "unit_class": "monetary", "currency": "USD", "value_num": "4985612000", "value_scaled_int": "4985612", "scale": 3, "source_accession": "000091052125000017", "source_form_type": "10-K", "source_is_amendment": false, "source_is_current_filing_period": true, "source_filed_at": "2025-05-23", "evidence_key": "35abfabdc97f…(evidence id)", "evidence_url": "https://stockalloy.com/api/evidence/35abfabdc97f…/open?cik=0000910521&accession=000091052125000017", "is_consolidated": true } ]}Headers
Section titled “Headers”Requests allowed per minute for this key.
Requests remaining in the current minute window.
Unix timestamp (seconds) when the window resets.
Invalid request — missing/invalid fields, malformed JSON, or an unsupported scope combination.
object
Human-readable error message.
Example
{ "error": "query is required"}Missing or invalid API key.
object
Human-readable error message.
Example
{ "error": "API key required"}Key revoked/disabled/expired, account disabled, key not entitled for this product, or cross-company search not enabled for this key.
object
Human-readable error message.
Example
{ "error": "API key has expired"}Company not found (unknown ticker or CIK).
object
Human-readable error message.
Example
{ "error": "Unknown ticker: ZZZZ"}Rate limit exceeded (per-minute) or quota exceeded (daily/monthly, account-level or per-key). Distinguish by body shape.
object
Seconds until the window resets.
Requests allowed per minute for this key.
object
daily quota exceeded or monthly quota exceeded.
account sums usage across all keys on the account; api_key is a per-key cap.
Examples
Per-minute rate limit
{ "error": "Rate limit exceeded", "retryAfter": 31, "limit": 60, "windowMs": 60000}Monthly quota
{ "error": "monthly quota exceeded", "quota": "monthly", "scope": "account", "limit": 5000, "used": 5000}Headers
Section titled “Headers”Requests allowed per minute for this key.
Requests remaining in the current minute window.
Unix timestamp (seconds) when the window resets.
Seconds to wait before retrying (429 only).
Unexpected server error.
object
Human-readable error message.
Example
{ "error": "Facts lookup failed"}The verified-facts backend is temporarily unavailable. Transient — retry with backoff. This is an infrastructure condition, not a data gap.
object
Human-readable error message.
Example
{ "error": "Facts backend unavailable"}