---
title: "Get Market By Slug"
method: GET
path: "/v2/markets/by-slug/{slug}"
tags: ["v2 - Markets"]
---

# Get Market By Slug

`GET /v2/markets/by-slug/{slug}`

Get a single market by its slug. Slugs are human-readable identifiers for markets.

## Path parameters

- `slug` string, required

## Query parameters

- `coin` string, required

## Response `200`

Successful Response

- MarketResponse — Single market response.
  - `market_id` string, required
  - `event_id` string, required
  - `slug` string, required
  - `market_type` string, required
  - `start_time` string, date-time, required
  - `end_time` string, date-time, required
  - `{coin}_price_start` number, nullable — Coin price (USD) at market start. Field name depends on the coin queried: btc_price_start, eth_price_start, sol_price_start, etc.
  - `condition_id` string, nullable
  - `clob_token_up` string, nullable
  - `clob_token_down` string, nullable
  - `winner` string, nullable
  - `final_volume` number, nullable
  - `final_liquidity` number, nullable
  - `{coin}_price_end` number, nullable — Coin price (USD) at market end/resolution. Field name depends on the coin queried: btc_price_end, eth_price_end, sol_price_end, etc.
  - `resolved_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `401` — Missing or invalid API key
- `404` — Market not found
- `422` — Validation Error

---

[API](https://skmtc.dev/polybacktest/apis/polybacktest-api.md) · [All operations](https://skmtc.dev/polybacktest/apis/polybacktest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/polybacktest/polybacktest-api/revisions/262c9a5e60e4/schema)