---
title: "Get per-event price history"
method: GET
path: "/api/v1/market-data/prices/event-history"
tags: ["get-event-price-history"]
---

# Get per-event price history

`GET /api/v1/market-data/prices/event-history`

## Request

- Base URL: `https://rest.ft.42.space`
- URL: `https://rest.ft.42.space/api/v1/market-data/prices/event-history`
- Auth: none declared
- TypeScript: <https://skmtc.dev/42/apis/fortytwo-read-api/docs/api/v1/market-data/prices/event-history/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns one row per onchain event that touched the outcome (mint/redeem/etc), from the outcome_stats hypertable. Unlike /prices/history this is NOT bucketed or gap-filled — each point reflects the marginal price and collateral immediately after a specific event, so the chart can plot per-trade resolution for short windows. Use `start_ts`/`end_ts` to bound the window (required for `start_ts` since the hypertable can be large); use `fidelity` to downsample if the window contains more events than you want to render. Events before the outcome's first real trade are omitted — the market "seed" mint carries a distorted bootstrap price (not a real traded price), and that price is carried forward until the outcome is first traded, so the series opens on a genuine price.

## Query parameters

- `market` string, required
- `token_id` string
- `outcome_index` integer
- `start_ts` integer, required
- `end_ts` integer
- `fidelity` integer

## Response `200`

OK

- InternalHandlerEventPriceHistoryResponse
  - `history` InternalHandlerEventPricePoint[]
    - `collateral` number
    - `mintedQuantity` number
    - `p` number
    - `payout` number
    - `t` integer
  - `outcomeName` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/42/apis/fortytwo-read-api.md) - [All operations](https://skmtc.dev/42/apis/fortytwo-read-api/llms.txt) - [OpenAPI document](https://skmtc.dev/42/apis/fortytwo-read-api/revisions/660740bda403?raw)
