Skip to content

List Perps Markets

Retrieves every listed perps market with static metadata and live context (mark/mid/oracle price, funding rate, open interest, day volume).

Endpoint

Portfolio API: GET https://ddp.definitive.fi/v2/portfolio/perps/markets

Organization API: Replace /v2/portfolio/ with /v2/organization/portfolios/{portfolioId}/. See Portfolio vs. Organization API.

Examples

const json = await AuthHelpers.signAndSend({
  path: "/v2/portfolio/perps/markets",
  method: "GET",
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET,
});

Response

{
  markets: [
    {
      symbol: "BTC", // bare base symbol — not unique across subvenues
      marketId: "native:BTC", // unique `subvenue:SYMBOL` id — pass as {symbol} on the other perps endpoints
      subvenue: "native", // "native" = core exchange; builder-deployed markets use their own
      szDecimals: 5, // size precision (decimals of the base asset)
      maxLeverage: 40,
      onlyIsolated: false,
      markPrice: "68262",
      midPrice: "68259.5",
      oraclePrice: "68249",
      fundingRate: "0.0000125",
      openInterest: "35.42494",
      dayVolume: "771290.57",
      prevDayPrice: "64765",
    },
    // ...
  ];
}

Prices, funding rate, open interest and volume are decimal strings (null when the venue has no value); szDecimals and maxLeverage are numbers.

Two subvenues can list the same base symbol; marketId is always unique. Use marketId (e.g. native:BTC) as the {symbol} when addressing a market on the other perps endpoints — see Market Symbols.