---
title: "List Markets"
method: GET
path: "/v2/markets"
tags: ["v2 - Markets"]
---

# List Markets

`GET /v2/markets`

List all markets with pagination.

Returns markets sorted by start_time descending (newest first).

## Query parameters

- `coin` 'btc' | 'eth' | 'sol', required
- `limit` integer
- `offset` integer
- `market_type` '5m' | '15m' | '1hr' | '4hr' | '24hr', nullable
- `resolved` boolean, nullable
- `start_time` string
- `end_time` string

## Response `200`

Successful Response

- MarketsListResponse — Paginated markets list response.
  - `markets` object[], required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `401` — Missing or invalid API key
- `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)