---
title: "Get markets"
method: GET
path: "/metrics/v1/markets"
tags: ["metrics/markets"]
---

# Get markets

`GET /metrics/v1/markets`

Retrieve a list of markets

## Query parameters

- `limit` integer
- `pageSize` integer
- `page` integer
- `exchangeId` string
- `exchangeSlug` string
- `quoteAssetId` string
- `quoteAssetSlug` string
- `baseAssetId` string
- `baseAssetSlug` string
- `volume24hAbove` number, double
- `volume24hBelow` number, double
- `liveness` string
- `activitySince` string

## Response `200`

Default response

- object
  - `data` Market[], required
    - `baseAsset` AssetEntity, required
      - `id` string — Asset UUID
      - `name` string — Asset name
      - `symbol` string — Asset symbol
      - `slug` string — Asset slug
    - `baseAssetSector` string, required
    - `exchange` ExchangeEntity, required — Schema for ExchangeEntity
    - `firstTradeAt` string, date-time, required
    - `id` string, required
    - `isNewMarket` boolean, required
    - `isRecentlyListed` boolean, required
    - `lastTradeAt` string, date-time, required
    - `liveness` string, required
    - `metrics` MarketMetrics, required — Schema for MarketMetrics
    - `network` NetworkEntity — Schema for NetworkEntity
    - `quoteAsset` AssetEntity, required
      - `id` string — Asset UUID
      - `name` string — Asset name
      - `symbol` string — Asset symbol
      - `slug` string — Asset slug
    - `quoteAssetSector` string, required
    - `sectors` string[], required
  - `error` string
  - `metadata` SnapshotListingMetadata — Pagination metadata
    - `page` integer, required — Current page number
    - `pageSize` integer, required — Number of results per page
    - `totalPages` integer, required — Total number of pages
    - `totalRows` integer, required — Total number of rows

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/messari/apis/messari-api-deep-research-v1.md) · [All operations](https://skmtc.net/messari/apis/messari-api-deep-research-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messari/messari-api-deep-research-v1/revisions/af35b9757e14/schema)
