⚡API Quick start

Calling a public endpoint

To dive right in you can start by trying a call to one of Paradex's public endpoints, GET /markets :

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": "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"
    }
  ]
}

Interacting with private endpoint

To interact with private Paradex endpoints you need to onboard and generate a JSON Web Token (JWT) before making API requests. JWTs are a secure way to transmit information between parties. Please refer to the Authentication chapter and onboarding and authentication code samples.