Skip to main content
GET
/
polymarket
/
market
/
slug
/
{market_slug}
Get market by slug
curl --request GET \
  --url https://api.struct.to/v1/polymarket/market/slug/{market_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,
    "total_daily_rate": 123,
    "winning_outcome": {
      "name": "",
      "price": null,
      "position_id": null,
      "outcome_index": null,
      "latest_block": null,
      "latest_confirmed_at": null
    },
    "outcomes": [
      {
        "name": "",
        "price": null,
        "position_id": null,
        "outcome_index": null,
        "latest_block": null,
        "latest_confirmed_at": 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
      }
    ],
    "tags": [
      "<string>"
    ],
    "event_slug": "<string>",
    "resolution_source": "<string>",
    "metrics": {},
    "relevance_score": 123
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.struct.to/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

market_slug
string
required

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

Query Parameters

condition_ids
string

Comma-separated condition IDs (max 50)

question_ids
string

Comma-separated question IDs (max 50)

market_ids
string

Comma-separated market IDs (max 50)

market_slugs
string

Comma-separated market slugs (max 50)

event_slugs
string

Comma-separated event slugs (max 50)

tags
string

Comma-separated tag filters (max 50)

position_ids
string

Comma-separated position IDs to resolve to markets (max 50)

Search string (3-100 characters)

timeframe
enum<string>

Metrics timeframe (default: 24h)

Available options:
1m,
5m,
30m,
1h,
6h,
24h,
7d,
30d,
lifetime
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

Array of markets with metadata, outcomes, tags, event, and metrics

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
total_daily_rate
number<double> | null
winning_outcome
object

Outcome for market API responses

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