> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entityml.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Look Up Polymarket Slug

> Resolve a Polymarket event slug, market slug, or full Polymarket URL into one or more condition IDs.

## Request

<Note>
  No authentication is required. The alias `GET /api/v1/polymarket/lookup/slug` is also available.
</Note>

### Query Parameters

<ParamField query="slug" type="string" required>
  A Polymarket event slug, market slug, or full Polymarket URL. Full URLs are normalized automatically.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  `true` when a matching event or market is found.
</ResponseField>

<ResponseField name="type" type="string">
  Match type: `event` when the slug resolves to an event with multiple markets, or `market` when it resolves to a single market.
</ResponseField>

<ResponseField name="event_title" type="string">
  Event title or market question returned by the upstream Polymarket lookup.
</ResponseField>

<ResponseField name="markets" type="array">
  Array of matched markets.

  <Expandable title="Market fields">
    <ResponseField name="conditionId" type="string">
      Polymarket condition ID.
    </ResponseField>

    <ResponseField name="question" type="string">
      Market question text.
    </ResponseField>

    <ResponseField name="slug" type="string">
      Market slug.
    </ResponseField>

    <ResponseField name="active" type="boolean">
      Whether the market is marked active upstream.
    </ResponseField>

    <ResponseField name="closed" type="boolean">
      Whether the market is marked closed upstream.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

<CodeGroup>
  ```bash Raw HTTP (cURL) theme={null}
  curl "https://api.entityml.com/api/v1/lookup/slug?slug=will-bitcoin-reach-100k"
  ```

  ```bash Full Polymarket URL theme={null}
  curl "https://api.entityml.com/api/v1/lookup/slug?slug=https://polymarket.com/event/will-bitcoin-reach-100k"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.entityml.com/api/v1/lookup/slug",
      params={"slug": "will-bitcoin-reach-100k"},
      timeout=30,
  )

  print(response.json())
  ```
</CodeGroup>

### Example response

```json theme={null}
{
  "success": true,
  "type": "event",
  "event_title": "Will Bitcoin reach $100k?",
  "markets": [
    {
      "conditionId": "0x1234abcd",
      "question": "Will Bitcoin reach $100k by end of 2026?",
      "slug": "will-bitcoin-reach-100k",
      "active": true,
      "closed": false
    }
  ]
}
```