---
title: "PricingStudy"
description: "one run of the pricing methods over the frames of every buyer profile and the rivals' price claims of a window, with its candidates as a set of options, the decision and its reasons, and the margin check"
section: concepts
address: /concepts/pricingstudy
contract: 0476e35e6e275db5
---

# PricingStudy

one run of the pricing methods over the frames of every buyer profile and the rivals' price claims of a window, with its candidates as a set of options, the decision and its reasons, and the margin check

[figure: PricingStudy is a fact at platform scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | fact |
| scope | platform |
| key | the ladder version it set |
| store | postgres |
| family | market |



## Fields


| field | type | required | note |
|---|---|---|---|
| `ladder_version` | `count` | yes |  |
| `methods` | [Method](/concepts/method) | yes | the methods of the library it ran, at their versions |
| `kinds_of_buyer` | `[id]` | yes |  |
| `window` | [Window](/concepts/window) | yes | the window of the rivals' claims read |
| `anchors` | `[id]` | yes | the rivals' price claims read |
| `frames` | `[id]` | yes | the frames of a sale read, by buyer profile |
| `candidates` | `id` | yes | the set of options document |
| `decision` | `text` | yes | the candidate decided, or none yet |
| `reasons` | `[text]` | yes |  |
| `margin` | [MarginCheck](/concepts/margincheck) | yes |  |
| `bar_set_before_reading` | `bool` | yes | false marks the study as not to be read |



## Routes that use it
- [`/v1/economics/study`](/reference/economics/study) returns it