QuarterCharts API
US-equity fundamentals as JSON.
Sankey diagrams, multi-statement charts, segments, earnings calendars, and per-ticker logos — every US public company, accessible from any HTTP client. Sourced from SEC EDGAR, Finnhub, and Yahoo Finance.
Quickstart
- Sign in to QuarterCharts with Google. Free, instant, no credit card.
- Go to Dashboard → API keys and click Create new key. Name it whatever helps you remember (e.g. excel-laptop, claude-mcp).
- The key is shown once. Copy it (it starts with
qc_live_) and store it somewhere safe — environment variable, password manager, encrypted vault. - Use it as
Authorization: Bearer <your-key>header in your HTTP client. Examples below.
Rate limits & pricing tiers
Every key carries a per-minute + per-day cap. Hitting either returns 429 Too Many Requests with a Retry-After header telling you when the window resets.
| Tier | Per minute | Per day | Price | Audience |
|---|---|---|---|---|
| Anonymous (no key) | 30 | 500 | Free | Casual exploration, embedded widgets, ad-hoc curl |
| Free | 100 | 5,000 | Free | Hobbyists, students, casual Excel users |
| Pro | 300 | 50,000 | Coming soon | Active analysts, MCP power users |
| Business | 1,000 | 500,000 | Coming soon | Small funds, finance teams |
| Enterprise | Custom | Custom | Contact | Hedge funds, fintech apps embedding our data |
Anonymous tier is keyed by IP — useful for one-off curls, not for production workloads.
Hit a rate limit? Two free ways to get more — no card required
- Get a free API key — raises your limit and unlocks MCP tools (see the tier table above), still free.
- Plug QC into Claude / Cursor via MCP — free, no API key required.
Code examples
All examples fetch Apple’s income statement. Replace qc_live_... with your real key.
curl https://api.quartercharts.com/v1/charts/AAPL?statement=income \
-H "Authorization: Bearer qc_live_..."Response headers
Every successful response carries standard rate-limit headers. Check them after each call to back off gracefully before you trip the cap.
| Header | What it means |
|---|---|
| X-RateLimit-Limit-Minute | Per-minute cap for your tier. |
| X-RateLimit-Remaining-Minute | Calls left in the current minute. |
| X-RateLimit-Limit-Day | Daily cap for your tier. |
| X-RateLimit-Remaining-Day | Calls left until 00:00 UTC tomorrow. |
| Retry-After | On 429 only — seconds until the next request will succeed. |
Full reference
Every endpoint, every response shape — machine-readable OpenAPI spec at api.quartercharts.com/openapi.json. Browsable Swagger UI at api.quartercharts.com/docs.
