paradex-skills

Conversational portfolio briefings for Paradex personal accounts and vaults. Unifies account summary, positions, balances, market data, and funding into natural language answers to "how am I doing?", "what are my positions?", "what's my P&L?", "summarize my portfolio", "how much do I have?", or "give me a morning briefing". Automatically covers the personal trading account and any vaults the user owns or operates. Use this skill whenever a user asks about their current Paradex account status, open positions, unrealized P&L, balance, margin health, or wants a high-level snapshot. Also trigger for "my account", "my positions", "portfolio overview", "morning briefing", or any conversational question about the current state of their Paradex account. Use this skill even if the user doesn't say "Paradex" explicitly — any question about current positions, account balance, or portfolio health from an authenticated user should route here. For fills-based P&L or order history, use paradex-trading-recap.

Activity-focused trading recap for a user-specified time period on Paradex. Fetches fills, order history, and funding payments for a window (today, yesterday, last 7 days, or custom) and produces: realized P&L from fills, fee totals, net P&L attribution (trading + funding − fees), order placement and fill rate metrics, and per-market breakdown. Use this skill when the user asks about activity over a period — "recap my trading today", "what did I do last week", "how many trades did I place", "what was my P&L yesterday", "summarize my fills", "what was my win rate", "did I make money this week". Distinct from portfolio-copilot (current account state/positions) and risk-guardian (risk metrics) — this skill is about what happened during a period, using actual fill data.

Design, backtest, and reason about trading strategies for Paradex using MCP tools. Takes natural language strategy descriptions and turns them into structured trading plans with entry/exit rules, position sizing, risk parameters, and historical validation using Paradex kline and trade data. Supports strategy templates for common approaches (funding arb, mean reversion, momentum, grid trading, basis trading, short premium / covered strangle for options). Use this skill whenever the user asks to build a trading strategy for Paradex, wants to backtest an idea, design entry/exit rules, or asks about grid trading, funding arbitrage, mean reversion, momentum, or any systematic trading approach on Paradex. Trigger for "build me a bot", "trading plan", "backtest this idea", or "how would I trade [pattern] on Paradex". For full historical simulation (Sharpe, drawdown, equity curve), hand off to paradex-strategy-backtester.

Translates options strategy ideas into importable JSON for the Paradex Strategy Backtester HTML tool or runs the backtester directly via a Python CLI script. Integrates with paradex-options-pricer and paradex-pm-analyzer to seed realistic entry conditions and validate margin. Use whenever the user wants to backtest an options strategy, says "run a backtest", "test this strategy historically", "how would X perform over the last N months", "simulate iron condor / strangle / straddle / condor / butterfly / collar / calendar", "generate a backtest config", "import into backtester", "what entry conditions should I use", "interpret my backtest results", "run the Python backtester", "uv run backtest", or shares metrics like Sharpe, max drawdown, win rate from a prior run. Also trigger when the user is in the middle of a paradex-strategy-builder conversation and asks to validate the idea with historical data — hand off the strategy spec to the backtester JSON format.

Execution quality analysis and order replay for Paradex personal trading accounts. Reconstructs the chronological trading sequence for a market or time window, benchmarks fill prices against market prices at the time of each fill (arrival price, period VWAP), computes realized slippage in basis points, analyzes maker/taker ratio and fill patterns, and scores execution quality 1-10. Use this skill when the user asks how their orders were executed — "was my execution good", "how much slippage did I get", "replay my trades from this morning", "analyze my BTC entry", "why did my order fill at that price", "benchmark my fills", "execution quality report", "show me my order timeline". Distinct from trading-recap (activity summary/P&L) and market-analyst (market microstructure) — this skill focuses on the quality of the user's own execution against market benchmarks.

Technical analysis, market screening, and regime classification for Paradex perpetual futures markets. Computes indicators (RSI, MACD, Bollinger Bands, ATR, VWAP) from kline data, scans funding rates for arbitrage opportunities, analyzes orderbook depth and imbalances, classifies market regimes (trending, ranging, volatile), and screens across all markets for trading opportunities. Use this skill when the user asks about technical analysis on Paradex, market conditions, support/resistance levels, indicators, funding rate screening, orderbook depth, "what's the market doing", "is BTC trending", "find me opportunities", "market overview", "top movers", or any analytical question about Paradex market data and conditions. Use this skill even if the user doesn't explicitly say "technical analysis" or name an indicator — any question about whether a market is trending, what the momentum looks like, where support or resistance is, how volume compares, or what the funding rate implies should route here.

Margin calculation engine and delta-hedge order tool for Paradex accounts. Computes IMR and MMR using the correct methodology — cross-margin (XM) for most accounts or Portfolio Margin (PM) scenario scan for PM-enrolled accounts — determined at the account level via margin_methodology. Also computes and optionally submits delta-neutral hedge orders: calculates the exact perp size to neutralise portfolio delta and places it via paradex_create_order with confirmation before execution. Use when the user asks about margin requirements, IMR/MMR breakdown, worst-case scenario analysis, how a new position would affect margin, liquidation distance, or says "delta hedge my portfolio", "neutralise my delta", "what size perp to hedge", "place a delta hedge", "hedge my options", "check my margin", "run the margin calc", "how much margin do I need".

Real-time risk monitoring, margin analysis, and protective alerts for Paradex trading accounts and vaults. Synthesizes account summary, positions, market data, and funding rates into actionable risk metrics — liquidation distance, portfolio concentration, margin utilization, exposure heatmaps, and daily P&L attribution. Use this skill whenever the user asks about their risk on Paradex, margin health, liquidation levels, portfolio exposure, drawdown, how much they can lose, position sizing, or when they say things like "am I safe", "check my risk", "how close am I to liquidation", "what's my exposure", "should I be worried", "risk report", or any question about the safety of their Paradex positions or vault positions. Also trigger for any request to monitor or set alerts on Paradex account health.

Real-time strategy evaluator that subscribes to Paradex WebSocket feeds (or HTTP-polls when WS is unavailable), evaluates one or more strategy JSON specs against each market and user event, and POSTs to an OpenCLAW Gateway webhook (`/hooks/agent` or `/hooks/wake`) when triggers fire. Use whenever the user says "alert me when", "watch the market for", "trigger a webhook", "fire when RSI crosses", "monitor my fills", "live signal", "real-time evaluator", "subscribe to BBO", "strategy listener", "OpenCLAW webhook", "mirror fills to a hook", or asks to deploy a backtested strategy as a live alert. Reuses the same gate schema as paradex-strategy-backtester (rsi, sma, rvPctile, ivPctile, fundingRate with all|any|min gates), so a strategy validated in backtest can be promoted to a live listener with minimal edits. Pairs with paradex-strategy-builder (NL → spec) and paradex-strategy-backtester (historical validation) — listener is the live deployment leg.

Renders structured UI components for the Paradex webchat terminal instead of plain text. Outputs raw JSON specs that the webchat UI parses and renders as rich components: metric cards, positions tables, performance charts, alert banners, labeled outputs, and data tables. Use this skill whenever responding in the webchat channel with data that benefits from visual structure: account summaries, open positions, price charts, funding rate tables, trade history, KPI metrics, or any risk/margin alerts. Trigger phrases include "show my positions", "account summary", "plot price", "chart", "table", or any Paradex data query in the webchat context. Do NOT use for plain conversational replies - use the markdown component for those.

Options chain viewer, greek calculator, and sell-candidate ranker for Paradex option markets. Fetches all listed options for BTC and/or ETH, computes delta/gamma/theta/vega in-context using Black-Scholes with the exchange mark IV, displays the options chain grouped by expiry, analyses IV skew (put-call premium differential at same |delta|), and ranks sell candidates by premium attractiveness, IV level, and liquidity. Use when the user asks about option pricing, the options chain, greeks, implied volatility, IV skew, which options to sell, volatility surface, "options overview", "scan for options to sell", "what calls/puts are available", "compute greeks for a strike", "rank sell candidates", "find the 25-delta put", "what is the ATM IV", "price the 90K call", or any question about individual option prices, volatility, or greeks on Paradex.

Order sizing and multi-leg execution assistant for Paradex. Translates natural-language sizing instructions — "use 10% of free collateral", "scale 25% more into my short", "risk 1% of account to the stop", "sell the 90K call and hedge with a perp short" — into validated order payloads with pre-trade checks and an explicit confirmation step before any order is placed. Use when the user wants to enter a position, scale an existing position, size an order from collateral or risk parameters, or place a coordinated multi-leg trade. Trigger phrases: "place an order", "enter a position", "scale into", "size an order", "use X% of collateral", "open a position", "buy/sell N% of free margin", "add to my position", "build a position", "risk X% to the stop", "multi-leg entry", "sell the call and hedge", "place a spread", "size this trade", "how many contracts can I buy".

Vault discovery, comparison, and analytics for Paradex vaults. Ranks vaults by risk-adjusted returns, analyzes operator track records, monitors TVL changes, and recommends vaults based on user risk profile — all by orchestrating the Paradex MCP vault tools (vaults, vault_summary, vault_positions, vault_balance, vault_account_summary, vault_transfers). Use this skill whenever the user asks about Paradex vaults, wants to find the best vaults, compare vault performance, understand vault risks, check a vault's positions or strategy, or asks "where should I deposit", "which vaults are performing well", "show me vault analytics", "vault ROI", "vault drawdown", or anything related to Paradex vault investing and passive income. Also trigger for "yield", "earn", or "passive" in a Paradex context. Use this skill even if the user doesn't say "vault" explicitly — any question about where to deposit USDC, how to earn passive returns on Paradex, or which strategies have the best track record should route here.