---
title: "tool si.economics.estimate"
description: "`EstimateReturnInput`: the buyer (an entity, a lead, a buyer profile or a session), the offering or tier, the stated numbers, and whether to simulate: a `Card` whose body is a `FrameOfASale`."
section: reference
address: /reference/tools/si-economics-estimate
contract: 0476e35e6e275db5
---

# tool si.economics.estimate

`EstimateReturnInput`: the buyer (an entity, a lead, a buyer profile or a session), the offering or tier, the stated numbers, and whether to simulate: a `Card` whose body is a `FrameOfASale`.

[figure: Over MCP, si.economics.estimate takes EstimateReturnInput and returns a card whose body is SaleFrame.]

a `Card` whose body is a `FrameOfASale`. The call needs the read grant at the tenant rung.



| | |
|---|---|
| input | [EstimateReturnInput](/concepts/estimatereturninput) |
| result | a card whose body is [SaleFrame](/concepts/saleframe) |
| read-only | no |
| destructive | no |
| card address | `ui://scale-intelligence/cards/SaleFrame` |
| HTTP route | [`/v1/economics/estimate`](/reference/economics/estimate) |





| field | type | required | note |
|---|---|---|---|
| `buyer` | [UnitRef](/concepts/unitref) | yes |  |
| `offering` | `id` | no |  |
| `tier` | `text` | no |  |
| `stated` | `{text:json}` | no | driver name to value, each written as a stated number before the estimate reads it |
| `simulate` | `bool` | yes |  |