Polymarket Market Data

Polymarket

Find public Polymarket contracts with prices, outcomes, volume, liquidity and resolution context.

Current price
$0.0014/result
Availability
Ready to run
Last accepted verification

What this API does

Read-only public prediction-market research. This route does not connect a wallet, place orders or provide financial advice.

Agents select this operation with tool ID polymarket.market-data, then inspect its current executable contract before a run.

Public input and output shape

Input

inputobject · required

Provider-specific public source, URL or search criteria.

maxItemsinteger · optional

Maximum number of records to return.

minimum: 10 · maximum: 100

Output

closes_atstring

Returned closes at value.

event_idstring

Returned event id value.

event_titlestring

Returned event title value.

lifecyclestring

Returned lifecycle value.

liquiditynumber

Returned liquidity value.

market_idstring

Returned market id value.

opens_atstring

Returned opens at value.

outcomesarray

Returned outcomes value.

questionstring

Returned question value.

resolution_rulesstring

Returned resolution rules value.

resolution_sourcenull

Returned resolution source value.

resolution_statusnull

Returned resolution status value.

resolved_atnull

Returned resolved at value.

restrictedboolean

Returned restricted value.

retrieved_atstring

Returned retrieved at value.

sourcestring

Returned source value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "polymarket.market-data",
  "input": {
    "input": {
      "limit": 10,
      "sortBy": "volume_24hr",
      "status": "active",
      "queries": [
        "bitcoin"
      ],
      "frequency": "all"
    },
    "maxItems": 10
  }
}

Output

{
  "source": "polymarket",
  "volume": 944626.7971589998,
  "event_id": "780132",
  "opens_at": "2026-08-01T05:07:39Z",
  "outcomes": [
    {
      "name": "Yes",
      "price": 0.0045
    },
    {
      "name": "No",
      "price": 0.9955
    }
  ],
  "question": "Will Bitcoin reach $100,000 in August?",
  "closes_at": "2026-09-01T04:00:00Z",
  "lifecycle": "active",
  "liquidity": 1332033.13328,
  "market_id": "3257332",
  "restricted": true,
  "source_url": "https://polymarket.com/event/what-price-will-bitcoin-hit-in-august-2026",
  "volume_24h": 3254671.3857919998,
  "event_title": "What price will Bitcoin hit in August?",
  "resolved_at": null,
  "retrieved_at": "2026-08-20T12:09:33.000Z",
  "resolution_rules": "This market will immediately resolve to \"Yes\" if any Binance 1 minute candle for BTC/USDT during the month specified in the title (from 00:00 AM ET on the first day to 11:59 PM ET on the last), has a final High price equal to or greater than the price specified in the title. Otherwise, this market will resolve to \"No.\" The resolution source for this market is Binance, specifically the BTC/USDT High prices available at https://www.binance.com/en/trade/BTC_USDT, with the chart settings on \"1m\" for one-minute candles selected on the top bar. Please note that the outcome of this market depends solely on the price data from the Binance BTC/USDT trading pair. Prices from other exchanges, different trading pairs, or spot markets will not be considered for the resolution of this market.",
  "resolution_source": null,
  "resolution_status": null,
  "source_updated_at": "2026-08-20T12:07:20.689141Z"
}
Teaching errors and limitations

No listing-specific teaching errors are published. Inspect the tool before running to receive the current schema and error guidance.

Updated
21 August 2026

Use Polymarket Market Data with Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.