---
title: "List markets"
method: GET
path: "/api/v1/markets"
---

# List markets

`GET /api/v1/markets`

List and filter tradeable markets.

## Query parameters

- `venue` string
- `instrument_type` 'perp' | 'spot'
- `base_asset` string
- `quote_asset` string
- `active` boolean
- `limit` integer
- `cursor` string

## Response `200`

A page of markets.

- object
  - `items` MarketInfo[], required
    - `market_id` string, required — Canonical market slug, {venue}:{instrument_type}:{pair}.
    - `venue` string, required
    - `instrument_type` 'perp' | 'spot', required
    - `base_asset` DasidAsset, required
      - `dasid` string, required — Canonical Allium asset id.
      - `symbol` string, required — Venue-native symbol.
    - `quote_asset` DasidAsset, required
      - `dasid` string, required — Canonical Allium asset id.
      - `symbol` string, required — Venue-native symbol.
    - `settlement` string, required — Settlement asset symbol.
    - `active` boolean, required
    - `tick_size` integer, required — Number of price decimals.
    - `contract_size` integer, required — Number of size decimals.
    - `perp` PerpMarketInfo — Perp-specific metadata. Present only when instrument_type is perp.
      - `funding_interval` integer, required — Seconds between funding periods (3600 on Hyperliquid).
      - `max_leverage` integer — Maximum leverage, when available.
  - `cursor` string — Cursor for the next page. Absent when there are no more results.

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)