# getMarket

**Identifier:** `polymarket_getMarket`

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

Fetch one specific Polymarket market by slug or id, with current odds. Use it when the market is already known (from searchMarkets or getEvent) instead of searching again. Provide exactly one of marketSlug or marketId.

## Run it with the CLI

```bash
kirha tools run polymarket_getMarket \
  --input '{}'
```

`--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_getMarket",
  "input": {}
}'
```

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": {
    "marketId": {
      "description": "From searchMarkets or getEvent",
      "type": "string"
    },
    "marketSlug": {
      "description": "From searchMarkets or getEvent",
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "market": {
      "additionalProperties": false,
      "properties": {
        "closed": {
          "type": "boolean"
        },
        "description": {
          "description": "Resolution rules",
          "type": "string"
        },
        "endDate": {
          "type": "string"
        },
        "eventSlug": {
          "description": "Input for getEvent",
          "type": "string"
        },
        "groupItemTitle": {
          "description": "Short label distinguishing this market from siblings in the same event",
          "type": "string"
        },
        "liquidity": {
          "type": "number"
        },
        "marketId": {
          "type": "string"
        },
        "marketSlug": {
          "description": "Input for getMarket and getMarketPriceHistory",
          "type": "string"
        },
        "openInterest": {
          "type": "number"
        },
        "outcomePrices": {
          "description": "Probability per outcome (0-1), same order as outcomes",
          "items": {
            "type": "number"
          },
          "type": "array"
        },
        "outcomes": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "question": {
          "type": "string"
        },
        "volume": {
          "type": "number"
        },
        "volume24hr": {
          "type": "number"
        }
      },
      "required": [
        "marketId",
        "marketSlug",
        "question",
        "closed",
        "outcomes",
        "outcomePrices"
      ],
      "type": "object"
    }
  },
  "required": [
    "context",
    "market"
  ],
  "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)
- [`getMarketPriceHistory`](https://kirha.com/providers/polymarket/getMarketPriceHistory.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)