Paradex Trading

List block trades or the offers attached to a specific block trade. - Pass nothing (or status/market filters) to list block trades. - Pass `block_trade_id` to list offers submitted against that block. Returns the raw paginated response from the corresponding endpoint.

Submit an offer to an existing block trade as a counterparty. Your offer commits you to filling at the given price/size on the given side. The offer is signed locally and submitted; the initiator may then accept or ignore it.

Cancel pending orders to manage exposure or adjust your trading strategy. Use this tool when you need to: - Remove stale limit orders that are no longer desirable - Quickly reduce market exposure during volatility - Update your order strategy by removing existing orders - Clear your order book before implementing a new strategy - React to changing market conditions by canceling pending orders Order cancellation is a critical risk management function and allows you to quickly adapt to changing market conditions. Example use cases: - Canceling limit orders when your outlook changes - Removing…

Execute trades on Paradex with precise control over all order parameters. Use this tool when you need to: - Enter a new position based on your trading strategy - Set limit orders at specific price levels - Create stop-loss or take-profit orders for risk management - Implement complex trading strategies with conditional orders This is the primary tool for executing your trading decisions on Paradex, with full control over order type, size, price, and execution parameters. Example use cases: - Setting limit orders at key support/resistance levels - Placing stop-limit orders to manage risk on …

Get detailed schema information to build precise data filters. Use this tool when you need to: - Understand exactly what fields are available for filtering - Learn the data types and formats for specific fields - Build complex JMESPath queries with correct syntax - Create sophisticated filtering and sorting expressions Knowing the exact schema helps you construct precise filters that return exactly the data you need, avoiding trial and error. Example use cases: - Learning what fields exist in market data responses - Finding the correct property names for filtering - Understanding data types…

Analyze funding rates for potential funding arbitrage or to understand holding costs. Use this tool when you need to: - Calculate expected funding payments for a position - Find markets with extreme funding rates for potential arbitrage - Understand historical funding patterns for a market - Evaluate the cost of holding a position over time This data is critical for assessing the carrying cost of positions and identifying potential funding arbitrage opportunities. Example use cases: - Finding markets with negative funding for "paid to hold" opportunities - Calculating the funding component …

Generate a Paradex keypair for use as a subkey. The private key is persisted locally and never leaves the machine. Only the public key is returned so the frontend can register it on Paradex on behalf of the agent. Use this tool when you need to: - Provision a new subkey for agent trading - Create a keypair before registering the public key on Paradex Example use cases: - Setting up a new agent with its own trading subkey - Rotating to a fresh subkey for an existing account

Analyze historical price patterns for technical analysis and trading decisions. Use this tool when you need to: - Perform technical analysis on historical price data - Identify support and resistance levels from price history - Calculate indicators like moving averages, RSI, or MACD - Backtest trading strategies on historical data - Visualize price action over specific timeframes Candlestick data is fundamental for most technical analysis and trading decisions, providing structured price and volume information over time. Example use cases: - Identifying chart patterns for potential entries …

Identify the most active or volatile markets and get current market conditions. Use this tool when you need to: - Find the most active markets by volume for liquidity analysis - Discover markets with significant price movements for momentum strategies - Compare current prices across multiple assets - Identify markets with unusual behavior for potential opportunities - Get the best bid/ask (BBO) for a market — the summary includes bid and ask fields - Get the current funding rate — the summary includes funding_rate Retrieves current market summary information including mark price, best bid/as…

Find markets that match your trading criteria or get detailed market specifications. Use this tool when you need to: - Understand exact tick sizes and minimum order sizes before placing trades - Find all markets for a specific asset (e.g., all BTC-based markets) - Compare contract specifications across different markets - Identify markets with specific characteristics for your trading strategy Retrieves comprehensive details about specified markets, including base and quote assets, tick size, minimum order size, and other trading parameters. If "ALL" is specified or no market IDs are provide…

Monitor your active orders to track execution status and manage your trading strategy. Use this tool when you need to: - Check which of your orders are still pending execution - Verify limit order prices and remaining quantities - Determine which orders might need cancellation or modification - Get a complete picture of your current market exposure Keeping track of your open orders is essential for effective order management and avoiding duplicate or conflicting trades. Example use cases: - Checking if your limit orders have been partially filled - Verifying that a recently placed order was…

Check the detailed status of a specific order for execution monitoring. Use this tool when you need to: - Confirm if a particular order was accepted and is active - Check if an order has been filled, partially filled, or canceled - Get execution details for a specific order - Diagnose issues with order placement - Track the status of important orders individually Order status tracking is essential for verifying execution status and troubleshooting any issues with specific orders. Example use cases: - Checking if a recently placed limit order is active in the book - Verifying fill details of…

Analyze market depth and liquidity to optimize order entry and execution. Use this tool when you need to: - Assess true liquidity before placing large orders - Identify potential support/resistance levels from order clusters - Determine optimal limit order prices for higher fill probability - Detect order imbalances that might signal price direction Understanding the orderbook is essential for effective trade execution, especially for larger orders or in less liquid markets. Example use cases: - Finding the optimal limit price to ensure your order gets filled - Estimating potential slippage…

Get historical orders. Retrieves the history of orders for the account, including filled, canceled, and expired orders. This is useful for analyzing past trading activity and performance.

Understand the exchange's global parameters and portfolio margin risk factors. Use this tool when you need to: - Check fee schedules before placing trades - Verify trading limits and restrictions - Understand exchange-wide parameters that affect your trading - Review portfolio margin factors (hedged/unhedged margin, vol-shock params) per asset Returns: - config: raw system configuration (contract addresses, chain IDs, fee tiers, etc.) - portfolio_margin: per-asset portfolio margin parameters used in PM calculations Example use cases: - Checking current fee tiers for different markets - Veri…

Verify the exchange is fully operational before executing trades. Use this tool when you need to: - Check if Paradex is functioning normally before placing important orders - Verify system status if you encounter unexpected behavior - Confirm that maintenance periods are not in effect - Check exchange clock synchronization with your own systems This is especially important before executing critical trades or when experiencing unexpected behavior from other API calls. Example use cases: - Verifying the exchange is operational before executing a trading strategy - Checking if maintenance mode…

One-shot pre-trade analysis combining readiness validation and margin impact. Use before submitting any order. Returns: - account_status, current_position, bbo, market_constraints — context for the trade. - margin — IM/MM before/after the trade, account_value, free_collateral_after. Margin math is the live `paradex_py.margin.compute` calculator; no hand math. - estimates — fee, slippage, daily funding, break-even (taker rate via the SDK's `fee_rate_for_market` which respects account-tier and asset-kind). - ready_to_trade + not_ready_reasons — actionable summary: account is ACTIVE, size …

Analyze actual market transactions to understand market sentiment and liquidity. Use this tool when you need to: - Detect large trades that might signal institutional activity - Calculate average trade size during specific periods - Identify buy/sell pressure imbalances - Monitor execution prices vs. order book prices - Understand market momentum through trade flow Trade data provides insights into actual market activity versus just orders, helping you understand how other participants are behaving. Example use cases: - Detecting large "whale" transactions that might influence price - Analy…

Get a complete operational snapshot of a vault: token balances, open positions, and trading account health in a single call. Use this instead of calling paradex_vault_balance, paradex_vault_positions, and paradex_vault_account_summary separately. Returns: - balances: vault token balances - positions: all open positions with P&L and liquidation prices - account_summary: margin health, free collateral, leverage

Get a comprehensive summary of a specific vault or all vaults if no address is provided. 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. Use jmespath_filter to reduce the number of results as much as possible as number of vaults can be large. You can use JMESPath expressions to filter, sort, or transform the results. Examples: - Filter by TVL: "[?to_number(tvl) > `10000`]" - Filter by performance: "[?to_number(total_roi) > `5.0`]" - Sort b…

Track deposit and withdrawal history for auditing and reconciliation. Use this tool when you need to: - Verify deposits have completed and are available for trading - Track withdrawal status and confirm transaction settlement - Audit the complete fund flow history for a vault - Reconcile on-chain transactions with platform records - Understand historical capital allocation patterns Complete transfer history is essential for proper accounting and provides a clear audit trail of all capital movements. Example use cases: - Confirming that a recent deposit was credited to your account - Trackin…

Get detailed information about a specific vault or all vaults if no address is provided. Retrieves comprehensive details about a specific vault identified by its address, including configuration, permissions, and other vault-specific parameters. Use jmespath_filter to reduce the number of results as much as possible as number of vaults can be large. You can use JMESPath expressions to filter, sort, or limit the results. Examples: - Filter by owner: "[?owner_account=='0x123...']" - Filter by status: "[?status=='ACTIVE']" - Find vaults with specific strategy: "[?contains(strategies, 'strategy…