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:

List available markets

Get markets static data component

Query parameters

marketstringOptional

Market Name - example: BTC-USD-PERP

GET
/v1/markets
1curl -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.