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
| Plan | Price | Calls a day | Positions per call | For |
|---|---|---|---|---|
| Free | Free | 100 | 50 | SEC fundamental scores and portfolio analysis by API. |
| Builder | $49 a month | 1,000 | 200 | Commercial use in one product or agent. |
| Pro | $199 a month | 10,000 | 200 | Full books, bulk exports and production agents. |
Limits
- Daily calls reset at 00:00 UTC. Over the limit you get
429 RATE_LIMITEDwithRetry-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 PlanrequiredAPI plans for keys: Free, Builder and Pro.
Child fields
idstringrequirednamestringrequiredmonthly_usdintegerrequireddaily_call_limitintegerrequiredmax_positionsintegerrequiredsummarystringrequiredfeaturesarray of PlanFeatureChild fields
textstringrequiredenforced_byarray of stringrequiredHow 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_openbooleanrequiredTrue once API plans can be bought.
investorInvestorCatalogrequiredCreo Investor, the separate retail plan for the web analyzer.
Child fields
checkout_openbooleanrequiredTrue once Investor can be bought.
plansarray of InvestorPlanrequiredChild fields
idstringrequirednamestringrequiredmonthly_usdintegerrequiredyearly_usdintegerrequiredPrice when billed yearly, for the whole year.
summarystringrequiredfeaturesarray of PlanFeaturerequiredChild fields
textstringrequiredenforced_byarray of stringrequiredHow 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.
| Feature | What it covers | Plan |
|---|---|---|
as_of_history | Scores on any past as_of date, and quarterly history at /v1/scores/history | Builder |
tape_cursor | Polling the SEC filing tape by API with after | Builder |
bulk_export | Scores for the whole universe in one export | Pro |
price_factors | Price factors on your own data, /v1/portfolio/exposures | Pro |
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.