Price factors on your own data
Price factors
Advanced. Send positions with daily closes from your own licensed data, and get beta, size, momentum, low volatility and liquidity exposures with risk contribution. Creo does not sell prices. For fundamentals without prices, use Portfolio analysis.
Model creo-byod-price-factors. A paid feature (price_factors, Pro) once
paid plans open; the five SYNTH.* demo tickers stay keyless and free.
What you send
- positions: a ticker and signed quantity per holding. Positive is long, negative is short.
- history: daily closes for each holding, plus
volumefor liquidity andmarket_capfor size. - benchmark: a market series on the same dates, needed for beta.
- factors: optional list of factor ids. The default is every price factor for the asset classes in the book; filing factors are opt-in.
- valid_at: optional point-in-time cutoff. Anything published later is ignored.
Numbers may be JSON numbers or numeric strings; strings stay exact. Holdings without the
inputs a factor needs come back null with a reason, never zero.
Factors from SEC filings
List any *.sec factor and Creo reads the issuer's filings on SEC EDGAR for
book-to-price, asset growth, gross profitability and return on assets. You send only a
recent close. Every fact used is listed in sec_sources with its form type,
filing date and accession number.
{
"positions": [
{ "ticker": "AAPL", "quantity": 100, "history": [{ "date": "2026-11-06", "close": "268.47" }] }
],
"factors": ["equity.value.book_to_price.sec", "equity.quality.return_on_assets.sec"]
}
Crypto sleeve
Mark crypto holdings "asset_class": "crypto" and send every calendar day, with
volume in coin units. Equity and crypto are scored in separate sleeves and never added
together; for clean betas, score crypto in its own request with a BTC benchmark.
Reading the response
- exposures[]: one entry per factor, with
value, its long, short and gross parts,coverage, andcontributorsper holding. - risk: 63-session risk contribution by factor and by position, when there is enough shared history.
- quality and warnings[]: a grade and typed flags such as
BENCHMARK_SHARED_ACROSS_SLEEVES. - valid_at, source_known_at, computed_at and methodology_version, so any answer can be reproduced.
- credits: calls used, your daily limit and when it resets.
Example
Python · pip install httpx
# pip install httpx
import os
import httpx
origin = "https://itscreo.com"
key = os.environ.get("CREO_KEY")
if not key: # mint once, then reuse: minting is limited to 5 keys per IP per day
minted = httpx.post(f"{origin}/v1/keys", json={})
minted.raise_for_status()
key = minted.json()["key"]
print(f"export CREO_KEY={key}")
r = httpx.post(
f"{origin}/v1/portfolio/exposures",
headers={"x-api-key": key},
json={
"positions": [
{"ticker": "SYNTH.MOM", "quantity": 10},
{"ticker": "SYNTH.DEF", "quantity": -5},
],
"cash": 2000,
},
)
r.raise_for_status()
for exposure in r.json()["exposures"]:
print(exposure["factor_id"], exposure["value"])
Endpoints
POST/v1/portfolio/exposures
Score a portfolio for named factor exposures and risk contribution Key optional
Send positions with your own daily closes; Creo returns each factor's portfolio exposure (weights x per-position characteristic), the long and short book contributions, 63-session risk contribution, coverage, quality flags and timestamps. Missing data is null with a reason, never zero. SYNTH.* tickers without history work keyless. 1 successful call = 1 credit; typed 422s are free.
Request body
positionsarray of PublicPositionrequiredLong (quantity > 0) and short (quantity < 0) positions. The plan caps the count: Free 5, Builder 50, Pro 200.
Child fields
tickerstringrequiredYour identifier for the instrument (A-Z, 0-9, '.', '-'). Creo does not look it up; SYNTH.* tickers use built-in synthetic demo series.
quantitydecimalrequiredSigned units held. Positive is long, negative is short. Non-zero.
asset_classenumequity or crypto. Each class is scored in its own sleeve with its own factors; the two are never added together.
One of equity, crypto
Default "equity"
closedecimalnullableValuation close in USD. Defaults to the last close in history.
market_capdecimalnullableMarket capitalization in USD. Needed for the size factor.
historyarray of PublicBarDaily closes, any order. Required for every non-SYNTH ticker. /llms-full.txt lists how many closes each factor needs (up to 253).
Child fields
datedaterequiredSession date (YYYY-MM-DD).
closedecimalrequiredClose price in USD.
volumedecimalnullableShares (or coins) traded. Needed for the liquidity factors.
cashdecimalCash in USD, added to net asset value (NAV). For long/short books, send the account's cash so weights are fractions of real NAV.
Default "0"
factorsarray of stringnullableFactor ids to compute. Default: every factor for the asset classes in the book. GET /llms.txt lists the ids.
valid_atdatetimenullablePoint-in-time cutoff in UTC (ends with Z). Bars after this date are ignored. Default: the close of the latest supplied session.
benchmarkPublicBenchmarknullableRequired for market beta and the market/residual risk split. Without it beta is null with MISSING_BENCHMARK.
Child fields
tickerstringLabel only.
Default "BENCHMARK"
historyarray of PublicBarrequiredDaily benchmark closes on the same dates as the positions' history.
Child fields
datedaterequiredSession date (YYYY-MM-DD).
closedecimalrequiredClose price in USD.
volumedecimalnullableShares (or coins) traded. Needed for the liquidity factors.
universeenumnullableLabel echoed as each exposure's reference_universe. v1 returns raw characteristics, not cross-sectional z-scores, so this does not change values.
One of client_supplied, demo_synthetic
Example
curl -X POST https://itscreo.com/v1/portfolio/exposures \
-H "content-type: application/json" \
-d '{"positions":[{"ticker":"SYNTH.MOM","quantity":"-10"},{"ticker":"SYNTH.DEF","quantity":"10"}],"cash":"5000"}'Responses
- 200Successful Response
PublicExposureResponse - 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 - 401AUTHENTICATION_REQUIRED: missing or invalid key
Error - 429RATE_LIMITED: daily credits used up
Error
Response fields
result_idanyrequiredmethodology_versionanyrequireddata_policyanyrequiredsynthetic_demo when every position is a SYNTH.* demo series, otherwise customer_supplied_prices. Creo sells compute, not market data.
valuation_summaryanyrequiredinstrumentsanyrequiredexposuresanyrequiredriskanyrequirednot_aggregatedanyrequiredcoverageanyrequiredqualityanyrequiredwarningsanyrequiredprovenanceanyrequiredvalid_atanyrequiredsource_known_atanyrequiredsystem_known_atanyrequiredcomputed_atanyrequiredcreditsanyrequiredsec_sourcesanySEC EDGAR facts behind each *.sec factor value, with accession numbers.
GET/v1/demo/exposures
Score the five SYNTH.* demo tickers Key optional
Works without a key (20 calls a day per IP) or with one (1 credit).
Example
curl https://itscreo.com/v1/demo/exposures
Responses
- 200Successful Response
PublicExposureResponse - 400KEY_IN_QUERY: send the key in a header, not the URL
Error - 422INVALID_REQUEST, or a typed failure such as PRICES_REQUIRED, QUANTITY_NEEDS_VALUE or POSITION_LIMIT. Not charged.
Error - 401AUTHENTICATION_REQUIRED: missing or invalid key
Error - 429RATE_LIMITED: daily credits used up
Error
Response fields
result_idanyrequiredmethodology_versionanyrequireddata_policyanyrequiredsynthetic_demo when every position is a SYNTH.* demo series, otherwise customer_supplied_prices. Creo sells compute, not market data.
valuation_summaryanyrequiredinstrumentsanyrequiredexposuresanyrequiredriskanyrequirednot_aggregatedanyrequiredcoverageanyrequiredqualityanyrequiredwarningsanyrequiredprovenanceanyrequiredvalid_atanyrequiredsource_known_atanyrequiredsystem_known_atanyrequiredcomputed_atanyrequiredcreditsanyrequiredsec_sourcesanySEC EDGAR facts behind each *.sec factor value, with accession numbers.