Batch series metadata lookup
const url = 'https://api.stockalloy.com/api/b2b/series/batch';const options = { method: 'POST', headers: {'X-API-Key': '<X-API-Key>', 'Content-Type': 'application/json'}, body: '{"ids":["01J5KXW8YB6R2T9V3N4M7Q8Z1A"]}'};
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/series/batch \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <X-API-Key>' \ --data '{ "ids": [ "01J5KXW8YB6R2T9V3N4M7Q8Z1A" ] }'Fetch metadata (and pre-built chart blob URLs) for up to 100 series by series_id. Results preserve request order; unknown IDs are omitted.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
Series IDs (also accepted as series_ids).
Example
{ "ids": [ "01J5KXW8YB6R2T9V3N4M7Q8Z1A" ]}Responses
Section titled “Responses”Series metadata rows.
object
object
object
Pre-built series data blob (/s/series/{series_id}/{version}), immutable and cacheable.
Examplegenerated
{ "series": [ { "series_id": "example", "series_key": "example", "cik": "example", "ticker": "example", "current_ticker": "example", "company_name": "example", "metric_id": "example", "dims_hash": "example", "dims_key": "example", "unit_signature": "example", "title": "example", "subtitle": "example", "y_label": "example", "preferred_scale": "example", "series_kind": "example", "is_active": true, "first_period_end": "example", "last_period_end": "example", "point_count": 1, "meaning_hint": "example", "meaning_disclaimer": "example", "meaning_tooltip": "example", "needs_meaning_tooltip": true, "serving": { "series_version": 1, "etag": "example", "points_count": 1, "first_period": "example", "last_period": "example", "built_at": "example", "blob_url": "example" } } ]}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"}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"}