Skip to main content
GET
/
polymarket
/
market
/
slug
/
{slug}
Get market by slug
curl --request GET \
  --url https://api.struct.to/v1/polymarket/market/slug/{slug}
{
  "condition_id": "<string>",
  "status": "<string>",
  "id": "<string>",
  "market_slug": "<string>",
  "question": "<string>",
  "title": "<string>",
  "description": "<string>",
  "image_url": "<string>",
  "oracle": "<string>",
  "created_time": 123,
  "start_time": 123,
  "game_start_time": 123,
  "closed_time": 123,
  "end_time": 123,
  "accepting_orders": true,
  "uma_resolution_status": "<string>",
  "is_neg_risk": true,
  "market_maker_address": "<string>",
  "creator": "<string>",
  "category": "<string>",
  "volume_usd": 123,
  "liquidity_usd": 123,
  "highest_probability": 123,
  "total_holders": 123,
  "winning_outcome": {
    "name": "",
    "price": null,
    "position_id": null,
    "outcome_index": null
  },
  "outcomes": [
    {
      "name": "",
      "price": null,
      "position_id": null,
      "outcome_index": null
    }
  ],
  "rewards": [
    {
      "min_size": null,
      "max_spread": null,
      "daily_rate": null
    }
  ],
  "clob_rewards": [
    {
      "id": "<string>",
      "condition_id": "<string>",
      "asset_address": "<string>",
      "rewards_amount": 123,
      "rewards_daily_rate": 123,
      "start_date": "<string>",
      "end_date": "<string>"
    }
  ],
  "tags": [
    "<string>"
  ],
  "event_slug": "<string>",
  "resolution_source": "<string>",
  "metrics": {},
  "relevance_score": 123
}

Path Parameters

slug
string
required

Market slug (e.g. will-trump-win)

Query Parameters

include_tags
boolean

Include tags array (default: true)

include_event
boolean

Include event object (default: true)

include_metrics
boolean

Include all timeframe metrics (default: true)

ai
boolean

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

Response

Market with metadata, outcomes, tags, event, and metrics

Formatted market response with structured metrics, tags, outcomes, and event

condition_id
string
required
status
string
required
id
string | null
market_slug
string | null
question
string | null
title
string | null
description
string | null
image_url
string | null
oracle
string | null
created_time
integer<int64> | null
start_time
integer<int64> | null
game_start_time
integer<int64> | null
closed_time
integer<int64> | null
end_time
integer<int64> | null
accepting_orders
boolean | null
uma_resolution_status
string | null
is_neg_risk
boolean | null
market_maker_address
string | null
creator
string | null
category
string | null
volume_usd
number<double> | null
liquidity_usd
number<double> | null
highest_probability
number<double> | null
total_holders
integer<int64> | null
winning_outcome
object

Outcome for market API responses

outcomes
object[]
rewards
object[]
clob_rewards
object[]
tags
string[]
event_slug
string | null
resolution_source
string | null
metrics
object
relevance_score
number<double> | null
Last modified on March 17, 2026