GET
/
api
/
markets

Overview

The Markets endpoint provides detailed market information for all available trading pairs, including current prices, funding rates, interest rates, and market statistics.

Parameters

address
string

Optional Ethereum address. If not provided, defaults to zero address.

Response Fields

success
boolean

Indicates if the request was successful

timestamp
integer

Current Unix timestamp in milliseconds

marketsCount
integer

Total number of available markets

markets
array

Array of market objects containing:

Notes

  • All rates (funding, borrow, trading fees) are expressed as decimals (e.g., 0.0005 = 0.05%)
  • Prices maintain full precision from the Pyth Network price feeds
  • Market utilization shows the higher percentage between long and short utilization
  • Long/Short ratio defaults to 50/50 when no positions exist
  • All monetary values (open interest, liquidity) are in USD

Example Usage

Example Response

{
  "success": true,
  "timestamp": 1699454789123,
  "marketsCount": 57,
  "markets": [
    {
      "assetId": "1",
      "pair": "BTC/USD",
      "price": "75964.03651450",
      "fundingRate": 0.0001234,
      "borrowRateForLong": 0.0050,
      "borrowRateForShort": 0.0025,
      "longOpenInterest": 125.50,
      "shortOpenInterest": 100.20,
      "maxLongOpenInterest": 1000.00,
      "maxShortOpenInterest": 1000.00,
      "longTradingFee": 0.0005,
      "shortTradingFee": 0.0005,
      "utilization": 12.55,
      "longShortRatio": {
        "longPercentage": 55.61,
        "shortPercentage": 44.39
      },
      "availableLiquidity": {
        "long": 874.50,
        "short": 899.80
      }
    }
  ]
}

Query Parameters

address
string

Ethereum address (optional)

Response

200 - application/json
success
boolean

Indicates if the request was successful

timestamp
integer

Current Unix timestamp in milliseconds

marketsCount
integer

Total number of available markets

markets
object[]

Array of market data