Get started
Rate limits
Every plan shares one daily and monthly credit pool for REST and MCP. Credits are weighted by endpoint (search / L1 MCP = 1, financials = 10, supply chain = 20). Past your monthly allotment, calls draw on a prepaid credit balance you top up whenever you like — on Free too. Nothing is billed in arrears.
Plan allotments
| Plan | Daily | Monthly |
|---|---|---|
| Free | 100 | 1,000 |
| Pro | 2,500 | 25,000 |
| Business | 10,000 | 100,000 |
Shared REST + MCP pool · 1 credit ≈ $0.01 list · live from plan catalog.
Credit weights
| Band | Credits | Examples |
|---|---|---|
| Search / L1 | 1 | search_ticker, list_filings, get_price_snapshot, get_fx |
| Filing body | 2 | get_filing, get_filing_section |
| Premium doc | 3 | list_news, IR / press routes |
| Financials | 10 | get_company_financials |
| Graph / analysis | 20 | get_company_supply_chain, get_company_analysis |
What counts
- Metered — REST and MCP share the pool above (L1 discovery = 1 credit each).
- Not metered —
list_notifications. - Failed requests — soft-refunded to 0 credits (row kept for OK/KO analytics). Anything drawn from the prepaid balance goes back to the balance.
Windows
- Daily — resets at UTC midnight (velocity guard).
- Monthly — resets on the 1st of each calendar month (UTC). The plan allotment is spent first, then the prepaid balance, which never resets.
Monitor Dashboard → Usage. The daily cap is a velocity guard with nothing behind it — when it trips, the API returns 429 Too Many Requests and waiting is the fix:
{
"detail": { "error": "quota_exceeded", "dimension": "daily" }
}Prepaid credits
Top up in packs of $5 / $25 / $100 / $500 at a flat $0.01 per credit — no volume bands, no expiry, no subscription required. Once the monthly allotment is spent, each call debits the balance. When the balance cannot cover a call the API returns 402 Payment Required — waiting does not help, topping up does:
{
"detail": {
"error": "credits_exhausted",
"dimension": "balance",
"credit_balance": 0
}
}The response carries X-Credits-Required and X-Credits-Balance headers, plus a top_up_url. Buy credits from Dashboard → Usage; see Pricing for the packs. Business covers higher committed volume.
Burst guards
Some tools also have short burst guards in addition to the daily and monthly allowance. When a burst limit trips, the API returns 429 Too Many Requests — wait a moment and retry.