---
title: "Get market configurations"
method: GET
path: "/v1/markets"
tags: ["Markets"]
---

# Get market configurations

`GET /v1/markets`

Get all market configurations. Results are cached for 5 minutes unless force_refresh is set.

> **Note:** The `available` and `visible` fields were removed. Use `config.unlocked` for lock state and `active` for market visibility.

## Query parameters

- `force_refresh` boolean
- `market_ids` string[]

## Response `200`

A successful response.

- ApiGetMarketsResponse
  - `markets` ApiMarketInfo[] — List of market information.
    - `market_id` string, uint64 — Market ID.
    - `config` ApiMarketConfig
      - `name` string — Market name (e.g., "BTC-PERP").
      - `quote` string — Quote token address (usually USDC).
      - `step_size` string — Minimum order size increment.
      - `step_price` string — Minimum price increment.
      - `maintenance_margin_factor` string — Maintenance margin requirement.
      - `max_leverage` string — Maximum leverage allowed.
      - `min_order_size` string — Minimum order size.
      - `unlocked` boolean — Whether the market is locked.
      - `open_interest_limit` string — Maximum open interest allowed for the market.
    - `base_asset_symbol` string — Base asset symbol (e.g., "BTC").
    - `quote_asset_symbol` string — Quote asset symbol (e.g., "USD").
    - `underlying` string — Underlying asset.
    - `display_name` string — Display name for the market.
    - `quote_volume_24h` string — 24h quote volume.
    - `change_24h` string — 24h price change.
    - `high_24h` string — 24h high price.
    - `low_24h` string — 24h low price.
    - `last_price` string — Last traded price.
    - `mark_price` string — Mark price from oracle.
    - `index_price` string — Index price from oracle.
    - `max_position_size` string — Maximum position size.
    - `open_interest` string — Open interest.
    - `funding_interval` string — Funding interval in nanoseconds.
    - `next_funding_time` string, int64 — Next funding time (Unix nano).
    - `post_only` boolean — Post-only mode enabled.
    - `last_cumulative_funding` string — Deprecated: Use accumulated_funding instead.
    - `predicted_funding_rate` string — Deprecated: Use current_funding_rate instead.
    - `display_base_asset_symbol` string — Display base asset symbol.
    - `accumulated_funding` string — Accumulated funding from the funding rate contract (decimal string, 18 decimals).
    - `current_funding_rate` string — Current funding rate from the funding rate contract (decimal string, 18 decimals).
    - `funding_rate_8h` string — Current funding rate normalized to 8h period (current_funding_rate × 8, decimal string, 18 decimals).
    - `active` boolean — Off-chain active flag. When false the market is disabled off-chain (hidden by FE and its orders rejected by the API), even if it is unlocked on-chain. Defaults to true.
  - `cached_at` string, int64 — Unix timestamp when this data was cached

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rise/apis/risex-rest-api.md) · [All operations](https://skmtc.net/rise/apis/risex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rise/risex-rest-api/revisions/194af8339c0d/schema)