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 curl -X GET https://api.prod.paradex.trade/v1/markets \
2 -H 'Accept: application/json'

Try it

Response

1 {
2   "results": [
3     {
4       "asset_kind": "PERP",
5       "base_currency": "ETH",
6       "clamp_rate": "0.05",
7       "delta1_cross_margin_params": {
8         "imf_base": "0.11",
9         "imf_factor": "0",
10         "imf_shift": "0",
11         "mmf_factor": "0.51"
12       },
13       "expiry_at": 0,
14       "fee_config": {
15         "api_fee": {
16           "maker_fee": {
17             "fee": "0.0003",
18             "fee_cap": "0.5",
19             "fee_floor": "-0.5"
20           },
21           "taker_fee": {
22             "fee": "0.0003",
23             "fee_cap": "0.5",
24             "fee_floor": "-0.5"
25           }
26         },
27         "interactive_fee": {
28           "maker_fee": {
29             "fee": "0.0003",
30             "fee_cap": "0.5",
31             "fee_floor": "-0.5"
32           },
33           "taker_fee": {
34             "fee": "0.0003",
35             "fee_cap": "0.5",
36             "fee_floor": "-0.5"
37           }
38         },
39         "rpi_fee": {
40           "maker_fee": {
41             "fee": "0.0003",
42             "fee_cap": "0.5",
43             "fee_floor": "-0.5"
44           },
45           "taker_fee": {
46             "fee": "0.0003",
47             "fee_cap": "0.5",
48             "fee_floor": "-0.5"
49           }
50         }
51       },
52       "funding_multiplier": 1,
53       "funding_period_hours": 8,
54       "interest_rate": "0.01",
55       "iv_bands_width": "0.05",
56       "market_kind": "cross",
57       "max_funding_rate": "0.05",
58       "max_funding_rate_change": "0.0005",
59       "max_open_orders": 100,
60       "max_order_size": "100",
61       "max_slippage": "0.05",
62       "max_tob_spread": "0.2",
63       "min_notional": "3",
64       "open_at": 0,
65       "option_cross_margin_params": {
66         "imf": {
67           "long_itm": "0.2",
68           "premium_multiplier": "1.2",
69           "short_itm": "0.4",
70           "short_otm": "0.25",
71           "short_put_cap": "0.5"
72         },
73         "mmf": {
74           "long_itm": "0.2",
75           "premium_multiplier": "1.2",
76           "short_itm": "0.4",
77           "short_otm": "0.25",
78           "short_put_cap": "0.5"
79         }
80       },
81       "option_type": "PUT",
82       "oracle_ewma_factor": "0.2",
83       "order_size_increment": "0.001",
84       "position_limit": "500",
85       "price_bands_width": "0.05",
86       "price_feed_id": "GVXRSBjFk6e6J3NbVPXohDJetcTjaeeuykUpbQF8UoMU",
87       "price_tick_size": "0.01",
88       "quote_currency": "USD",
89       "settlement_currency": "USDC",
90       "strike_price": "66500",
91       "symbol": "ETH-USD-PERP",
92       "tags": [
93         "MEME",
94         "DEFI"
95       ],
96       "trading_mode": "STANDARD"
97     }
98   ]
99 }

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.