Markets

Get markets data

get

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

Query parameters

offsetstringOptional

Offset for pagination

Example: 0

pagestringOptional

Page number for pagination

Example: 1

pageSizestringOptional

Page size (items per page)

Example: 50

enginestringOptional

Filter by engine type

Example: hyperliquid

minVolumestringOptional

Filter by minimum volume

Example: 1000000

change24hstringOptional

Filter by price change

Example: 5

netFundingstringOptional

Filter by either positive or negative funding rate

Example: positive

searchTextstringOptional

Search text to filter markets

Example: BTC

sortstringOptional

Sort field and direction (e.g., volume:desc)

Example: volume:desc

excludeTextstringOptional

Text to exclude from results

Example: USDT

activestringOptional

Filter by active status

Example: true

Responses

200

Successfully retrieved markets data

application/json

totalnumberRequired

Total number of markets (after filters)

pagenumberRequired

Page number for pagination

pageSizenumberRequired

Page size (items per page)

totalPagesnumberRequired

Total number of pages

400

Bad request - Invalid query parameters

get

/markets

HTTPcURLJavaScriptPython

GET /markets HTTP/1.1
Host: hl-v2.pearprotocol.io
Accept: */*

{
  "markets": [
    {
      "longAssets": [
        {
          "asset": "HYPE",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "shortAssets": [
        {
          "asset": "IMX",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "openInterest": "100000",
      "volume": "100000",
      "ratio": "1.2345",
      "prevRatio": "1.1000",
      "change24h": "0.12",
      "weightedRatio": "1.2100",
      "weightedPrevRatio": "1.0800",
      "weightedChange24h": "0.12",
      "netFunding": "0.00015"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 1
}

Get active market assets and pairs

get

Responses

200

Market data retrieved successfully

application/json

get

/markets/active

HTTPcURLJavaScriptPython

GET /markets/active HTTP/1.1
Host: hl-v2.pearprotocol.io
Accept: */*

200

Market data retrieved successfully

{
  "active": [
    {
      "key": "L:BTC|S:ETH",
      "longAssets": [
        {
          "asset": "HYPE",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "shortAssets": [
        {
          "asset": "IMX",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "openInterest": "100000",
      "volume": "100000",
      "ratio": "1.2345",
      "prevRatio": "1.1000",
      "change24h": "0.12",
      "weightedRatio": "1.2100",
      "weightedPrevRatio": "1.0800",
      "weightedChange24h": "0.12",
      "netFunding": "0.00015"
    }
  ],
  "topGainers": [
    {
      "key": "L:BTC|S:ETH",
      "longAssets": [
        {
          "asset": "HYPE",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "shortAssets": [
        {
          "asset": "IMX",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "openInterest": "100000",
      "volume": "100000",
      "ratio": "1.2345",
      "prevRatio": "1.1000",
      "change24h": "0.12",
      "weightedRatio": "1.2100",
      "weightedPrevRatio": "1.0800",
      "weightedChange24h": "0.12",
      "netFunding": "0.00015"
    }
  ],
  "topLosers": [
    {
      "key": "L:BTC|S:ETH",
      "longAssets": [
        {
          "asset": "HYPE",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "shortAssets": [
        {
          "asset": "IMX",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "openInterest": "100000",
      "volume": "100000",
      "ratio": "1.2345",
      "prevRatio": "1.1000",
      "change24h": "0.12",
      "weightedRatio": "1.2100",
      "weightedPrevRatio": "1.0800",
      "weightedChange24h": "0.12",
      "netFunding": "0.00015"
    }
  ],
  "highlighted": [
    {
      "key": "L:BTC|S:ETH",
      "longAssets": [
        {
          "asset": "HYPE",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "shortAssets": [
        {
          "asset": "IMX",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "openInterest": "100000",
      "volume": "100000",
      "ratio": "1.2345",
      "prevRatio": "1.1000",
      "change24h": "0.12",
      "weightedRatio": "1.2100",
      "weightedPrevRatio": "1.0800",
      "weightedChange24h": "0.12",
      "netFunding": "0.00015"
    }
  ],
  "watchlist": [
    {
      "key": "L:BTC|S:ETH",
      "longAssets": [
        {
          "asset": "HYPE",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "shortAssets": [
        {
          "asset": "IMX",
          "weight": 0.25
        },
        {
          "asset": "ETH",
          "weight": 0.25
        }
      ],
      "openInterest": "100000",
      "volume": "100000",
      "ratio": "1.2345",
      "prevRatio": "1.1000",
      "change24h": "0.12",
      "weightedRatio": "1.2100",
      "weightedPrevRatio": "1.0800",
      "weightedChange24h": "0.12",
      "netFunding": "0.00015"
    }
  ]
}