Skip to main content
GET
/
polymarket
/
events
/
{identifier}
Get event by ID or slug
curl --request GET \
  --url https://api.struct.to/v1/polymarket/events/{identifier}
{
  "id": "",
  "event_slug": null,
  "title": null,
  "ticker": null,
  "description": null,
  "resolution_source": null,
  "category": null,
  "image_url": null,
  "market_count": 0,
  "created_time": null,
  "closed_time": null,
  "start_time": null,
  "end_time": null,
  "neg_risk": false,
  "neg_risk_market_id": null,
  "game_status": null,
  "show_market_images": false,
  "status": null,
  "metrics": {
    "1m": {
      "volume": 0,
      "shares_volume": 0,
      "builder_usd_volume": 0,
      "builder_shares_volume": 0,
      "fees": 0,
      "builder_fees": 0,
      "txns": 0,
      "builder_txns": 0,
      "unique_traders": 0,
      "unique_makers": 0,
      "unique_takers": 0,
      "unique_builder_traders": 0
    },
    "5m": {
      "volume": 0,
      "shares_volume": 0,
      "builder_usd_volume": 0,
      "builder_shares_volume": 0,
      "fees": 0,
      "builder_fees": 0,
      "txns": 0,
      "builder_txns": 0,
      "unique_traders": 0,
      "unique_makers": 0,
      "unique_takers": 0,
      "unique_builder_traders": 0
    },
    "30m": {
      "volume": 0,
      "shares_volume": 0,
      "builder_usd_volume": 0,
      "builder_shares_volume": 0,
      "fees": 0,
      "builder_fees": 0,
      "txns": 0,
      "builder_txns": 0,
      "unique_traders": 0,
      "unique_makers": 0,
      "unique_takers": 0,
      "unique_builder_traders": 0
    },
    "1h": {
      "volume": 0,
      "shares_volume": 0,
      "builder_usd_volume": 0,
      "builder_shares_volume": 0,
      "fees": 0,
      "builder_fees": 0,
      "txns": 0,
      "builder_txns": 0,
      "unique_traders": 0,
      "unique_makers": 0,
      "unique_takers": 0,
      "unique_builder_traders": 0
    },
    "6h": {
      "volume": 0,
      "shares_volume": 0,
      "builder_usd_volume": 0,
      "builder_shares_volume": 0,
      "fees": 0,
      "builder_fees": 0,
      "txns": 0,
      "builder_txns": 0,
      "unique_traders": 0,
      "unique_makers": 0,
      "unique_takers": 0,
      "unique_builder_traders": 0
    },
    "24h": {
      "volume": 0,
      "shares_volume": 0,
      "builder_usd_volume": 0,
      "builder_shares_volume": 0,
      "fees": 0,
      "builder_fees": 0,
      "txns": 0,
      "builder_txns": 0,
      "unique_traders": 0,
      "unique_makers": 0,
      "unique_takers": 0,
      "unique_builder_traders": 0
    },
    "7d": {
      "volume": 0,
      "shares_volume": 0,
      "builder_usd_volume": 0,
      "builder_shares_volume": 0,
      "fees": 0,
      "builder_fees": 0,
      "txns": 0,
      "builder_txns": 0,
      "unique_traders": 0,
      "unique_makers": 0,
      "unique_takers": 0,
      "unique_builder_traders": 0
    },
    "30d": {
      "volume": 0,
      "shares_volume": 0,
      "builder_usd_volume": 0,
      "builder_shares_volume": 0,
      "fees": 0,
      "builder_fees": 0,
      "txns": 0,
      "builder_txns": 0,
      "unique_traders": 0,
      "unique_makers": 0,
      "unique_takers": 0,
      "unique_builder_traders": 0
    },
    "lifetime": {
      "volume": 0,
      "shares_volume": 0,
      "builder_usd_volume": 0,
      "builder_shares_volume": 0,
      "fees": 0,
      "builder_fees": 0,
      "txns": 0,
      "builder_txns": 0,
      "unique_traders": 0,
      "unique_makers": 0,
      "unique_takers": 0,
      "unique_builder_traders": 0
    }
  },
  "tags": [
    {
      "id": "",
      "label": "",
      "slug": null,
      "volume_usd": 123,
      "shares_volume": 123,
      "builder_usd_volume": 123,
      "builder_shares_volume": 123,
      "txn_count": 123,
      "builder_txn_count": 123,
      "unique_traders": 123,
      "unique_makers": 123,
      "unique_takers": 123,
      "unique_builder_traders": 123,
      "fees_usd": 123,
      "builder_fees_usd": 123
    }
  ],
  "markets": [
    {
      "condition_id": "",
      "id": null,
      "title": null,
      "question": "",
      "market_slug": "",
      "status": "",
      "created_time": null,
      "end_time": null,
      "volume": null,
      "liquidity_usd": null,
      "volume_24hr": null,
      "image_url": null,
      "market_maker_address": null,
      "creator": null,
      "category": null,
      "accepting_orders": null,
      "uma_resolution_status": null,
      "clob_rewards": [
        {
          "id": "<string>",
          "condition_id": "<string>",
          "asset_address": "<string>",
          "rewards_amount": 123,
          "rewards_daily_rate": 123,
          "start_date": "<string>",
          "end_date": "<string>",
          "rewards_max_spread": 123,
          "rewards_min_size": 123,
          "native_daily_rate": 123,
          "sponsored_daily_rate": 123,
          "total_daily_rate": 123,
          "sponsors_count": 123
        }
      ],
      "outcomes": [
        {
          "name": "<string>",
          "price": 123,
          "position_id": "<string>",
          "outcome_index": 123
        }
      ],
      "winning_outcome": {
        "name": "<string>",
        "price": 123,
        "position_id": "<string>",
        "outcome_index": 123
      }
    }
  ],
  "series": {
    "id": "",
    "slug": null,
    "ticker": null,
    "title": null,
    "description": null,
    "series_type": null,
    "recurrence": null,
    "layout": null,
    "image_url": null,
    "icon_url": null,
    "active": false,
    "closed": false,
    "archived": false,
    "featured": false,
    "restricted": false,
    "pyth_token_id": null,
    "cg_asset_name": null,
    "start_date": null,
    "event_count": 0
  }
}

Path Parameters

identifier
string
required

Event ID or slug

Query Parameters

include_tags
boolean

Include tags array (default: true)

include_markets
boolean

Include markets array with outcomes (default: true)

include_metrics
boolean

Include metrics object with all timeframes (default: true)

ai
boolean

Return truncated response optimized for AI consumers (default: false)

Response

Event with nested tags, markets, and series

A Polymarket event from the Gamma API

id
string
default:""
event_slug
string | null
title
string | null
ticker
string | null
description
string | null
resolution_source
string | null
category
string | null
image_url
string | null
market_count
integer<int32>
default:0
created_time
integer<int64> | null
closed_time
integer<int64> | null
start_time
integer<int64> | null
end_time
integer<int64> | null
neg_risk
boolean
default:false
neg_risk_market_id
string | null
game_status
string | null
show_market_images
boolean
default:false
status
string | null

Event status: "open" or "closed"

metrics
object

Per-timeframe metrics keyed by lookback window. Each timeframe key is optional — present only when data exists for that window.

tags
object[]
markets
object[]
series
object

A Polymarket series from the Gamma API Series are parent groupings above events (e.g., "NBA Season 2024-25")

Last modified on June 17, 2026