DocsPrice factors

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 volume for liquidity and market_cap for 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, and contributors per 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 PublicPositionrequired

Long (quantity > 0) and short (quantity < 0) positions. The plan caps the count: Free 5, Builder 50, Pro 200.

Child fields
tickerstringrequired

Your identifier for the instrument (A-Z, 0-9, '.', '-'). Creo does not look it up; SYNTH.* tickers use built-in synthetic demo series.

quantitydecimalrequired

Signed units held. Positive is long, negative is short. Non-zero.

asset_classenum

equity 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"

closedecimalnullable

Valuation close in USD. Defaults to the last close in history.

market_capdecimalnullable

Market capitalization in USD. Needed for the size factor.

historyarray of PublicBar

Daily closes, any order. Required for every non-SYNTH ticker. /llms-full.txt lists how many closes each factor needs (up to 253).

Child fields
datedaterequired

Session date (YYYY-MM-DD).

closedecimalrequired

Close price in USD.

volumedecimalnullable

Shares (or coins) traded. Needed for the liquidity factors.

cashdecimal

Cash 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 stringnullable

Factor ids to compute. Default: every factor for the asset classes in the book. GET /llms.txt lists the ids.

valid_atdatetimenullable

Point-in-time cutoff in UTC (ends with Z). Bars after this date are ignored. Default: the close of the latest supplied session.

benchmarkPublicBenchmarknullable

Required for market beta and the market/residual risk split. Without it beta is null with MISSING_BENCHMARK.

Child fields
tickerstring

Label only.

Default "BENCHMARK"

historyarray of PublicBarrequired

Daily benchmark closes on the same dates as the positions' history.

Child fields
datedaterequired

Session date (YYYY-MM-DD).

closedecimalrequired

Close price in USD.

volumedecimalnullable

Shares (or coins) traded. Needed for the liquidity factors.

universeenumnullable

Label 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_idanyrequired
methodology_versionanyrequired
data_policyanyrequired

synthetic_demo when every position is a SYNTH.* demo series, otherwise customer_supplied_prices. Creo sells compute, not market data.

valuation_summaryanyrequired
instrumentsanyrequired
exposuresanyrequired
riskanyrequired
not_aggregatedanyrequired
coverageanyrequired
qualityanyrequired
warningsanyrequired
provenanceanyrequired
valid_atanyrequired
source_known_atanyrequired
system_known_atanyrequired
computed_atanyrequired
creditsanyrequired
sec_sourcesany

SEC 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_idanyrequired
methodology_versionanyrequired
data_policyanyrequired

synthetic_demo when every position is a SYNTH.* demo series, otherwise customer_supplied_prices. Creo sells compute, not market data.

valuation_summaryanyrequired
instrumentsanyrequired
exposuresanyrequired
riskanyrequired
not_aggregatedanyrequired
coverageanyrequired
qualityanyrequired
warningsanyrequired
provenanceanyrequired
valid_atanyrequired
source_known_atanyrequired
system_known_atanyrequired
computed_atanyrequired
creditsanyrequired
sec_sourcesany

SEC EDGAR facts behind each *.sec factor value, with accession numbers.