GET /v1/markets/slug/:slug

GET /v1/markets/slug/:slug

Look up a market by its Polymarket URL slug. Returns full metadata, all token IDs, and outcome prices.

Path Parameters

Parameter	Type	Description
slug	string	The market’s URL slug (e.g. “bitcoin-100k-2026”)

Request

curl -s https://polynode.dev/v1/markets/slug/bitcoin-100k-2026 \
  -H "x-api-key: pn_live_YOUR_KEY"

Response

{
  "condition_id": "0xabc123...",
  "question": "Will Bitcoin hit $100K in 2026?",
  "slug": "bitcoin-100k-2026",
  "outcomes": ["Yes", "No"],
  "end_date": "2026-12-31T23:59:59Z",
  "category": "Crypto",
  "market_type": "binary",
  "active": true,
  "closed": false,
  "image": "https://polymarket.com/images/bitcoin.png",
  "icon": "https://polymarket.com/icons/crypto.png",
  "neg_risk": false,
  "created_at": "2026-01-15T10:30:00Z",
  "liquidity": 125430.50,
  "volume": 892341.25,
  "description": "This market resolves to Yes if...",
  "event_slug": "crypto-price-predictions",
  "event_title": "Crypto Price Predictions",
  "group_item_title": "Bitcoin $100K",
  "outcome_prices": {
    "Yes": 0.72,
    "No": 0.28
  },
  "tokens": [
    {
      "token_id": "21742633...",
      "last_price": 0.72,
      "volume_24h": 48293.50,
      "trade_count_24h": 342,
      "last_trade_at": 1709136045000,
      "best_bid": 0.71,
      "best_ask": 0.73,
      "spread": 0.02,
      "mid_price": 0.72
    },
    {
      "token_id": "98765432...",
      "last_price": 0.28,
      "volume_24h": 12045.00,
      "trade_count_24h": 156,
      "last_trade_at": 1709136040000,
      "best_bid": 0.27,
      "best_ask": 0.29,
      "spread": 0.02,
      "mid_price": 0.28
    }
  ]
}

Response Fields

Field	Type	Description
condition_id	string	CTF condition identifier
question	string	Market question
slug	string	URL slug
outcomes	string[]	Outcome labels
active	boolean	Whether the market is accepting orders
closed	boolean	Whether the market has resolved
outcome_prices	object	Map of outcome name to mid price
tokens	object[]	Array of token data with prices and orderbook
event_slug	string	Parent event slug
event_title	string	Parent event title
group_item_title	string	Title within the event group

Errors

Status	Description
404	No market found with that slug