Pricing & Credits

Tengu uses a single credit wallet per customer. Your subscription tier grants a monthly pool of credits and a rate limit; every API call draws from that pool. Above the included grant, paid tiers can spend into metered overage up to a hard cap.

How credits work#

One wallet, both surfaces. Brain (per-token) and FIRM (per-call) debit the same credit balance.
Monthly grant. Your tier includes a fixed number of credits that auto-refill each billing period.
Overage. On paid tiers, you can spend past the grant (metered, billed as overage) up to a per-tier ceiling, after which calls hard-cap with a 402 usage_exceeded.
Free hard-caps at the grant — no overage.
You are charged only for verified, served requests. A request that returns 401, 402, 403, 404, 429, or 502 does not deduct credits.

Rate card — FIRM data API (per call)#

Each FIRM call debits a flat per-product credit cost:

Product	credits/call	First plan
`market_data`	1	Free
`fundamentals`	1	Free
`public_filings`	1	Free
`congressional`	2	Starter
`news_sentiment`	2	Starter
`macro_rates`	2	Starter
`quant_signals`	3	Starter
`funds` (13F + Form-4)	4	Starter
`alt_data`	3	Pro
`tape`	3	Pro
`events_transcripts`	3	Pro
`options_flow`	4	Pro
`credit`	4	Pro
`execution_research`	4	Pro
`risk_analytics`	5	Pro
`private_markets`	5	Pro
`llm_research`	6	Pro
`copilot`	10	Expert (or $199 add-on)

An unrecognized product defaults to 1 credit. /api/v3/private_markets/search is 0 credits (charges nothing) but still needs a valid key like every data route. /api/capabilities and the health/status/monitoring routes need no key at all.

Rate card — Brain agent API (per token)#

Brain is metered per token (each turn's list-price cost is converted to credits at 2,500 credits per $1, ≈ $0.0004/credit). A Brain request is a single metered event regardless of how many FIRM tools it calls internally — you are not separately charged for the tools Brain invokes on your behalf.

Tiers#

Tier	Price / mo	Included credits / mo	Wallet ceiling (grant + overage)	Rate limit	Products
Free	$0	1,000	1,000 (hard-cap)	30 req/min	`market_data`, `fundamentals`, `public_filings`
Starter	$99	250,000	1,000,000	120 req/min	Free + `congressional`, `news_sentiment`, `macro_rates`, `quant_signals`, `funds`
Pro	$499	2,000,000	10,000,000	600 req/min	Starter + `alt_data`, `tape`, `events_transcripts`, `options_flow`, `credit`, `execution_research`, `risk_analytics`, `private_markets`, `llm_research`
Expert	$999	5,000,000	25,000,000	1,200 req/min	Pro + `copilot`
Enterprise	Custom (sales)	20,000,000	100,000,000	6,000 req/min	All products + `copilot` + the Brain agent

Notes:

Included credits is the monthly grant that refills at the start of each billing period.
Wallet ceiling is the grant + overage headroom. On paid tiers you can spend up to the ceiling; the excess above your included grant is billed as metered overage. Past the ceiling, calls return 402 usage_exceeded.
Free hard-caps exactly at its 1,000-credit grant — no overage.
copilot is bundled on Expert and Enterprise, or available as a $199/mo add-on on any paid plan.
brain (the agent API) is Enterprise-only. Pro and below call the FIRM data products directly.

À-la-carte add-ons#

Buy a single premium product on top of any paid plan — each add-on is its own subscription that unlocks the product and adds a monthly credit pack to your shared wallet:

Add-on	Price / mo	Credit pack	Unlocks
Private Markets	$299	300,000	`private_markets` (≈60k profile calls)
Options Flow	$79	100,000	`options_flow` (≈25k flow calls)
Copilot	$199	60,000	`copilot` (≈6k verdicts)

Add-ons require an active paid base plan (Starter or Pro). They stack on top of your tier — a Starter customer can add Private Markets without upgrading to Pro.

What happens when you run out#

When the wallet is exhausted (or you reach your overage ceiling), calls return:

Code

1HTTP/1.1 402 Payment Required2{ "detail": { "error_code": "usage_exceeded", "error_message": "credit balance exhausted — add credits or upgrade your plan" } }

To restore service, top up or upgrade your plan in the dashboard. Credits refill automatically each billing period.

Estimating cost#

A FIRM workflow that pulls a market quote (1) + a 13F lookup (4) + a Copilot verdict (10) costs 15 credits for those three calls.
Private Markets: search is free, so search (0) → company/{id} profile (5) = 5 credits per company you actually open.
A Brain request costs roughly the total tokens of the request and response in credits — one metered event, no matter how many tools it used internally.

See api-reference.md for the full endpoint list, per-plan access, and error shapes.