Markets

Retrieve All Markets Info

Use this endpoint to fetch information about all available markets, including trading pairs, status, and configuration details.

GET https://perps-api-mainnet.polynomial.finance/markets

Headers

Name
Value

Content-Type

application/json

Accept

application/json

x-api-key

Backend API key(optional)

Response

[
  {
    "chainId": 8008,
    "markets": [
      {
        "marketId": "100",
        "symbol": "ETH",
        "skew": "-816032563610058179",
        "price": 2751.21510528,
        "currentOI": "171613599036410749027",
        "currentFundingRate": "398350812914667",
        "currentFundingVelocity": "-73442930724900",
        "makerFeeRatio": "200000000000000",
        "takerFeeRatio": "500000000000000",
        "skewScale": "100000000000000000000000",
        "maxMarketSize": "890600000000000000000",
        "maxMarketValue": "2440000000000000000000000",
        "tradesCount24h": 179,
        "tradesVolume24h": 1424621.5226680883,
        "price24HrAgo": 2762.8500625,
        "longOI": "85398783236400345424.00",
        "shortOI": "86214815800010403603.00",
        "currentSkew": "-816032563610058179",
        "positiveSkew": "49.76",
        "negativeSkew": "50.24",
        "availableLiquidityLong": "2205049577587482924536081",
        "availableLiquidityShort": "2202804496472078570026277",
        "currentFundingRate1HInPercentage": "1659795053811113",
        "currentFundingRate8HInPercentage": "13278360430488900",
        "currentFundingRate1YInPercentage": "14539804671385345500",
        "currentInterestRate1HInPercentage": "0",
        "currentInterestRate8HInPercentage": "0",
        "currentInterestRate1YInPercentage": "0",
        "netLongFundingRate1HInPercentage": "-1659795053811113",
        "netLongFundingRate8HInPercentage": "-13278360430488900",
        "netLongFundingRate1YInPercentage": "-14539804671385345500",
        "netShortFundingRate1HInPercentage": "1659795053811113",
        "netShortFundingRate8HInPercentage": "13278360430488900",
        "netShortFundingRate1YInPercentage": "14539804671385345500"
      }
      ...
    ]
  }
]

Retrieve Single Market Info

Use this endpoint to fetch information about a particular market.

GET https://perps-api-mainnet.polynomial.finance/markets/<market_id>?chainId=<chain_id>

Headers

Name
Value

Content-Type

application/json

Accept

application/json

x-api-key

Backend API key(optional)

market_id

You can find market id from markets api response. Retrieve All Markets Info

chain_id

8008 (mainnet) Addresses

Response

{
  "marketId": "100",
  "symbol": "ETH",
  "skew": "45546282374751452350",
  "price": 2424.36710185,
  "currentOI": "71301371035630763614",
  "currentFundingRate": "-62676311217304",
  "currentFundingVelocity": "4099165413727626",
  "makerFeeRatio": "200000000000000",
  "takerFeeRatio": "500000000000000",
  "skewScale": "100000000000000000000000",
  "maxMarketSize": "998240000000000000000",
  "maxMarketValue": "2440000000000000000000000",
  "tradesCount24h": 199,
  "tradesVolume24h": 1488494.92316207,
  "price24HrAgo": 2418.4,
  "longOI": "58423826705191107982.00",
  "shortOI": "12877544330439655632.00",
  "currentSkew": "45546282374751452350",
  "positiveSkew": "81.94",
  "negativeSkew": "18.06",
  "availableLiquidityLong": "2278459412322493199191288",
  "availableLiquidityShort": "2388880320923411113339136",
  "currentFundingRate1HInPercentage": "-261151296738767",
  "currentFundingRate8HInPercentage": "-2089210373910133",
  "currentFundingRate1YInPercentage": "-2287685359431596000",
  "currentInterestRate1HInPercentage": "0",
  "currentInterestRate8HInPercentage": "0",
  "currentInterestRate1YInPercentage": "0",
  "netLongFundingRate1HInPercentage": "261151296738767",
  "netLongFundingRate8HInPercentage": "2089210373910133",
  "netLongFundingRate1YInPercentage": "2287685359431596000",
  "netShortFundingRate1HInPercentage": "-261151296738767",
  "netShortFundingRate8HInPercentage": "-2089210373910133",
  "netShortFundingRate1YInPercentage": "-2287685359431596000"
}

Response Fields

Variable
Description

marketId

Unique identifier for the market

symbol

Trading symbol of the asset

skew

Current market skew (imbalance between long and short open interest). 18 decimals

price

Current Index price of the asset

currentOI

Total current Open Interest. 18 decimals

currentFundingRate

Current funding rate. Details

currentFundingVelocity

Rate of change of the funding rate. Details

makerFeeRatio

Fee ratio applied to makers

takerFeeRatio

Fee ratio applied to takers

skewScale

Scale used to normalize market skew. Usage example

maxMarketSize

Maximum allowed open interest for this market. 18 decimals

maxMarketValue

Maximum notional value allowed in the market

tradesCount24h

Number of trades in the last 24 hours

tradesVolume24h

Trading volume in the last 24 hours

price24HrAgo

Price of the asset 24 hours ago

longOI

Open interest held by long positions. 18 decimals

shortOI

Open interest held by short positions. 18 decimals

currentSkew

Skew between long and short open interest

positiveSkew

Percentage of long positions

negativeSkew

Percentage of short positions

availableLiquidityLong

Available liquidity for opening long positions

availableLiquidityShort

Available liquidity for opening short positions

currentFundingRate1HInPercentage

Funding rate over the last 1 hour. 18 decimals

currentFundingRate8HInPercentage

Funding rate over the last 8 hours. 18 decimals

currentFundingRate1YInPercentage

Funding rate over the last year. 18 decimals

currentInterestRate1HInPercentage

0

currentInterestRate8HInPercentage

0

currentInterestRate1YInPercentage

0

netLongFundingRate1HInPercentage

Net funding rate paid by longs over 1 hour. 18 decimals

netLongFundingRate8HInPercentage

Net funding rate paid by longs over 8 hours. 18 decimals

netLongFundingRate1YInPercentage

Net funding rate paid by longs over 1 year. 18 decimals

netShortFundingRate1HInPercentage

Net funding rate received by shorts over 1 hour. 18 decimals

netShortFundingRate8HInPercentage

Net funding rate received by shorts over 8 hours. 18 decimals

netShortFundingRate1YInPercentage

Net funding rate received by shorts over 1 year. 18 decimals

Last updated

Was this helpful?