---
title: "Get markets data"
method: GET
path: "/markets"
tags: ["Markets"]
---

# Get markets data

`GET /markets`

Retrieve market groups including active markets, top gainers, top losers, highlighted markets, and watchlist

## Query parameters

- `offset` string
- `page` string
- `pageSize` string
- `engine` string
- `minVolume` string
- `change24h` string
- `netFunding` string
- `searchText` string
- `sort` string
- `excludeText` string
- `active` string

## Response `200`

Successfully retrieved markets data

- MarketsResponse
  - `markets` MarketsGroupItem[], required — List of active order-asset groups
    - `longAssets` PairAssetDto[], required — Distinct long assets in the order group with weights
      - `asset` string, required — Asset symbol
      - `weight` number — Weight allocation for this asset (0.0001 to 1.0). If not provided, weights will be evenly distributed.
    - `shortAssets` PairAssetDto[], required — Distinct short assets in the order group with weights
      - `asset` string, required — Asset symbol
      - `weight` number — Weight allocation for this asset (0.0001 to 1.0). If not provided, weights will be evenly distributed.
    - `openInterest` string, required — Open interest in USD for all assets in this group
    - `volume` string, required — 24h traded volume in USD for this order group
    - `ratio` string — Current long/short ratio for this group
    - `prevRatio` string — Previous day long/short ratio for this group
    - `change24h` string — 24h change as decimal (e.g. 0.05 = +5%)
    - `weightedRatio` string — Weighted (synthetic 50/50) current ratio for this group
    - `weightedPrevRatio` string — Weighted (synthetic 50/50) previous day ratio for this group
    - `weightedChange24h` string — Weighted (synthetic 50/50) 24h change as decimal
    - `netFunding` string, required — Net funding for the basket, weighted by allocation (longs negative, shorts positive)
  - `total` number, required — Total number of markets (after filters)
  - `page` number, required — Page number for pagination
  - `pageSize` number, required — Page size (items per page)
  - `totalPages` number, required — Total number of pages

## Other responses

- `400` — Bad request - Invalid query parameters

---

[API](https://skmtc.dev/pearprotocol/apis/pear-protocol-trading-api.md) · [All operations](https://skmtc.dev/pearprotocol/apis/pear-protocol-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pearprotocol/pear-protocol-trading-api/revisions/d5e1438dfaa7/schema)