System

Get system config

Get clearing and settlement layer config for Paradex

GEThttps://api.testnet.paradex.trade/v1/system/config

Response

200

OK

Body

application/json

block_explorer_urlstring

Block explorer URL for the current SN Instance

Example: "https://voyager.testnet.paradex.trade/"

bridged_tokensarray of responses.BridgedToken (object)

bridged tokens config https://github.com/starknet-io/starknet-addresses/blob/master/bridged_tokens/goerli.json

environmentstring

Environment of the Paradex Instance

Example: "local"

l1_chain_idstring

L1 chain ID value

Example: "5"

l1_core_contract_addressstring

Address of Starknet L1 core contract

Example: 1.3808396443829842e+47

l1_operator_addressstring

Address of Starknet L1 operator

Example: 5.703501238865533e+47

liquidation_feestring

Liquidation fee

Example: "0.20"

oracle_addressstring

Oracle contract address

Example: 2.0290180119637593e+75

paraclear_account_hashstring

Class hash of the account contract

Example: 1.4491781619450885e+75

paraclear_account_proxy_hashstring

Proxy hash of the account contract

Example: 1.5036749696184303e+75

paraclear_addressstring

Paraclear contract address

Example: 1.9851506026724947e+75

paraclear_decimalsinteger

partial_liquidation_bufferstring

Partial liquidation buffer. Account value is supposed to be at least this much above the MMR after partial liquidation

Example: "0.2"

partial_liquidation_share_incrementstring

Minimum granularity of partial liquidation share. The share is rounded up to the nearest multiple of this value

Example: "0.05"

starknet_chain_idstring

Chain ID for the Starknet Instance

Example: "SN_CHAIN_ID"

starknet_fullnode_rpc_urlstring

Full node RPC URL from Starknet

Example: "https://pathfinder.api.testnet.paradex.trade/rpc/v0_7"

starknet_gateway_urlstring

Feeder Gateway URL from Starknet

Example: "https://potc-testnet-02.starknet.io"

universal_deployer_addressstring

Universal deployer address

Example: 1.7839735895099262e+47

Request

JavaScriptCurlPython

const response = await fetch('https://api.testnet.paradex.trade/v1/system/config', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "block_explorer_url": "https://voyager.testnet.paradex.trade/",
  "bridged_tokens": [
    {
      "l1_bridge_address": "text",
      "l1_token_address": "text",
      "l2_bridge_address": "text",
      "l2_token_address": "text",
      "name": "text",
      "symbol": "text"
    }
  ],
  "environment": "local",
  "l1_chain_id": "5",
  "l1_core_contract_address": 1.3808396443829842e+47,
  "l1_operator_address": 5.703501238865533e+47,
  "liquidation_fee": "0.20",
  "oracle_address": 2.0290180119637593e+75,
  "paraclear_account_hash": 1.4491781619450885e+75,
  "paraclear_account_proxy_hash": 1.5036749696184303e+75,
  "paraclear_address": 1.9851506026724947e+75,
  "partial_liquidation_buffer": "0.2",
  "partial_liquidation_share_increment": "0.05",
  "starknet_chain_id": "SN_CHAIN_ID",
  "starknet_fullnode_rpc_url": "https://pathfinder.api.testnet.paradex.trade/rpc/v0_7",
  "starknet_gateway_url": "https://potc-testnet-02.starknet.io",
  "universal_deployer_address": 1.7839735895099262e+47
}

Get system state

Get the current state of the Paradex system

GEThttps://api.testnet.paradex.trade/v1/system/state

Response

200

OK

Body

application/json

statusall of

Status of the system

Example: "ok"

Request

JavaScriptCurlPython

const response = await fetch('https://api.testnet.paradex.trade/v1/system/state', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "status": "ok"
}

Get system time (unix milliseconds)

Get the current time in the Paradex

GEThttps://api.testnet.paradex.trade/v1/system/time

Response

200

OK

Body

application/json

server_timestring

Paradex Server time

Example: "1681493415023"

Request

JavaScriptCurlPython

const response = await fetch('https://api.testnet.paradex.trade/v1/system/time', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "server_time": "1681493415023"
}