Latest facts for specific series keys

POST

/api/b2b/facts/latest/by-series

curl --request POST \
  --url https://api.stockalloy.com/api/b2b/facts/latest/by-series \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "ticker": "DECK", "series_keys": [ "91b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2" ] }'

• Production

Authorizations

• ApiKeyAuth

Request Body^required

Media typeapplication/json

object

ticker

Stock ticker, e.g. DECK.

string

cik

Zero-padded 10-digit SEC CIK, e.g. 0001011570.

string

tickers

Company set (search endpoints only).

Array<string>

ciks

Company set (search endpoints only).

Array<string>

metric_id

Optional XBRL metric ID filter, e.g. us-gaap#Revenues. Facts endpoints require a single-company scope (ticker or cik).

string

series_key

A single stable series key (sha256 hex).

string

/^[a-f0-9]{64}$/

series_keys

Up to 100 stable series keys.

Array<string>

<= 100 items

Example

{
  "ticker": "DECK",
  "series_keys": [
    "91b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2"
  ]
}

Responses

200

Latest fact rows for the requested series.

Media typeapplication/json

object

scope

required

string

Allowed value: company

ticker

string | null

cik

required

string

metric_id

Echoes the request filter.

string | null

count

required

integer

rows

required

Array

object

fact_key

Stable public key for this fact (sha256 hex).

string

series_key

Stable public key for the series this fact belongs to (company × metric × dimension slice × unit).

string

cik

string

current_ticker

string | null

metric_id

XBRL concept ID, e.g. us-gaap#Revenues.

string

metric_label

Human-readable metric name.

string

period_key

duration:START..END for flows or instant:DATE for balances.

string

period_kind

string

Allowed values: instant duration

period_start

string | null format: date

period_end

string format: date

period_end_year

integer

period_end_quarter

Calendar quarter (1-4) in which the period ends.

integer

unit_signature

E.g. monetary:USD, shares, pure.

string

unit_class

E.g. monetary, shares, pure.

string

currency

string | null

value_num

Exact decimal value as a string (full units, not thousands). Equal to value_scaled_int × 10^scale.

string

value_scaled_int

Exact integer significand as a string.

string

scale

Power-of-ten exponent applied to value_scaled_int.

integer

source_accession

SEC accession number of the winning filing.

string

source_form_type

E.g. 10-K, 10-Q, 10-K/A.

string | null

source_is_amendment

boolean | null

source_is_current_filing_period

True when the fact’s period matches the filing’s own reporting period (as opposed to a restated prior period).

boolean | null

source_filed_at

string format: date

evidence_key

string | null

evidence_url

Opens the SEC filing with this figure highlighted (https://stockalloy.com/api/evidence/{id}/open?...).

string | null

is_consolidated

boolean

Example

{
  "scope": "company",
  "rows": [
    {
      "period_kind": "instant",
      "is_consolidated": true
    }
  ]
}

Headers

X-RateLimit-Limit

integer

Requests allowed per minute for this key.

X-RateLimit-Remaining

integer

Requests remaining in the current minute window.

X-RateLimit-Reset

integer

Unix timestamp (seconds) when the window resets.

400

Invalid request — missing/invalid fields, malformed JSON, or an unsupported scope combination.

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example

{
  "error": "query is required"
}

401

Missing or invalid API key.

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example

{
  "error": "API key required"
}

403

Key revoked/disabled/expired, account disabled, key not entitled for this product, or cross-company search not enabled for this key.

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example

{
  "error": "API key has expired"
}

404

Company not found (unknown ticker or CIK).

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example

{
  "error": "Unknown ticker: ZZZZ"
}

429

Rate limit exceeded (per-minute) or quota exceeded (daily/monthly, account-level or per-key). Distinguish by body shape.

Media typeapplication/json

One of:

object

object

error

required

string

Allowed value: Rate limit exceeded

retryAfter

required

Seconds until the window resets.

integer

limit

required

Requests allowed per minute for this key.

integer

windowMs

required

integer

Allowed value: 60000

object

object

error

required

daily quota exceeded or monthly quota exceeded.

string

quota

required

string

Allowed values: daily monthly

scope

required

account sums usage across all keys on the account; api_key is a per-key cap.

string

Allowed values: account api_key

limit

required

integer

used

required

integer

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

X-RateLimit-Limit

integer

Requests allowed per minute for this key.

X-RateLimit-Remaining

integer

Requests remaining in the current minute window.

X-RateLimit-Reset

integer

Unix timestamp (seconds) when the window resets.

Retry-After

integer

Seconds to wait before retrying (429 only).

500

Unexpected server error.

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example

{
  "error": "Facts lookup failed"
}

503

The verified-facts backend is temporarily unavailable. Transient — retry with backoff. This is an infrastructure condition, not a data gap.

Media typeapplication/json

object

error

required

Human-readable error message.

string

Example

{
  "error": "Facts backend unavailable"
}