---
title: "tool si.read.market"
description: "a brand, a segment, the window: the four stages, each with its count, value, basis and coverage, and the silent remainder."
section: reference
address: /reference/tools/si-read-market
contract: 0476e35e6e275db5
---

# tool si.read.market

a brand, a segment, the window: the four stages, each with its count, value, basis and coverage, and the silent remainder.

[figure: Over MCP, si.read.market takes MarketInput and returns a card whose body is Market.]

the four stages, each with its count, value, basis and coverage, and the silent remainder. The call needs the read grant at the brand rung.



| | |
|---|---|
| input | [MarketInput](/concepts/marketinput) |
| result | a card whose body is [Market](/concepts/market) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/Market` |
| HTTP route | [`/v1/read/market`](/reference/read/market) |





| field | type | required | note |
|---|---|---|---|
| `brand` | `id` | yes |  |
| `segment` | `id` | yes |  |
| `window` | [Window](/concepts/window) | yes |  |