Calling a public endpoint

To dive right in you can start by trying a call to one of Paradex’s public endpoints:

List available markets

GET

Get markets static data component

Query parameters

marketstringOptional

Market Name - example: BTC-USD-PERP

GET

/v1/markets

1 import requests
2 headers = {
3   'Accept': 'application/json'
4 }
5 
6 r = requests.get('https://api.prod.paradex.trade/v1/markets', headers = headers)
7 
8 print(r.json())

Response

1 {
2   "results": [
3     {
4       "asset_kind": "PERP",
5       "base_currency": "ETH",
6       "chain_details": {
7         "collateral_address": "0x1234567890",
8         "contract_address": "0x1234567890",
9         "fee_account_address": "0x1234567890",
10         "fee_maker": "0.01",
11         "fee_taker": "0.01",
12         "insurance_fund_address": "0x1234567890",
13         "liquidation_fee": "0.01",
14         "oracle_address": "0x1234567890",
15         "symbol": "ETH-USD-PERP"
16       },
17       "clamp_rate": "0.05",
18       "delta1_cross_margin_params": {
19         "imf_base": "0.11",
20         "imf_factor": "0",
21         "imf_shift": "0",
22         "mmf_factor": "0.51"
23       },
24       "expiry_at": 0,
25       "funding_period_hours": 8,
26       "interest_rate": "0.01",
27       "iv_bands_width": "0.05",
28       "market_kind": "cross",
29       "max_funding_rate": "0.05",
30       "max_funding_rate_change": "0.0005",
31       "max_open_orders": 100,
32       "max_order_size": "100",
33       "max_slippage": "0.05",
34       "max_tob_spread": "0.2",
35       "min_notional": "3",
36       "open_at": 0,
37       "option_cross_margin_params": {
38         "imf": {
39           "long_itm": "0.2",
40           "premium_multiplier": "1.2",
41           "short_itm": "0.4",
42           "short_otm": "0.25",
43           "short_put_cap": "0.5"
44         },
45         "mmf": {
46           "long_itm": "0.2",
47           "premium_multiplier": "1.2",
48           "short_itm": "0.4",
49           "short_otm": "0.25",
50           "short_put_cap": "0.5"
51         }
52       },
53       "option_type": "PUT",
54       "oracle_ewma_factor": "0.2",
55       "order_size_increment": "0.001",
56       "position_limit": "500",
57       "price_bands_width": "0.05",
58       "price_feed_id": "GVXRSBjFk6e6J3NbVPXohDJetcTjaeeuykUpbQF8UoMU",
59       "price_tick_size": "0.01",
60       "quote_currency": "USD",
61       "settlement_currency": "USDC",
62       "strike_price": "66500",
63       "symbol": "ETH-USD-PERP",
64       "tags": [
65         "MEME",
66         "DEFI"
67       ]
68     }
69   ]
70 }

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.