---
title: "Market detail"
method: GET
path: "/v1/markets/{slug}"
tags: ["Markets"]
---

# Market detail

`GET /v1/markets/{slug}`

## Request

- Base URL: `https://crowdintel.xyz/api`
- URL: `https://crowdintel.xyz/api/v1/markets/{slug}`
- Auth: HTTP bearer

**Min tier: `free`.** Market detail — aggregate stats, top YES/NO holders, recent price history, and resolution outcome.

## Path parameters

- `slug` string, required

## Response `200`

Market detail.

- MarketDetail
  - `slug` string
  - `title` string, nullable
  - `category` string, nullable
  - `condition_id` string, nullable
  - `resolved_outcome` string, nullable
  - `stats` object
  - `top_yes_holders` object[]
  - `top_no_holders` object[]
  - `price_history` object[]

## Other responses

- `400`: Malformed parameters or a rejected guardrail (e.g. unfiltered trades query, cluster blowup, window > 90 days).
- `401`: Missing, invalid, or revoked API key. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `403`: Key valid but its tier is below this endpoint's minimum. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `404`: The requested resource was not found.
- `429`: Hourly or monthly rate limit exceeded.

---

[API](https://skmtc.dev/crowdintel/apis/crowdintel-api.md) · [All operations](https://skmtc.dev/crowdintel/apis/crowdintel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crowdintel/apis/crowdintel-api/revisions/7059cfe9320d?raw)