Reference

Markets

Tracked perp markets per protocol, with live price, open interest, and rates.

List markets

GET
The tracked GMTrade market set — identifiers only. Rows are per collateral-pool variant; markets lists the distinct grouped markets other endpoints accept. For price, OI, rates, and volume use /markets/stats.
Headers
x-api-keystringrequired
API key sent in the request header; never accepted as a query parameter.
Response
200
{ data: MarketRef[], markets: string[] }
Response
data
market_variantProtocol-native market variant identifier; null when unavailable.
marketMarket symbol (e.g. SOL-PERP).
marketsDistinct grouped markets across the tracked variants — the keys other endpoints accept via ?market=.
Request
cURL
curl --request GET \
  --url https://api.perpdb.xyz/v1/gmtrade/markets \
  --header 'x-api-key: ak_...'
Example
{
  "data": [
    {
      "market": "AAPL-PERP",
      "market_variant": "AAPL/USD[USDC]"
    },
    {
      "market": "AAVE-PERP",
      "market_variant": "AAVE/USD[WSOL-USDC]"
    }
  ],
  "markets": [
    "AAPL-PERP",
    "AAVE-PERP"
  ]
}

Market stats

GET
GMTrade markets with price, open interest, and 24h volume.
Headers
x-api-keystringrequired
API key sent in the request header; never accepted as a query parameter.
Response
200
{ data: Market[] }
Market
market_variantProtocol-native market variant identifier; null when unavailable.
marketMarket symbol (e.g. SOL-PERP).
index_priceDeprecated (2026-10-25): the venue oracle price quoted as a number; leaves the response when the operator turns the mark-number fields off. Use last_price.
open_interest_long_usdLong open interest (USD notional).
open_interest_short_usdShort open interest (USD notional).
funding_rate_longNet hourly funding rate for long positions. Positive values are received; negative values are paid. Annualize by multiplying by 24 × 365.
funding_rate_shortNet hourly funding rate for short positions. Positive values are received; negative values are paid. Annualize by multiplying by 24 × 365.
volume_24h_usdTraded notional over the trailing 24 hours.
fees_24h_usdTrading fees over the trailing 24 hours; excludes funding and borrowing charges.
liquidations_24h_usdLiquidated notional over the trailing 24 hours.
Request
cURL
curl --request GET \
  --url https://api.perpdb.xyz/v1/gmtrade/markets/stats \
  --header 'x-api-key: ak_...'
Example
{
  "data": [
    {
      "market": "AAPL-PERP",
      "market_variant": "AAPL/USD[USDC]",
      "index_price": 347.73,
      "last_price": 347.631730768668,
      "last_price_ts": "2026-10-23T19:56:17.000Z",
      "last_price_stale": false,
      "mark_source": "gmtrade_tickers",
      "mark_ts": "2026-10-25T01:25:14.107Z",
      "mark_price": 347.73,
      "mark_stale": false,
      "open_interest_long_usd": 60.5675166,
      "open_interest_short_usd": 60.61823235,
      "funding_rate_long": 7.0512096654e-7,
      "funding_rate_short": -7.28506764036e-7,
      "volume_24h_usd": 0,
      "fees_24h_usd": 0,
      "liquidations_24h_usd": 0
    },
    {
      "market": "AAVE-PERP",
      "market_variant": "AAVE/USD[WSOL-USDC]",
      "index_price": 137.1167663831805,
      "last_price": 137.042194673458,
      "last_price_ts": "2026-10-25T01:25:48.000Z",
      "last_price_stale": false,
      "mark_source": "gmtrade_tickers",
      "mark_ts": "2026-10-25T01:25:14.107Z",
      "mark_price": 137.1167663831805,
      "mark_stale": false,
      "open_interest_long_usd": 7679.444828496336,
      "open_interest_short_usd": 56.3210403406424,
      "funding_rate_long": -0.000079608729199896,
      "funding_rate_short": 0.000069149587147668,
      "volume_24h_usd": 83187.55025566994,
      "fees_24h_usd": 16.725488978553237,
      "liquidations_24h_usd": 6241.137949612596
    }
  ]
}