# getMarketPriceHistory

**Identifier:** `polymarket_getMarketPriceHistory`

**Provider:** [Polymarket](https://kirha.com/providers/polymarket.md)

Get the price (probability) history of one Polymarket market outcome over time. Use it to see how odds moved. Take marketSlug from searchMarkets or getEvent.

## Run it with the CLI

```bash
kirha tools run polymarket_getMarketPriceHistory \
  --input '{
    "marketSlug": "<marketSlug>"
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "polymarket_getMarketPriceHistory",
  "input": {
    "marketSlug": "<marketSlug>"
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "interval": {
      "default": "1w",
      "description": "Window AND resolution: a shorter window returns finer points, so 1w gives far more detail than max. Use 1d or 1w to see how odds moved, max only for the coarse daily shape over the market's whole life.",
      "enum": [
        "1d",
        "1w",
        "1m",
        "max"
      ],
      "type": "string"
    },
    "marketSlug": {
      "type": "string"
    },
    "outcome": {
      "description": "e.g. Yes, No. Defaults to the first outcome",
      "type": "string"
    }
  },
  "required": [
    "marketSlug"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "marketSlug": {
      "type": "string"
    },
    "outcome": {
      "type": "string"
    },
    "points": {
      "description": "Chronological, price is a 0-1 probability",
      "items": {
        "additionalProperties": false,
        "properties": {
          "date": {
            "type": "string"
          },
          "price": {
            "type": "number"
          }
        },
        "required": [
          "date",
          "price"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "context",
    "marketSlug",
    "outcome",
    "points"
  ],
  "type": "object"
}
```

## Related tools

Other Polymarket tools that this tool refers to, or that refer to it.

- [`getEvent`](https://kirha.com/providers/polymarket/getEvent.md)
- [`getMarket`](https://kirha.com/providers/polymarket/getMarket.md)
- [`searchMarkets`](https://kirha.com/providers/polymarket/searchMarkets.md)

-----

[All Polymarket tools](https://kirha.com/providers/polymarket.md) · [< Back to tools list](https://kirha.com/tools.md)