Markets

Get market bbo

Get the best bid/ask for the given market

GEThttps://api.testnet.paradex.trade/v1/bbo/{market}

Path parameters

market*string

Market symbol - ex: BTC-USD-PERP

Response

200400

OK

Body

application/json

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

JavaScriptCurlPython

const response = await fetch('https://api.testnet.paradex.trade/v1/bbo/{market}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "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.testnet.paradex.trade/v1/funding/data

Query parameters

Response

200400

OK

Body

application/json

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

JavaScriptCurlPython

const response = await fetch('https://api.testnet.paradex.trade/v1/funding/data?market=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "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.testnet.paradex.trade/v1/markets

Query parameters

Response

200404

OK

Body

application/json

resultsarray of responses.MarketResp (object)

List of available active markets

Request

JavaScriptCurlPython

const response = await fetch('https://api.testnet.paradex.trade/v1/markets', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200404

{
  "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": "0",
        "imf_shift": "0",
        "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,
      "option_type": "PUT",
      "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",
      "strike_price": "66500",
      "symbol": "ETH-USD-PERP"
    }
  ]
}

OHLCV for a symbol

Klines for a symbol

GEThttps://api.testnet.paradex.trade/v1/markets/klines

Query parameters

Response

400

Bad Request

Body

application/json

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

JavaScriptCurlPython

const response = await fetch('https://api.testnet.paradex.trade/v1/markets/klines?resolution=text&symbol=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

400

{
  "error": "NOT_ONBOARDED",
  "message": "User has never called /onboarding endpoint"
}

List available markets summary

Get markets dynamic data component

GEThttps://api.testnet.paradex.trade/v1/markets/summary

Query parameters

Response

200400

OK

Body

application/json

resultsarray of responses.MarketSummaryResp (object)

List of market summaries

Request

JavaScriptCurlPython

const response = await fetch('https://api.testnet.paradex.trade/v1/markets/summary?market=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "results": [
    {
      "ask": "30130.15",
      "ask_iv": "0.2",
      "bid": "30112.22",
      "bid_iv": "0.2",
      "delta": "1",
      "funding_rate": "0.3",
      "last_iv": "0.2",
      "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.testnet.paradex.trade/v1/orderbook/{market}

Path parameters

market*string

Market symbol - ex: BTC-USD-PERP

Query parameters

Response

200400

OK

Body

application/json

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

JavaScriptCurlPython

const response = await fetch('https://api.testnet.paradex.trade/v1/orderbook/{market}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "asks": [
    [
      "text"
    ]
  ],
  "bids": [
    [
      "text"
    ]
  ],
  "last_updated_at": 1681462770114,
  "market": "ETH-USD-PERP",
  "seq_no": 20784
}