---
title: "Get equity market by ID"
method: GET
path: "/v3/equity/{symbol}/markets/{market_id}"
tags: ["v3 - Equity"]
---

# Get equity market by ID

`GET /v3/equity/{symbol}/markets/{market_id}`

## Path parameters

- `symbol` 'spx' | 'spx-open' | 'spy' | 'wti' | 'xauusd', required
- `market_id` string, required

## Response `200`

Successful response

- V3EquityMarketResponse
  - `data` V3EquityMarket, required — A daily Up/Down equity prediction market.
    - `market_id` string, required
    - `event_id` string, required
    - `slug` string, required
    - `symbol` string, required — Underlying symbol stored in the row (e.g. 'spx'). May differ from the routing-key path segment when one symbol has multiple session markets (SPX vs SPX-Open).
    - `start_time` string, date-time, required
    - `end_time` string, date-time, required
    - `price_start` number, nullable — Underlying price at market start.
    - `price_end` number, nullable — Underlying price at market end (filled when resolved).
    - `condition_id` string, nullable
    - `clob_token_up` string, nullable
    - `clob_token_down` string, nullable
    - `winner` 'up' | 'down', nullable
    - `final_volume` number, nullable
    - `final_liquidity` number, nullable
    - `resolved_at` string, date-time, nullable
  - `meta` V3Meta, required — Per-response metadata included on every v3 response.
    - `request_id` string, required
    - `timestamp` string, date-time, required

## Other responses

- `401` — Authentication failure
- `402` — Plan upgrade required
- `403` — Symbol not in the caller's plan or fixed 31-day equity history limit exceeded
- `404` — Market not found

---

[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)