> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Perp Pairs

> List all tradable perpetual markets (Gains Network + Lighter).

<Note>
  Only **tradable** markets are returned. Disabled, closed, or delisted markets are filtered out server-side, so anything absent from the response is not tradable — there is no separate "disabled" flag to check.

  For a full walkthrough with code samples, see the [Retrieve All Perp Markets](/cookbooks/retrieve-perp-markets) cookbook.
</Note>

### Query Parameters

<ParamField query="chain" type="string">
  Restrict the result to one chain/venue. Omit to return every chain and DEX in one list. One of: `arbitrum`, `base`, `arbitrum-sepolia`, `lighter`.
</ParamField>

### Response

<ResponseField name="data" type="array">
  Array of tradable perpetual markets.

  <Expandable title="PerpPair Object">
    <ResponseField name="name" type="string">Human-readable `base/quote` label, e.g. `BTC/USD`.</ResponseField>
    <ResponseField name="baseToken" type="string">Base asset symbol, e.g. `BTC`.</ResponseField>
    <ResponseField name="quoteToken" type="string">Quote asset symbol, e.g. `USD`.</ResponseField>
    <ResponseField name="minLeverage" type="number">Minimum allowed leverage.</ResponseField>
    <ResponseField name="maxLeverage" type="number">Maximum allowed leverage (always greater than 0).</ResponseField>
    <ResponseField name="dex" type="string">DEX the market belongs to: `gains` or `lighter`.</ResponseField>
    <ResponseField name="chain" type="string">Chain/venue: `arbitrum`, `base`, `arbitrum-sepolia`, or `lighter`.</ResponseField>
    <ResponseField name="assetClass" type="string">Asset class: `crypto`, `forex`, `stocks`, `indices`, `commodities`, `degen`, or `new`.</ResponseField>
    <ResponseField name="dexMarketId" type="integer">DEX internal market id — Gains `pairIndex` / Lighter `market_id`. Only unique within a `(dex, chain)`.</ResponseField>
    <ResponseField name="socialUrl" type="string">Reserved for a social/info URL. Currently empty.</ResponseField>
    <ResponseField name="pairFullName" type="string">Full name of the market as reported by the DEX.</ResponseField>
    <ResponseField name="percentageChange24h" type="number">24h price change, in percent.</ResponseField>
    <ResponseField name="price" type="number">Latest/mark price in USD (`0` if no price is currently available).</ResponseField>
    <ResponseField name="logo" type="string">Base-asset logo URL, or `null` when unknown.</ResponseField>
  </Expandable>
</ResponseField>
