SEC fundamental scores
Scores
Scores rank each company against every US-listed SEC filer, as a z-score, percentile and
plain label per factor, built only from its 10-K and 10-Q filings. Send up to 50 tickers a call without a key or
with a free key, or 200 with Builder or Pro; no prices needed. A past as_of and
/v1/scores/history need Builder.
Reading a score
A z-score says how many standard deviations a security sits from the universe average on a factor; a percentile says what share of the universe it beats. Both are cross-sectional: they depend on the universe and the as-of date, which every response states. See Methodology for each factor's formula and direction.
Endpoints
POST/v1/scores
Scores No key needed
Fundamental factor z-scores, percentiles and labels for up to 50 tickers keyless or with a free key, or the plan's limit (200) with a Builder or Pro key. Built only from SEC EDGAR filings, so no prices are needed. Positive z means the factor's named tilt (see `high_means`). Unscored tickers carry a reason code. A past `as_of` needs the Builder plan (403 PLAN_REQUIRED otherwise).
Request body
tickersarray of stringrequiredas_ofdatenullableExample
curl -X POST https://itscreo.com/v1/scores \
-H "content-type: application/json" \
-d '{}'Responses
- 200Successful Response
creo__tape__models__ScoreBatch - 422INVALID_REQUEST, or a typed failure such as PRICES_REQUIRED, QUANTITY_NEEDS_VALUE or POSITION_LIMIT. Not charged.
Error - 400KEY_IN_QUERY: send the key in a header, not the URL
Error
Response fields
as_ofdaterequiredcomputed_atdatetimerequiredmethodology_versionstringrequireduniverseUniverseInforequiredChild fields
namestringrequiredsizeintegerrequiredUS-listed issuers (unique CIKs) in SEC's ticker file
scoredintegerrequiredIssuers with a current fundamental snapshot
estimationintegerrequiredIssuers that set the cross-sectional moments
descriptionstringrequiredquality_flagsarray of stringrequiredfactorsarray of FactorInforequiredChild fields
idstringrequiredlabelstringrequiredshort_labelstringrequiredhigh_meansstringrequiredlow_meansstringrequireddescriptionstringrequiredraw_labelstringrequiredunitstringrequiredscoresmaprequiredunknown_tickersarray of stringrequiredGET/v1/scores/factors
Score Factors No key needed
Example
curl https://itscreo.com/v1/scores/factors
Responses
- 200Successful Response
- 400KEY_IN_QUERY: send the key in a header, not the URL
Error
GET/v1/scores/history
Score History No key needed
Point-in-time factor z per quarter-end, oldest first. Needs the Builder plan (as_of_history). The /portfolio page's Investor-entitled, invited or connected browsers get the last 8 quarters without a key. Each date uses only filings filed by then. Funds apply their latest N-PORT holdings.
query parameter tickers: Comma-separated tickers
query parameter quarters:
Example
curl https://itscreo.com/v1/scores/history
Responses
- 200Successful Response
HistoryResponse - 422INVALID_REQUEST, or a typed failure such as PRICES_REQUIRED, QUANTITY_NEEDS_VALUE or POSITION_LIMIT. Not charged.
Error - 400KEY_IN_QUERY: send the key in a header, not the URL
Error
Response fields
methodology_versionstringrequiredhistory_versionintegerrequiredmethodstringrequireddatesarray of daterequiredCalendar quarter-ends, oldest first
factorsarray of stringrequiredquality_flagsarray of stringrequiredtickersmaprequiredunknown_tickersarray of stringrequiredGET/v1/scores/export
Score Export No key needed
Every scored US-listed ticker as gzipped NDJSON: {as_of, ticker, cik, company, exchange, factors: {id: [z, percentile]}} per line. Streamed; supports If-None-Match.
query parameter as_of:
Example
curl https://itscreo.com/v1/scores/export
Responses
- 200Successful Response
- 422INVALID_REQUEST, or a typed failure such as PRICES_REQUIRED, QUANTITY_NEEDS_VALUE or POSITION_LIMIT. Not charged.
Error - 400KEY_IN_QUERY: send the key in a header, not the URL
Error
GET/v1/scores/ranked
Ranked No key needed
Listed companies with the highest or lowest z on one factor, most extreme first.
query parameter factor: Factor id from /v1/scores/factors
query parameter direction:
query parameter min_float_usd: Minimum SEC-reported public float, USD
query parameter limit:
query parameter exclude: Comma-separated tickers to leave out
Example
curl https://itscreo.com/v1/scores/ranked
Responses
- 200Successful Response
RankedResponse - 422INVALID_REQUEST, or a typed failure such as PRICES_REQUIRED, QUANTITY_NEEDS_VALUE or POSITION_LIMIT. Not charged.
Error - 400KEY_IN_QUERY: send the key in a header, not the URL
Error
Response fields
factorstringrequiredlabelstringrequireddirectionenumrequiredOne of high, low
meansstringrequiredWhat the chosen direction means (high_means or low_means)
min_float_usdnumberrequiredcomputed_atdatetimerequiredmethodology_versionstringrequiredeligibleintegerrequiredScored listed issuers that passed the filters
issuersarray of RankedIssuerrequiredMost extreme first
Child fields
tickerstringrequiredcikstringrequiredcompanystringrequiredexchangestringrequiredznumberrequiredpercentilenumberrequired0-100 within the scored universe
labelstringrequiredpublic_float_usdnumberrequireddei:EntityPublicFloat from the latest 10-K cover, USD
GET/v1/scores/benchmark
Score Benchmark No key needed
US market factor exposures: public-float-weighted and equal-weighted mean z.
Example
curl https://itscreo.com/v1/scores/benchmark
Responses
- 200Successful Response
BenchmarkResponse - 400KEY_IN_QUERY: send the key in a header, not the URL
Error
Response fields
as_ofdaterequiredcomputed_atdatetimerequiredmethodology_versionstringrequirednamestringrequiredmethodstringrequiredissuersintegerrequiredfloat_issuersintegerrequiredtotal_public_float_usdnumberrequiredquality_flagsarray of stringrequiredfactorsarray of BenchmarkFactorrequiredChild fields
factorstringrequiredlabelstringrequiredfloat_weightednumberrequiredPublic-float-weighted mean z
equal_weightednumberrequiredEqual-weighted mean z
float_weighted_labelstringrequiredissuersintegerrequiredIssuers with this factor in the float-weighted mean
Universe
Every US-listed ticker in SEC's company file, with name and exchange, for autocomplete and validation.
GET/v1/universe
Universe No key needed
Every US-listed ticker in SEC's file as [ticker, name, exchange], for autocomplete.
Example
curl https://itscreo.com/v1/universe
Responses
- 200Successful Response
- 400KEY_IN_QUERY: send the key in a header, not the URL
Error