Markets

Fetch a Polymarket market

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.

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

Query parameters

slugstring nullable
idstring nullable

Response

Successful Response

platformstring required

Venue: 'Polymarket' or 'Kalshi'.

identstring nullable

Venue market identifier.

questionstring

Market question/title.

market_urlstring

Canonical market URL.

descriptionstring nullable

Venue-provided background context.

resolution_criteriastring nullable

Complete venue rules used to resolve the market.

outcomestring

Primary outcome (prefers 'Yes').

probabilitynumber nullable

Market-implied probability for outcome (0..1).

close_timestring nullable
created_timestring nullable
volumenumber nullable
liquiditynumber nullable
price_change_24hnumber nullable
price_change_7dnumber nullable
yes_bidnumber nullable
yes_asknumber nullable
last_trade_pricenumber nullable
resolution_sourcestring nullable
no_sub_titlestring nullable
expected_expiration_timestring nullable
floor_strikeunknown
cap_strikeunknown
categorystring nullable
fetched_atstring nullable

ISO 8601 UTC time this quote was actually fetched from the venue (not when it was served from cache).

series_tickerstring nullable

Kalshi series ticker -- the 'extra' id /market/batch needs for candlesticks.

token_idstring nullable

Polymarket YES-outcome CLOB token id -- the 'extra' id /market/batch needs for order book/price history.

Example response

{
  "venue_news_articles": [
    {
      "publish_date": "2025-01-15T10:30:00Z",
      "relevance_score": 0.91,
      "source": "Reuters",
      "summary": "Federal Reserve officials signaled a more cautious approach to rate cuts...",
      "title": "Fed signals rate cuts may slow in 2025",
      "url": "https://reuters.com/example"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.