Markets

Get market bbo

Get the best bid/ask for the given market

GEThttps://api.prod.paradex.trade/v1/bbo/{market}
Path parameters
market*string

Market symbol - ex: BTC-USD-PERP

Response

OK

Body
askstring

Best ask price

Example: "30130.15"
ask_sizestring

Best ask size

Example: "0.05"
bidstring

Best bid price

Example: "30112.22"
bid_sizestring

Best bid size

Example: "0.04"
last_updated_atinteger

Last update to the orderbook in milliseconds

Example: 1681493939981
marketstring

Symbol of the market

Example: "BTC-USD-PERP"
seq_nointeger

Sequence number of the orderbook

Example: 20784
Request
const response = await fetch('https://api.prod.paradex.trade/v1/bbo/{market}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "ask": "30130.15",
  "ask_size": "0.05",
  "bid": "30112.22",
  "bid_size": "0.04",
  "last_updated_at": 1681493939981,
  "market": "BTC-USD-PERP",
  "seq_no": 20784
}

Funding data history

List historical funding data by market

GEThttps://api.prod.paradex.trade/v1/funding/data
Query parameters
Response

OK

Body
nextstring

The pointer to fetch next set of records (null if there are no records left)

Example: "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N="
prevstring

The pointer to fetch previous set of records (null if there are no records left)

Example: "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD=="
resultsarray of responses.FundingDataResult (object)

Funding Data Response data list

Request
const response = await fetch('https://api.prod.paradex.trade/v1/funding/data', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
  "prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
  "results": [
    {
      "funding_index": "text",
      "funding_premium": "text",
      "funding_rate": "text",
      "market": "text"
    }
  ]
}

List available markets

Get markets static data component

GEThttps://api.prod.paradex.trade/v1/markets
Query parameters
Response

OK

Body
resultsarray of responses.MarketResp (object)

List of available active markets

Request
const response = await fetch('https://api.prod.paradex.trade/v1/markets', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "results": [
    {
      "asset_kind": "PERP",
      "base_currency": "ETH",
      "chain_details": {
        "collateral_address": "0x1234567890",
        "contract_address": "0x1234567890",
        "fee_account_address": "0x1234567890",
        "fee_maker": "0.01",
        "fee_taker": "0.01",
        "insurance_fund_address": "0x1234567890",
        "liquidation_fee": "0.01",
        "oracle_address": "0x1234567890",
        "symbol": "ETH-USD-PERP"
      },
      "clamp_rate": "0.05",
      "delta1_cross_margin_params": {
        "imf_base": "0.11",
        "imf_factor": "8001",
        "imf_shift": "0.00021",
        "mmf_factor": "0.51"
      },
      "expiry_at": 0,
      "interest_rate": "0.01",
      "market_kind": "cross",
      "max_funding_rate": "0.05",
      "max_funding_rate_change": "0.0005",
      "max_open_orders": 100,
      "max_order_size": "100",
      "max_tob_spread": "0.2",
      "min_notional": "10",
      "open_at": 0,
      "oracle_ewma_factor": "0.2",
      "order_size_increment": "0.001",
      "position_limit": "500",
      "price_bands_width": "0.05",
      "price_feed_id": "GVXRSBjFk6e6J3NbVPXohDJetcTjaeeuykUpbQF8UoMU",
      "price_tick_size": "0.01",
      "quote_currency": "USD",
      "settlement_currency": "USDC",
      "symbol": "ETH-USD-PERP"
    }
  ]
}

OHLCV for a symbol

Klines for a symbol

GEThttps://api.prod.paradex.trade/v1/markets/klines
Query parameters
Response

Bad Request

Body
dataany

any additional data related to the error

errorall of

unique immutable string identifier for specific error

Example: "NOT_ONBOARDED"
messagestring

detailed description of error and how to address it

Example: "User has never called /onboarding endpoint"
Request
const response = await fetch('https://api.prod.paradex.trade/v1/markets/klines', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "error": "NOT_ONBOARDED",
  "message": "User has never called /onboarding endpoint"
}

List available markets summary

Get markets dynamic data component

GEThttps://api.prod.paradex.trade/v1/markets/summary
Query parameters
Response

OK

Body
resultsarray of responses.MarketSummaryResp (object)

List of market summaries

Request
const response = await fetch('https://api.prod.paradex.trade/v1/markets/summary', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "results": [
    {
      "ask": "30130.15",
      "bid": "30112.22",
      "funding_rate": "0.3",
      "last_traded_price": "30109.53",
      "mark_price": "29799.70877478",
      "open_interest": "6100048.3",
      "price_change_rate_24h": "0.05",
      "symbol": "BTC-USD-PERP",
      "total_volume": "141341.0424",
      "underlying_price": "29876.3",
      "volume_24h": "47041.0424"
    }
  ]
}

Get market orderbook

Get snapshot of the orderbook for the given market

GEThttps://api.prod.paradex.trade/v1/orderbook/{market}
Path parameters
market*string

Market symbol - ex: BTC-USD-PERP

Query parameters
Response

OK

Body
asksarray of array of string

List of Ask sizes and prices

bidsarray of array of string

List of Bid sizes and prices

last_updated_atinteger

Last update to the orderbook in milliseconds

Example: 1681462770114
marketstring

Market name

Example: "ETH-USD-PERP"
seq_nointeger

Sequence number of the orderbook

Example: 20784
Request
const response = await fetch('https://api.prod.paradex.trade/v1/orderbook/{market}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "asks": [
    [
      "text"
    ]
  ],
  "bids": [
    [
      "text"
    ]
  ],
  "last_updated_at": 1681462770114,
  "market": "ETH-USD-PERP",
  "seq_no": 20784
}
PreviousAuthenticationNextInsurance

Last updated