curl --request GET \
--url https://api.rook.pm/v1/fair-values \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.rook.pm/v1/fair-values"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.rook.pm/v1/fair-values', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"fair_value_id": "fv_rates_cut_desk",
"scope_id": "rates_desk",
"outcome_id": "out_fed_dec_2026_cut_yes",
"market_version": "1",
"value_type": "PROBABILITY",
"probability_event": "FULL_PAYOUT",
"value": "0.46",
"source": "rates-desk-model-v3",
"observed_at": "2026-10-19T11:45:00Z",
"valid_until": "2026-10-19T18:00:00Z",
"updated_at": "2026-10-19T12:00:00Z",
"revision": "1",
"status": "CURRENT"
}
],
"next_page_token": null,
"snapshot_id": "snap_rates_20261019_120000",
"as_of": "2026-10-19T12:00:00Z"
}List fair values
Future extension. Read your saved estimates in an authorized private scope_id. Optionally filter by outcome IDs, value type or update time; follow next_page_token with unchanged filters.
Each record retains its outcome/market version, source, observation and expiry times, revision and stale/superseded status. A rule amendment does not silently transfer an estimate to new settlement terms. Estimates stay private to the authenticated customer and scope; explicitly select any values used by future analytics.
curl --request GET \
--url https://api.rook.pm/v1/fair-values \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.rook.pm/v1/fair-values"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.rook.pm/v1/fair-values', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"fair_value_id": "fv_rates_cut_desk",
"scope_id": "rates_desk",
"outcome_id": "out_fed_dec_2026_cut_yes",
"market_version": "1",
"value_type": "PROBABILITY",
"probability_event": "FULL_PAYOUT",
"value": "0.46",
"source": "rates-desk-model-v3",
"observed_at": "2026-10-19T11:45:00Z",
"valid_until": "2026-10-19T18:00:00Z",
"updated_at": "2026-10-19T12:00:00Z",
"revision": "1",
"status": "CURRENT"
}
],
"next_page_token": null,
"snapshot_id": "snap_rates_20261019_120000",
"as_of": "2026-10-19T12:00:00Z"
}Authorizations
Proposed server-to-server API key. No client request HMAC signing scheme is specified.
Headers
Caller correlation reference; not an idempotency guarantee.
Query Parameters
Your authorized private book or strategy namespace; access comes from the API key. Opaque text identifier. Preserve its exact value.
1Only return estimates for these Rook outcome IDs. Repeat the parameter for multiple outcomes.
1Opaque text identifier. Preserve its exact value.
1Filter customer estimates to PROBABILITY or EXPECTED_PAYOUT; these values have different units and meanings.
PROBABILITY, EXPECTED_PAYOUT Only saved estimates updated at or after this UTC timestamp.
Requested maximum items; service caps disclosed by coverage. Oversize requests fail explicitly.
x >= 1Opaque continuation; reuse the same filters/order. Cursor pins the original snapshot.