What does one research call cost?
Reading a stored object costs two cents. Where the piece has to be generated, the provider cost actually incurred is added.
Whoever requests a context object first, once its freshness window has passed, pays for its generation. Every later call costs two cents, however expensive that generation happened to be.
Connect the MCP NowAvailable data
Context objects are billed by use rather than sold as a subscription. Billing runs against a wallet in your account, separate from the daily request units of the Data API.
An assistant researching a question on its own pays the full model and search cost every time. The sector brief of 8 June 2026 evaluated twelve sources. If ten users ask the same question in the same week, that work happens ten times over.
Assume such a run costs €0.12 at the provider, and that 10 requests fall on the same object within its freshness window.
| Case | Calculation | Total |
|---|---|---|
| Everyone researches separately | 10 × €0.12 | €1.20 |
| Requested through Leeway | €0.12 for the first call, then 9 × €0.02 | €0.30 |
The gap widens with the number of people asking the same question and with the cost of each individual run. The assumed provider cost is an illustration; what you are charged is always the amount actually incurred.
Billing happens per call, directly against the wallet.
| Case | Amount |
|---|---|
| Read from the cache | €0.02 |
| Generating a new piece | The provider cost actually incurred |
| Failed call | not billed |
| Wallet too low | HTTP 402 stating the amount required and the amount held |
A generate is anything that actually incurs provider cost, so a fresh run as much as a translation or rewrite that had not been stored yet. A call counts as served from the cache when no provider cost arose. At least €0.50 must be available before a generation starts, but the final charge is only the provider cost actually incurred. Amounts in US dollars are converted at the last close of the EURUSD pair and rounded up.
The wallet is kept in millieuros, that is thousandths of a euro, so two cents are twenty millieuros. Where the balance is insufficient the API answers with status 402 and states the amount required and the amount held in that unit. Any auto-recharge you have configured is attempted first.
A stored piece is addressed by ticker, or for themes by the identifier derived from the thesis, together with the type of research. The cache is shared across all users, so whoever generates a piece makes it available to everyone else.
With maxAgeDays or maxAgeHours you set how old a piece may be. Where a document falls inside that limit it is read and costs two cents. Where it falls outside, new research runs and that call carries the cost.
A value of zero forces a fresh run. The three market objects are exempt, because their documents come from an internal job and the public route generates nothing there.
The default maximum age decides how often anyone pays for research at all.
| Object | What it is | Default freshness |
|---|---|---|
| Equities | ||
| What's New | A dated briefing on recent events at a company, with the context an AI assistant needs to explain what changed and why it matters. | 7 days |
| Timeline | A five-year chronology of the events that shaped a company, so an AI assistant can explain how its position and investor view evolved. | 30 days |
| Competitors | A structured view of the companies competing in the same market, including their roles, relative strengths and weaknesses. | 90 days |
| Risks | The material risks facing a company, with context on how they could affect its business and stock. | 90 days |
| Price drivers | A structured view of the forces currently moving a stock’s price and the events or expectations behind them. | 30 days |
| What's New: Industry | A briefing on recent events and shifts in the industry, providing context for the company’s market position. | 7 days |
| What's New: Sector | A briefing on recent events and shifts across the company’s wider sector, providing context for its outlook. | 7 days |
| Commodities and currencies | ||
| What's New: Asset | A dated briefing on recent events affecting a commodity or currency pair, with context for its current price. | 1 day |
| Asset timeline | A dated sequence of recent events and price moves that shows how a commodity or currency pair developed. | 7 days |
| Asset price drivers | The forces currently moving a commodity or currency pair, with the supply, demand or market events behind them. | 7 days |
| Asset events | Upcoming and recent events that could affect a commodity or currency pair, with their dates and relevance. | 7 days |
| Market | ||
| Market today | The most important developments across regions and asset classes for a current view of the market. Cache only | 1 day |
| Market this week | A briefing on the past week across markets, focused on what changed and why it matters. Cache only | 7 days |
| Weekly market timeline | A dated sequence of the structural shifts that have shaped the market over recent months. Cache only | 8 days |
The Investor plan includes a wallet balance of five euros per billing period, and the Trader plan one of fifteen euros. That balance belongs to the analysis plans and not to the Data API.
Additional balance can be bought independently of any plan, in steps of 10, 25, 50, 100, 200 euros. Top up the wallet
Balance, the split between included and purchased credit, and auto-recharge are all in the account area. Wallet in your account
The balance can also be queried through a dedicated endpoint without consuming request units.
Every call on a research object also counts against your account's daily allowance of request units. Wallet billing comes on top of that allowance rather than in place of it.
Quotes, fundamentals and screener calls continue to run purely on request units and are never charged to the wallet. To the Data API
An unrestricted token, of the kind an ordinary account receives, can call these routes. A token limited to the Data API endpoint groups may be refused before billing takes place.
Reading a stored object costs two cents. Where the piece has to be generated, the provider cost actually incurred is added.
The first call after the freshness window has passed. Every later call on the same object within that window reads the result for two cents.
Failed calls are not billed. Where the wallet is insufficient, the API answers with status 402 and states the amount required and the amount held.
Yes, by setting the maximum age to zero. The three market objects are the exception, since the public route only reads them.
Investor includes five euros per billing period and Trader fifteen. Further credit can be bought in fixed steps.
Provider costs arise in US dollars and are converted to euros at the last close of the EURUSD pair, rounded up.
Yes. Wallet billing is additional to the daily request units and does not replace them.
The Investor and Trader plans carry a wallet balance for each billing period, and access itself needs no more than a free account.
See the plans