> For the complete documentation index, see [llms.txt](https://docs.42.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.42.space/for-developers/rest-api-alpha/markets/get-price-history.md).

# Get price history

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

## Get price history

> Returns a historical price series for a single outcome token — the last traded price, step-held between trades (built from the outcome's on-chain trades). Two modes:\
> \*\*Duration mode\*\* (default): control the lookback with \`duration\` (bucket size is chosen for you); \`start\_ts\` filters results after fetch.\
> \*\*Range mode\*\* (pass \`interval\`): step-fills buckets at the given interval over the explicit \`\[start\_ts, end\_ts]\` window for zoomable line charts. The first point is anchored from the last trade before \`start\_ts\` (so adjacent windows connect) or, if the outcome had not traded yet, the series begins at its first trade. A window that would exceed \~10k buckets is rejected unless \`changes\_only=true\`.\
> \*\*changes\_only auto mode\*\* (\`changes\_only=true\`): returns the real price change points for the window (\`start\_ts\`/\`end\_ts\`, or \`end\_ts\`−\`duration\` if no \`start\_ts\`); \`interval\` is ignored. Resolution scales with trade density — sparse outcomes return exact change points, very active outcomes read the close price from a pre-aggregated bucket so the chart stays cheap and renderable. Capped at \`fidelity\` else \~1000 points.\
> Use \`fidelity\` in either mode to cap the number of points (downsampled if exceeded).

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/market-data/prices/history","name":"get-price-history"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/market-data/prices/history":{"get":{"description":"Returns a historical price series for a single outcome token — the last traded price, step-held between trades (built from the outcome's on-chain trades). Two modes:\n**Duration mode** (default): control the lookback with `duration` (bucket size is chosen for you); `start_ts` filters results after fetch.\n**Range mode** (pass `interval`): step-fills buckets at the given interval over the explicit `[start_ts, end_ts]` window for zoomable line charts. The first point is anchored from the last trade before `start_ts` (so adjacent windows connect) or, if the outcome had not traded yet, the series begins at its first trade. A window that would exceed ~10k buckets is rejected unless `changes_only=true`.\n**changes_only auto mode** (`changes_only=true`): returns the real price change points for the window (`start_ts`/`end_ts`, or `end_ts`−`duration` if no `start_ts`); `interval` is ignored. Resolution scales with trade density — sparse outcomes return exact change points, very active outcomes read the close price from a pre-aggregated bucket so the chart stays cheap and renderable. Capped at `fidelity` else ~1000 points.\nUse `fidelity` in either mode to cap the number of points (downsampled if exceeded).","tags":["get-price-history"],"summary":"Get price history","parameters":[{"schema":{"type":"string"},"description":"Market contract address","name":"market","in":"query","required":true},{"schema":{"type":"string"},"description":"Outcome token ID (provide token_id or outcome_index, not both)","name":"token_id","in":"query"},{"schema":{"type":"integer"},"description":"Outcome index, 0-based (provide token_id or outcome_index, not both)","name":"outcome_index","in":"query"},{"schema":{"type":"string","enum":["1s","10s","1m","3m","30m","2h","6h","12h","1d"]},"description":"Bucket interval (range mode, changes_only=false). IGNORED when changes_only=true — that mode auto-picks resolution by trade density.","name":"interval","in":"query"},{"schema":{"type":"string","enum":["1h","4h","24h","7d","30d","90d","180d","1y","all"]},"description":"Lookback duration (duration mode, default 24h)","name":"duration","in":"query"},{"schema":{"type":"integer"},"description":"End unix timestamp (default: now)","name":"end_ts","in":"query"},{"schema":{"type":"integer"},"description":"Range mode: window start (required). Duration mode: filters results after fetch.","name":"start_ts","in":"query"},{"schema":{"type":"integer"},"description":"Max data points returned — downsamples if the window contains more","name":"fidelity","in":"query"},{"schema":{"type":"boolean"},"description":"Include the market seed + carried-forward seed price (default false = genuine trades only)","name":"include_seed","in":"query"},{"schema":{"type":"boolean"},"description":"Return only step edges — drop flat gap-filled buckets where price/payout/collateral/minted_quantity are unchanged (default false; for step-rendered charts)","name":"changes_only","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/internal_handler.PriceHistoryResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ft_market-service-v2_pkg_api.ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ft_market-service-v2_pkg_api.ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ft_market-service-v2_pkg_api.ErrorResponse"}}}}}}}},"components":{"schemas":{"internal_handler.PriceHistoryResponse":{"description":"Historical price series.","type":"object","properties":{"history":{"type":"array","items":{"$ref":"#/components/schemas/internal_handler.PriceHistoryPoint"}},"outcomeName":{"type":"string"}}},"internal_handler.PriceHistoryPoint":{"description":"One point on the price line. `p` is the last traded price at/at-or-before","type":"object","properties":{"collateral":{"type":"number"},"mintedQuantity":{"type":"number"},"p":{"type":"number"},"payout":{"type":"number"},"t":{"type":"integer"},"v":{"type":"number"}}},"ft_market-service-v2_pkg_api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.42.space/for-developers/rest-api-alpha/markets/get-price-history.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.