DocsCredits and limits

Reference

Credits and limits

One successful scoring call is one credit, however many factors it returns. Errors, validation failures and account reads are free.

Plans

PlanPriceCalls a dayPositions per callFor
FreeFree10050SEC fundamental scores and portfolio analysis by API.
Builder$49 a month1,000200Commercial use in one product or agent.
Pro$199 a month10,000200Full books, bulk exports and production agents.

Limits

  • Daily calls reset at 00:00 UTC. Over the limit you get 429 RATE_LIMITED with Retry-After.
  • Positions per call are capped by plan; a larger book is a free 422 POSITION_LIMIT.
  • Keyless demo calls are limited to 20 a day per IP address.
  • Key creation is limited to 5 keys a day per IP address.

The credits block

Every scoring response reports your usage, so an agent can pace itself without a second call.

"credits": {
  "plan": "free",
  "calls_used": 2,
  "daily_call_limit": 100,
  "max_positions": 5,
  "reset_at": "2026-11-20T00:00:00+00:00"
}

Creo Investor is separate

Creo Investor is the retail plan for the analyzer on this site, priced on the pricing page. It includes no API calls, and API plans include no Investor features. /v1/plans lists it under investor.

Plans endpoint

GET/v1/plans

Plans No key needed

Example

curl https://itscreo.com/v1/plans

Responses

  • 200Successful Response PlanCatalog
  • 400KEY_IN_QUERY: send the key in a header, not the URL Error
Response fields
plansarray of Planrequired

API plans for keys: Free, Builder and Pro.

Child fields
idstringrequired
namestringrequired
monthly_usdintegerrequired
daily_call_limitintegerrequired
max_positionsintegerrequired
summarystringrequired
featuresarray of PlanFeature
Child fields
textstringrequired
enforced_byarray of stringrequired

How Creo enforces it: gate:<feature> (a plan check on the route), limit:daily_call_limit or limit:max_positions, includes:<plan>, included (every key gets it) or terms (the license, not a technical limit).

checkout_openbooleanrequired

True once API plans can be bought.

investorInvestorCatalogrequired

Creo Investor, the separate retail plan for the web analyzer.

Child fields
checkout_openbooleanrequired

True once Investor can be bought.

plansarray of InvestorPlanrequired
Child fields
idstringrequired
namestringrequired
monthly_usdintegerrequired
yearly_usdintegerrequired

Price when billed yearly, for the whole year.

summarystringrequired
featuresarray of PlanFeaturerequired
Child fields
textstringrequired
enforced_byarray of stringrequired

How Creo enforces it: gate:<feature> (a plan check on the route), limit:daily_call_limit or limit:max_positions, includes:<plan>, included (every key gets it) or terms (the license, not a technical limit).

Features by plan

Four API features need a paid plan. A call that uses one without that plan gets 403 PLAN_REQUIRED, with feature and required_plan in the error body, and is not charged.

FeatureWhat it coversPlan
as_of_historyScores on any past as_of date, and quarterly history at /v1/scores/historyBuilder
tape_cursorPolling the SEC filing tape by API with afterBuilder
bulk_exportScores for the whole universe in one exportPro
price_factorsPrice factors on your own data, /v1/portfolio/exposuresPro

These features require the plan: a keyless call or a lower plan gets 403 PLAN_REQUIRED with feature and required_plan. The analyzer on this site is free for up to 50 holdings; Creo Investor adds each holding's last 8 quarters of history and up to 500 holdings in that browser. It does not unlock these API features.