> For the complete documentation index, see [llms.txt](https://docs.reya.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.reya.xyz/developers/reference/markets-and-assets.md).

# Markets & Assets

## Environment and market availability

Market availability can differ between environments. Discover the markets enabled in your target environment through the API rather than hard-coding a market list.

{% hint style="info" %}
For the metals, oil, equity and ETF perpetuals, see [RWA Markets](/developers/pricing-and-funding/rwa-markets.md): underlyings, Stork feeds, order increments, 24/7 trading and the corporate-action policy.
{% endhint %}

## Discovering markets at runtime

Enumerate the live perp markets and their parameters from the `perpMarketDefinitions` endpoint rather than hard-coding a list — new markets are added over time and per-market parameters can change. Each perp market has a symbol ending in `RUSDPERP` and a [`marketId`](/developers/reference/market-ids.md).

## Public configuration and live values

Use the REST endpoints below with your [environment's base URL](/developers/getting-started/environments.md). These read-only requests do not require a wallet signature. Market definitions provide trading constraints; market summaries provide current calculated values.

| Information                                                     | Public source                                                          | Fields                                                                                                                                         |
| --------------------------------------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Perpetual market identity, order increments and risk parameters | `GET /v2/perpMarketDefinitions`                                        | `symbol`, `marketId`, `minOrderQty`, `qtyStepSize`, `tickSize`, `initialMarginParameter`, `liquidationMarginParameter`, `maxLeverage`, `oiCap` |
| Current perpetual mark price and funding rate                   | `GET /v2/perpMarket/{symbol}/summary` or `GET /v2/perpMarkets/summary` | `markPrice`, `fundingRate`, `updatedAt`, `pricesUpdatedAt`                                                                                     |

For example, retrieve ETH's current summary:

```bash
curl --fail --silent --show-error \
  https://api.reya.xyz/v2/perpMarket/ETHRUSDPERP/summary
```

For streaming updates, use the corresponding market-summary channels in the [WebSocket Info API](/developers/api-reference/websocket-api-reference.md). `fundingRate` is an **hourly percentage**, while `markPrice` is a price in rUSD; see [Funding](/developers/pricing-and-funding/funding.md#what-the-api-reports) and [Mark Price](/developers/pricing-and-funding/mark-price.md#reading-the-mark-price) for interpretation.

API 3.6.2 does **not** expose the full pricing configuration: the impact notional, premium clamp, blending weights, EMA coefficient, funding interest term/clamp/cap, and settlement price-deviation band are not returned by these endpoints. The numerical examples in the pricing guides illustrate the formulas; do not treat them as current settings for every market. Use reported live values and handle order and settlement outcomes explicitly.

## Collateral

The quote / counter currency is **USDC**, structured on-chain as **rUSD** — a wrapped-USDC token (1:1). Balances and fees are denominated in rUSD.

## Open-interest caps

Each market has a **global open-interest cap**, exposed as the **`oiCap`** field on the perp market definition, set by governance and enforced on **every trade** — a trade that would push the market's aggregate OI past the cap is rejected. Key properties:

* It's an **aggregate** cap across **all accounts** in the market — not a per-account or per-position limit.
* It does **not** scale with leverage or position size; margin requirements are the only leverage-related control.
* Read the current `oiCap` per market from the `perpMarketDefinitions` endpoint — values are revised as markets are (re)listed.

There are currently **no per-account position limits**; your size is bounded by your margin and the market's OI cap.