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.testnet.paradex.trade/v1/markets \
2 -H 'Accept: application/json'

Response

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

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.