Skip to main content
POST
curl
stock_universe is schema-2 only. Omit schema or send { "schema": 2 }.
The default page returns 100 ticker-sorted listings. Use offset and limit (maximum 500) to continue, and filter by coverage or shape before running a fundamentals screen. The three coverage markers are mutually exclusive database facts: has_fundamentals, prices_only, and discovery_only. has_fundamentals means a published overview build exists; values inside it may still serve as verification_pending during scoring windows. This differs from stock_search preflight, which checks the financials pointer to answer whether statements are servable.

Authorizations

X-API-Key
string
header
required

Body

application/json

Schema-2-only listing universe page.

coverage
enum<string>

Optional mutually exclusive database-derived coverage marker.

Available options:
has_fundamentals,
prices_only,
discovery_only
shape
enum<string>

Optional published filer-shape filter.

Available options:
operating_company,
bank,
broker_dealer,
insurer,
reit,
bdc,
ifrs,
ifrs_bank,
ifrs_insurer
offset
integer
default:0
Required range: x >= 0
limit
integer
default:100
Required range: 1 <= x <= 500
schema
enum<integer>
default:2

This new endpoint is schema-2 only.

Available options:
2

Response

A columnar page with visible omitted-count and continuation metadata.

Schema-2 envelope. The OpenAPI schema is structural; captured examples are authoritative for full nested payload detail.

data
object
required

Tool payload or typed schema-2 refusal.

meta
object
required

Schema-2 metadata. Unknown optional fields are omitted, not emitted as null.

subject
object

Resolved entity and security when the tool has a single subject.