---
title: "MarketParticipant"
description: "one party of a market in one role on one stock of a vertical's chain, with its buying behaviour and its impact on the other roles; placed by a person, by the placement method of the library, or by a template"
section: concepts
address: /concepts/marketparticipant
contract: 0476e35e6e275db5
---

# MarketParticipant

one party of a market in one role on one stock of a vertical's chain, with its buying behaviour and its impact on the other roles; placed by a person, by the placement method of the library, or by a template

[figure: MarketParticipant is a definition at brand scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | definition |
| scope | brand |
| key | the party, the role and the vertical, versioned |
| store | postgres |
| family | market |



## Fields


| field | type | required | note |
|---|---|---|---|
| `vertical` | `id` | yes |  |
| `segment` | `id` | no |  |
| `stock` | `text` | yes | the chain stock it sits on, by name |
| `party` | `id` | yes | an entity the record holds |
| `party_kind` | `one of company \| brand \| person \| account \| community \| organisation` | yes |  |
| `role` | [RoleAroundADecision](/concepts/rolearoundadecision) | yes |  |
| `side` | `one of demand \| supply \| intermediary \| influence \| rules` | yes |  |
| `behaviour` | [BuyingBehaviour](/concepts/buyingbehaviour) | no | absent until read |
| `impact_on` | [ParticipantImpact](/concepts/participantimpact) | yes |  |
| `placed_by` | `one of a person \| the placement method \| a template` | yes |  |
| `evidence` | [EvidenceRef](/concepts/evidenceref) | yes |  |
| `version` | `count` | yes |  |
| `content_hash` | `hash` | yes |  |
| `state` | [Readiness](/concepts/readiness) | yes | not ready without evidence or with a role the vertical does not name |



## Routes that use it
- [`/v1/act/place_participant`](/reference/act/place_participant) returns it