---
title: "Fetch a Polymarket market"
method: GET
path: "/markets/polymarket"
tags: ["Markets"]
---

# Fetch a Polymarket market

`GET /markets/polymarket`

## Request

- Base URL: `https://foresea.ink` (the document declares no server; this is the origin it was published from)
- URL: `https://foresea.ink/markets/polymarket`
- Auth: none declared

Fetch a live Polymarket quote by market `slug` (or numeric `id`).

The result is normalised so `probability` can be passed to `/predict` as
`market_probability` (with `market_platform="Polymarket"`) to compute an edge.

## Query parameters

- `slug` string, nullable
- `id` string, nullable

## Response `200`

Successful Response

- MarketQuote: A live prediction-market quote, normalised for use with `/predict`.
  - `platform` string, required: Venue: 'Polymarket' or 'Kalshi'.
  - `ident` string, nullable: Venue market identifier.
  - `question` string: Market question/title.
  - `market_url` string: Canonical market URL.
  - `description` string, nullable: Venue-provided background context.
  - `resolution_criteria` string, nullable: Complete venue rules used to resolve the market.
  - `venue_news_articles` NewsArticle[]: Articles supplied by the prediction-market venue.
    - `title` string, nullable: Article headline.
    - `summary` string, nullable: Short human-written summary.
    - `summary_llm` string, nullable: LLM-generated summary.
    - `text` string, nullable: Full article body text.
    - `source` string, nullable: Publisher name (e.g. Reuters).
    - `credibility` object, nullable: Credibility score breakdown.
    - `frs` object, nullable: Future-Resolution Statement metadata.
    - `url` string, nullable: Canonical article URL.
    - `authors` unknown
    - `publish_date` string, nullable: ISO 8601 publish timestamp.
    - `keywords` unknown
    - `relevance_score` number, nullable: Cosine similarity to the question (0–1).
    - `search_query` string, nullable: Query used to retrieve this article.
  - `outcome` string: Primary outcome (prefers 'Yes').
  - `probability` number, nullable: Market-implied probability for `outcome` (0..1).
  - `outcomes` MarketOption[]: All outcomes with their probabilities.
    - `label` string, required: Outcome label, e.g. 'Yes' or 'No'.
    - `probability` number, nullable: Market-implied probability (0..1), or null when unpriced.
  - `close_time` string, nullable
  - `created_time` string, nullable
  - `volume` number, nullable
  - `liquidity` number, nullable
  - `price_change_24h` number, nullable
  - `price_change_7d` number, nullable
  - `yes_bid` number, nullable
  - `yes_ask` number, nullable
  - `last_trade_price` number, nullable
  - `resolution_source` string, nullable
  - `no_sub_title` string, nullable
  - `expected_expiration_time` string, nullable
  - `floor_strike` unknown
  - `cap_strike` unknown
  - `category` string, nullable
  - `fetched_at` string, nullable: ISO 8601 UTC time this quote was actually fetched from the venue (not when it was served from cache).
  - `series_ticker` string, nullable: Kalshi series ticker -- the 'extra' id /market/batch needs for candlesticks.
  - `token_id` string, nullable: Polymarket YES-outcome CLOB token id -- the 'extra' id /market/batch needs for order book/price history.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/foresea/apis/foresea-intelligence-api.md) · [All operations](https://skmtc.dev/foresea/apis/foresea-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/foresea/apis/foresea-intelligence-api/revisions/b03e49f4385d?raw)