---
title: "List Polymarket predictions"
method: GET
path: "/polymarket/predictions"
tags: ["Polymarket"]
---

# List Polymarket predictions

`GET /polymarket/predictions`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/polymarket/predictions`
- Auth: API key in header `x-api-key`

Returns event rows for the Polymarket `/predictions` page. The `status` enum accepts `active`, `resolved`, and `all`; the `sort` enum accepts `competitive`, `volume`, `volume_24hr`, `ending_soon`, `liquidity`, `newest`, and `closed_time`; the `recurrence` enum accepts `hourly`, `daily`, `weekly`, `monthly`, and `yearly`.

## Query parameters

- `status` 'active' | 'resolved' | 'all'
- `sort` 'competitive' | 'volume' | 'volume_24hr' | 'ending_soon' | 'liquidity' | 'newest' | 'closed_time'
- `tag` string
- `recurrence` 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly'
- `limit` integer
- `cursor` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PolymarketPredictionsResponseDoc
  - `code` integer
  - `data` PolymarketPredictionsResponse
    - `cursor` string: Cursor that was used to fetch this page.
    - `events` PolymarketEventSummary[]: Events on this page, one item per event.
      - `active` boolean: `true` when the event is active.
      - `closed` boolean: `true` when the event is closed.
      - `comment_count` integer: Number of comments on the event.
      - `description` string: Event description as shown on Polymarket.
      - `end_date` string: Date and time the event is scheduled to end (ISO 8601).
      - `featured` boolean: `true` when Polymarket features the event.
      - `icon_url` string: URL of the event's icon image.
      - `id` string: Polymarket event id.
      - `image_url` string: URL of the event's main image.
      - `liquidity` number: Liquidity Polymarket reports for the event.
      - `markets` PolymarketMarketSummary[]: Markets inside the event, one item per market.
        - `active` boolean: `true` when the market is active.
        - `best_ask` number: Lowest ask price currently offered on the market.
        - `best_bid` number: Highest bid price currently offered on the market.
        - `closed` boolean: `true` when the market is closed.
        - `condition_id` string: Condition id that identifies the market on Polymarket.
        - `end_date` string: Date and time the market is scheduled to end (ISO 8601).
        - `id` string: Polymarket market id.
        - `last_trade_price` number: Price of the most recent trade on the market.
        - `liquidity` number: Liquidity Polymarket reports for the market.
        - `outcomes` PolymarketOutcomePricePoint[]: Outcomes of the market with their current prices, one item per outcome.
          - `best_ask` number: Lowest ask price currently offered for the outcome.
          - `best_bid` number: Highest bid price currently offered for the outcome.
          - `last_trade_price` number: Price of the most recent trade on the outcome.
          - `liquidity` number: Liquidity Polymarket reports for the outcome.
          - `market_id` string: Polymarket id of the market the outcome belongs to.
          - `market_slug` string: URL slug of the market the outcome belongs to.
          - `outcome` string: Name of the outcome, for example `Yes`.
          - `price` number: Current price of the outcome.
          - `question` string: Question of the market the outcome belongs to.
          - `volume` number: Trading volume Polymarket reports for the outcome.
        - `question` string: Question the market asks, for example `Will Spain win the 2026 FIFA World Cup?`.
        - `slug` string: URL slug of the market.
        - `token_ids` string[]: Token ids of the market outcomes, in the same order as `outcomes`.
        - `url` string: Link to the market on polymarket.com.
        - `volume` number: Total trading volume of the market.
        - `volume_24h` number: Trading volume of the market over the last 24 hours.
      - `markets_count` integer: Number of markets inside the event.
      - `open_interest` number: Open interest Polymarket reports for the event.
      - `restricted` boolean: `true` when Polymarket marks the event as restricted.
      - `slug` string: URL slug of the event.
      - `start_date` string: Date and time the event starts (ISO 8601).
      - `tags` PolymarketTagSummary[]: Tags attached to the event, one item per tag.
        - `id` string: Polymarket tag id.
        - `label` string: Display name of the tag, for example `Crypto`.
        - `slug` string: URL slug of the tag, for example `crypto`.
      - `title` string: Event title as shown on Polymarket.
      - `updated_at` string: Time Polymarket last updated the event (ISO 8601).
      - `url` string: Link to the event on polymarket.com.
      - `volume` number: Total trading volume of the event.
      - `volume_24h` number: Trading volume of the event over the last 24 hours.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `has_more` boolean: `true` when more events are available after this page.
    - `limit` integer: Maximum number of events requested.
    - `next_cursor` string: Cursor to pass to fetch the next page.
    - `recurrence` string: Recurrence filter applied: `hourly`, `daily`, `weekly`, `monthly` or `yearly`.
    - `sort` string: Sort order applied, for example `competitive`.
    - `source_url` string: URL the data was read from.
    - `status` string: Prediction status filter applied: `active`, `resolved` or `all`.
    - `tag` string: Polymarket tag slug the events were filtered by.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

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