Pricing Live tier table (JSON) API docs
Pricing — credits per call, no surprises
One credit = one cent. Every response tells you what tier it billed at and what's left. Free tier covers discovery so you can plan spend before you spend. No card to start; $5 trial.
X-Genka-Pricing-Tier + X-Genka-Credits-Used + X-Genka-Credits-Remaining headers, plus meta.usage in the JSON body. 402 responses include credits_required and a hint with the top-up amount, so retry logic is mechanical.
Tiers
| Tier | Cost | What's in it |
|---|---|---|
| free | 0 credits | /health · /capabilities · /llms.txt · /docs · /v1/pricing · /docs/openapi.json |
| read | 1 credit | /mf/{slug} · /mf/{slug}/metrics · /mf/{slug}/holdings · /companies/{sym} · /companies/{sym}/ratios · /companies/{sym}/statements · /prices/{sym} · /prices/{sym}/latest · /concalls/{id} · /sectors/{slug} |
| search | 5 credits | /search · /mf/screener · /screener (companies) · /mf/compare · /mf/{slug}/overlap · /concalls/search · /prices?symbols= |
| compute | 25 credits | /mf/backtest · /mf/{slug}/sip · /mf/portfolio/analyze |
| llm | ~1.2× upstream cost | /concalls/answer (RAG with citations). Metered, not flat-rate — actualCostCents from the model provider lands in meta.usage |
| export | 50 credits | /mf/export (JSONL/CSV/parquet bulk dump) |
Plans
Trial
7 days. 500 credits. No card.
- Hit any route to validate
- Same response shape as paid
- Convert when ready
Solo
3,000 credits / month. Resets monthly.
- Personal scripts + Claude Code
- 600 req/min rate limit
- Scoped keys (read / write / all)
Team
15,000 credits / month. Org seats, shared usage.
- Multiple keys per org
- Audit log per key
- Topup any time at the same per-credit rate
How the meter works
Every billable response increments your usage counter post-2xx, never before. 4xx and 5xx don't bill. Free routes never bill, even on 200. Idempotency-Key on POST routes returns the cached response within 24h so retries don't double-charge.
The /v1/pricing endpoint returns the live tier table
as JSON — same source the middleware uses for billing
decisions. If anything below ever drifts, that endpoint is the
source of truth. Build a watchdog around it if you want
paranoia-level monitoring.