DocsScores

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 stringrequired
as_ofdatenullable

Example

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_ofdaterequired
computed_atdatetimerequired
methodology_versionstringrequired
universeUniverseInforequired
Child fields
namestringrequired
sizeintegerrequired

US-listed issuers (unique CIKs) in SEC's ticker file

scoredintegerrequired

Issuers with a current fundamental snapshot

estimationintegerrequired

Issuers that set the cross-sectional moments

descriptionstringrequired
quality_flagsarray of stringrequired
factorsarray of FactorInforequired
Child fields
idstringrequired
labelstringrequired
short_labelstringrequired
high_meansstringrequired
low_meansstringrequired
descriptionstringrequired
raw_labelstringrequired
unitstringrequired
scoresmaprequired
unknown_tickersarray of stringrequired

GET/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_versionstringrequired
history_versionintegerrequired
methodstringrequired
datesarray of daterequired

Calendar quarter-ends, oldest first

factorsarray of stringrequired
quality_flagsarray of stringrequired
tickersmaprequired
unknown_tickersarray of stringrequired

GET/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
factorstringrequired
labelstringrequired
directionenumrequired

One of high, low

meansstringrequired

What the chosen direction means (high_means or low_means)

min_float_usdnumberrequired
computed_atdatetimerequired
methodology_versionstringrequired
eligibleintegerrequired

Scored listed issuers that passed the filters

issuersarray of RankedIssuerrequired

Most extreme first

Child fields
tickerstringrequired
cikstringrequired
companystringrequired
exchangestringrequired
znumberrequired
percentilenumberrequired

0-100 within the scored universe

labelstringrequired
public_float_usdnumberrequired

dei: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_ofdaterequired
computed_atdatetimerequired
methodology_versionstringrequired
namestringrequired
methodstringrequired
issuersintegerrequired
float_issuersintegerrequired
total_public_float_usdnumberrequired
quality_flagsarray of stringrequired
factorsarray of BenchmarkFactorrequired
Child fields
factorstringrequired
labelstringrequired
float_weightednumberrequired

Public-float-weighted mean z

equal_weightednumberrequired

Equal-weighted mean z

float_weighted_labelstringrequired
issuersintegerrequired

Issuers 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