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, 24h volume, and net per-side funding rates.
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_priceOracle price of the index token.
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": 305.91999999999996,
      "open_interest_long_usd": 60.5675166,
      "open_interest_short_usd": 60.61823235,
      "funding_rate_long": 0.000004211206918812,
      "funding_rate_short": -0.000004233591400608,
      "volume_24h_usd": 0,
      "fees_24h_usd": 0,
      "liquidations_24h_usd": 0
    },
    {
      "market": "AAVE-PERP",
      "market_variant": "AAVE/USD[WSOL-USDC]",
      "index_price": 86.10711047,
      "open_interest_long_usd": 107311.39996617615,
      "open_interest_short_usd": 118648.65095459098,
      "funding_rate_long": 0.000102739726027368,
      "funding_rate_short": -0.000210251798037324,
      "volume_24h_usd": 335994.6335087792,
      "fees_24h_usd": 32.846233524593,
      "liquidations_24h_usd": 8203.667422928855
    }
  ]
}