MCP Paradex Server

Get global Paradex system configuration. Retrieves the current system-wide configuration parameters from Paradex, including trading limits, fee schedules, and other global settings. This information is useful for understanding the current operating parameters of the exchange. Returns: Dict[str, Any]: Global Paradex system configuration with the following structure: - exchange (str): Exchange name ("Paradex") - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current environment (mainnet/testnet) - status (str): Current system status ("operational", "maintenance", etc.) - features (List[str]): Available trading features - trading_hours (str): Trading availability - website (str): Exchange website URL - documentation (str): Documentation URL - [Additional system parameters from Paradex API] If an error occurs, returns error information.

Get the current Paradex server time. Retrieves the current server time from Paradex. This is important for time-sensitive operations like trading, as local time might differ from the exchange's server time. Using the exchange time ensures accurate timestamp coordination for orders and other time-dependent operations. Returns: Dict[str, Any]: Current server time information with the following structure: - server_time (int): Current server time in milliseconds since epoch - iso_time (str): ISO-formatted timestamp If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

Get the current Paradex system operational state. Retrieves the current operational state of the Paradex exchange, including information about system health, maintenance status, and any active alerts or notices. This is useful for checking if the exchange is fully operational before executing trades. Returns: Dict[str, Any]: Current system state information with the following structure: - status (str): Overall system status ("operational", "degraded", "maintenance", etc.) - components (Dict): Status of individual system components - maintenance (Dict, optional): Information about ongoing or scheduled maintenance - notices (List, optional): System-wide notices or alerts If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

Get a list of available vaults from Paradex. Retrieves all available vaults on Paradex, including their addresses and names. This tool requires no parameters and returns a comprehensive list of all vaults that can be accessed on Paradex. Returns: Dict[str, Any]: List of available vaults with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - vaults (List[Dict]): List of vault objects with address and name - count (int): Total number of vaults If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - vaults (List): Empty list - count (int): 0

Get detailed information about a specific vault. Retrieves comprehensive details about a specific vault identified by its address, including configuration, permissions, and other vault-specific parameters. Returns: Dict[str, Any]: Detailed vault information with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - vaults (List[Dict]): List containing the vault details - count (int): Number of vaults returned (should be 1) If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - vaults (List): Empty list - count (int): 0

Get global configuration for vaults from Paradex. Retrieves system-wide configuration parameters for vaults on Paradex, including fee structures, limits, and other global settings that apply to all vaults on the platform. Returns: Dict[str, Any]: Global vault configuration with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - config (Dict): Global vault configuration parameters If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - config (None): Null value for config

Get the current balance of a specific vault. Retrieves the current balance information for a specific vault, including available funds, locked funds, and total balance. This is essential for understanding the financial state of a vault before executing trades or withdrawals. Returns: Dict[str, Any]: Balance information for the vault, including: - available (float): Available balance that can be used for trading - locked (float): Balance locked in open orders or positions - total (float): Total balance (available + locked) - currency (str): Currency of the balance (e.g., "USDC") If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - balance (None): Null value for balance

Get a comprehensive summary of a specific vault. Retrieves a summary of all important information about a vault, including balance, positions, recent activity, and performance metrics. This provides a high-level overview of the vault's current state. Returns: Dict[str, Any]: Summary information for the vault, including: - balance (Dict): Current balance information - positions (List): Current open positions - performance (Dict): Performance metrics - recent_activity (List): Recent transactions or trades If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - summary (None): Null value for summary

Get a list of deposit and withdrawal transfers for a specific vault. Retrieves the history of all transfers (deposits and withdrawals) for a vault, including timestamps, amounts, transaction hashes, and status information. This is useful for auditing vault activity and tracking fund movements. Returns: Dict[str, Any]: List of transfers for the vault, each containing: - id (str): Transfer ID - type (str): "DEPOSIT" or "WITHDRAWAL" - amount (float): Transfer amount - currency (str): Currency of the transfer - timestamp (str): When the transfer occurred - status (str): Status of the transfer (e.g., "COMPLETED", "PENDING") - transaction_hash (str): Blockchain transaction hash If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - transfers (None): Null value for transfers

Get a list of current trading positions for a specific vault. Retrieves all open trading positions for a vault, including market, size, entry price, liquidation price, unrealized PnL, and other position-specific information. Returns: Dict[str, Any]: List of positions for the vault, each containing: - market_id (str): Market identifier (e.g., "ETH-PERP") - side (str): Position side ("LONG" or "SHORT") - size (float): Position size - entry_price (float): Average entry price - mark_price (float): Current mark price - liquidation_price (float): Price at which position would be liquidated - unrealized_pnl (float): Unrealized profit/loss - leverage (float): Current leverage If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - positions (None): Null value for positions

Get a summary of trading account information for a specific vault. Retrieves a comprehensive summary of the trading account associated with a vault, including margin information, account health, risk metrics, and trading statistics. Returns: Dict[str, Any]: Account summary information, including: - margin_ratio (float): Current margin ratio - account_health (float): Account health percentage - total_equity (float): Total account equity - available_margin (float): Available margin for new positions - used_margin (float): Margin currently in use - unrealized_pnl (float): Total unrealized profit/loss - realized_pnl_24h (float): Realized profit/loss in the last 24 hours - open_orders_count (int): Number of open orders - positions_count (int): Number of open positions If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - account_summary (None): Null value for account summary

Get a list of available markets from Paradex. Retrieves all available trading markets/pairs from the Paradex exchange. This tool requires no parameters and returns a comprehensive list of all markets that can be traded on Paradex. Returns: Dict[str, Any]: List of available markets with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - markets (List[str]): List of market symbols - count (int): Total number of markets

Get detailed information about a specific market. Retrieves comprehensive details about a specific market, including base and quote assets, tick size, minimum order size, and other trading parameters. Returns: Dict[str, Any]: Detailed market information with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - details (Dict): Detailed market information including trading parameters - error (str, optional): Error message if request failed

Get a summary of market statistics and current state. Retrieves current market summary information including price, volume, 24h change, and other key market metrics. Returns: Dict[str, Any]: Market summary information including: - Current price - 24h high/low - 24h volume - Price change percentage - Other market statistics If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - summary (None): Null value for summary

Get historical funding rate data for a perpetual market. Retrieves funding rate history for a specified time period, which is essential for understanding the cost of holding perpetual positions. Returns: Dict[str, Any]: Historical funding rate data with timestamps. If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - funding_data (None): Null value for funding data

Get the Best Bid and Offer (BBO) for a market. Retrieves the current best bid and best offer (ask) prices and sizes for a specified market. This represents the tightest spread currently available. Returns: Dict[str, Any]: Best bid and offer information including: - bid price and size - ask price and size - timestamp If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

Get the current orderbook for a market. Retrieves the current state of the orderbook for a specified market, showing bid and ask orders up to the requested depth. Returns: Dict[str, Any]: Orderbook data including: - bids: List of [price, size] pairs - asks: List of [price, size] pairs - timestamp If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - orderbook (None): Null value for orderbook

Get candlestick (kline) data for a market. Retrieves historical price candlestick data for a specified market and time period. Each candlestick contains open, high, low, close prices and volume information. Returns: Dict[str, Any]: Candlestick data with the following structure for each candle: - timestamp - open price - high price - low price - close price - volume If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

Get recent trades for a market. Retrieves historical trade data for a specified market and time period. Each trade includes price, size, side (buy/sell), and timestamp information. Returns: Dict[str, Any]: List of trades with the following structure for each trade: - id: Trade ID - price: Execution price - size: Trade size - side: "buy" or "sell" - timestamp: Time of execution If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message

Get account summary. Returns: Dict[str, Any]: Account summary.

Get account positions. Returns: Dict[str, Any]: Account positions.

Get account fills. Returns: Dict: Account fills.

Get account funding payments. Returns: Dict[str, Any]: Account funding payments.

Get account open orders. Returns: Dict[str, Any]: Account orders.

Create a new order. Returns: Dict[str, Any]: Created order details.

Cancel an order. Returns: Dict[str, Any]: Cancelled order details.

Cancel all orders.

Get order status. Returns: Dict[str, Any]: Order details.