Credits and limits

A company KPI lookup costs 1 × 2 = 2 credits.

What a call costs

lookup 1 · history 2 · search 2 · evidence 5 · bulk 25 · change 1

Multiply by the dataset class. Charged after validation, before reading. CPI: 1 × 1 = 1 credit. Price a call without a key.

Headers

  • X-Credits-Cost: spent; X-Credits-Remaining: balance; X-Plan: plan.
  • RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset: this minute's credits.
  • Request-Id: support reference. Retry-After: seconds to wait on 429 or 503.
  • ETag: send it back as If-None-Match. An unchanged answer is a free 304.

Rate limits

  • Per-minute budgets count credits: a 10-credit call uses 10. Exceeded: 429 rate_limited.
  • Period exhausted: 429 credits_exhausted until renewal. Retry-After gives seconds. Unused credits expire.
  • Errors cost nothing: a refused request is not charged, and a 404 or 503 after the charge is refunded. X-Credits-Cost shows what was kept.

Your balance

GET /v1/datasets/account and GET /v1/datasets/usage are free. Routes that take asOf read a past point in time on every plan.

Limits by plan

PlanKeysCredits a monthCredits a minute
Basic5150,000300
Desk201,000,0001,200
Enterpriseby contractby contractby contract

Enterprise defaults: 100 keys, 6,000 credits/minute/key, until contracted.

No plan: 0 keys, 0 credits; 402 plan_required.

Cost by route

All routes112
RouteTypeClassCredits
/v1/gpu/priceslookupx44
/v1/gpu/historyhistoryx48
/v1/gpu/changeschangex44
/v1/macro/cpilookupx11
/v1/energy/inventorieslookupx11
/v1/cftc/cotlookupx11
/v1/cftc/cot/contracts/{contractCode}historyx12
/v1/awardssearchx24
/v1/awards/{id}evidencex210
/v1/kpis/{symbol}lookupx22, 4 with from or to
/v1/guidance/{symbol}lookupx22, 4 with from or to
/v1/credit/screensearchx48
/v1/credit/{symbol}historyx48
/v1/credit/{symbol}/instruments/{id}evidencex420
/v1/exec-pay/{symbol}lookupx22
/v1/exec-pay/{symbol}/{year}evidencex210
/v1/risk-factors/{symbol}lookupx22
/v1/risk-factors/{symbol}/{year}evidencex210
/v1/events/{symbol}searchx12
/v1/revenue-breakdown/{symbol}historyx24
/v1/debt-maturities/{symbol}historyx24
/v1/catalystssearchx12
/v1/litigation/{symbol}searchx12
/v1/catalysts/events/{id}evidencex15
/v1/catalysts/changeschangex11
/v1/sec/filingslookupx11
/v1/sec/filing/documentslookupx11
/v1/sec/filing/contentevidencex15
/v1/sec/insiders/{symbol}bulkx125
/v1/sec/13f/{symbol}/holdershistoryx12
/v1/jobssearchx24
/v1/jobs/{symbol}historyx24
/v1/hiring/{symbol}/postingssearchx24
/v1/hiringlookupx22
/v1/hiring/{symbol}historyx24
/v1/jobs/coveragelookupx22
/v1/hiring/coveragelookupx22
/v1/apps/boardhistoryx12
/v1/apps/app/{store}/{appId}historyx12
/v1/apps/company/{symbol}historyx12
/v1/apps/coveragelookupx11
/v1/power/boardbulkx125
/v1/power/historyhistoryx12
/v1/power/projects/{id}evidencex15
/v1/power/coveragelookupx11
/v1/perps/boardlookupx11
/v1/perps/historyhistoryx12
/v1/perps/rankingslookupx11
/v1/perps/comparelookupx11
/v1/perps/marketevidencex15
/v1/perps/equity/{symbol}lookupx11
/v1/attentionlookupx11
/v1/attention/{symbol}historyx12
/v1/supply-chain/{symbol}/graphbulkx250
/v1/supply-chain/pathsbulkx250
/v1/supply-chain/{symbol}/counterpartiessearchx24
/v1/exposure/scenarioslookupx22
/v1/exposure/analyzebulkx250
/v1/transcriptssearchx24
/v1/transcripts/{id}evidencex210
/v1/document-searchsearchx24
/v1/document-search/documents/{docType}/{sourceId}evidencex210
/v1/storiessearchx24
/v1/stories/sourceslookupx22
/v1/stories/facetslookupx22
/v1/stories/{id}evidencex210
/v1/social-mentions/{symbol}/historyhistoryx12
/v1/social-mentions/{symbol}/postssearchx12
/v1/short-volume/{symbol}historyx12
/v1/short-interest/{symbol}historyx12
/v1/sec/insider-signalsbulkx125
/v1/sec/13f/crowdingbulkx125
/v1/congress/tradessearchx12
/v1/congress/members/{member}searchx12
/v1/congress/tickers/{symbol}searchx12
/v1/macro/curveslookupx11
/v1/macro/curves/{curve}historyx12
/v1/macro/series/{seriesId}historyx12
/v1/macro/calendarlookupx11
/v1/central-bank-rateshistoryx12
/v1/cdssearchx24
/v1/cds/historyhistoryx24
/v1/cds/indexesbulkx250
/v1/cds/sovereignsbulkx250
/v1/fundamentals/{symbol}/statementsevidencex420
/v1/fundamentals/{symbol}/statisticsevidencex420
/v1/fundamentals/{symbol}/profileevidencex210
/v1/market/quotessearchx24
/v1/market/dataevidencex420
/v1/market/historyhistoryx24
/v1/market/fieldslookupx22
/v1/futures/{root}/curvebulkx250
/v1/futures/{root}/archivehistoryx24
/v1/futures/generics/{ticker}historyx24
/v1/rate-pathbulkx250
/v1/options/flowhistoryx24
/v1/options/{symbol}/ivhistoryx24
/v1/options/{symbol}/surfacebulkx250
/v1/options/{symbol}/chainbulkx250
/v1/options/{symbol}/gammabulkx250
/v1/earnings/calendarsearchx24
/v1/earnings/{symbol}/moveshistoryx24
/v1/ipo/calendarsearchx24
/v1/mna/dealssearchx24
/v1/mna/deals/{id}evidencex210
/v1/equity-screenersearchx24
/v1/crypto/marketsbulkx250
/v1/session-tape/moversbulkx250
/v1/session-tape/highs-lowshistoryx24
/v1/session-tape/{symbol}/tapehistoryx24
/v1/analyst-estimates/{symbol}evidencex210
/v1/analyst-estimates/{symbol}/revisionshistoryx24