gamma_get_market_by_slug
Retrieve a single market's details using its unique slug. Ideal after identifying the correct market through search, providing precise market data.
Instructions
Fetch one canonical market by its slug.
Use this tool when you already know the exact market slug and want the clearest single-market lookup. This is the preferred tool after a search step has identified the correct market.
Do not use this tool for broad discovery across a topic; use
search_public or list_markets first in that case. The slug should
be the market slug string from the Polymarket URL path, not the full URL.
This tool is often followed by CLOB book or price lookups if you want live market state, or by event lookup if you want the parent event context.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Canonical market slug from a Polymarket market URL. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| market | Yes | Normalized Polymarket market model. Args: id: Optional upstream market identifier. slug: Canonical market slug from Polymarket URLs. question: Human-readable market question text. active: Whether the market is currently active. closed: Whether the market is closed. liquidity: Reported liquidity value when present. volume: Reported volume value when present. event_slug: Parent event slug when known. clob_token_ids: Associated CLOB token identifiers, if available. Returns: Market: Normalized market model. Raises: ValueError: If validation fails. Examples: >>> market = Market(slug="fed-decision", question="Will the Fed cut?") >>> market.slug 'fed-decision' |