{"agentId":"23121","version":"1.0","protocol":"x402","capabilities":[{"id":"automation_evaluate","description":"Run a single automation evaluation and charge only for actual LLM usage. Returns the evaluation result (condition met/not met, reasoning, action taken) and the actual cost. Uses the x402 'upto' scheme -- you authorize a maximum and are charged only what was consumed.","inputSchema":{"type":"object","properties":{"ruleId":{"type":"integer","description":"The automation rule ID to evaluate"}},"required":["ruleId"],"description":"Automation evaluation parameters"},"pricing":{"scheme":"upto","basePrice":500000,"currency":"USDC","description":"Up to $0.50 per evaluation, billed by actual LLM token usage","multipliers":{}}},{"id":"automation_list","description":"List all automation rules for your wallet. Returns each rule's state, asset, condition, and the shared wallet balance.","inputSchema":{"type":"object","properties":{},"required":[],"description":"No parameters required -- wallet resolved from x402 auth context"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free -- no charge for listing automations","multipliers":{}}},{"id":"prediction_market_positions","description":"Get prediction market positions and open orders for a HyperLiquid wallet on HIP-4. Returns each position's outcome, size, entry/current price, and unrealized PnL, plus resting orders.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"HyperLiquid wallet address to query positions and open orders for.","example":"0x..."}},"required":["wallet"],"description":"Prediction market positions query"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free -- read-only prediction market data","multipliers":{}}},{"id":"prediction_markets_browse","description":"Browse and search prediction markets across every supported venue (HyperLiquid HIP-4 and Polymarket). Returns active events with numbered outcomes (each with implied probability), volume, expiry, and data-freshness flags. Each event carries a venue-qualified 'ref' handle (\"hl-742\", \"pm-287395\") and a 'venue' field. Markets may be binary (YES/NO) or multi-outcome buckets.","inputSchema":{"type":"object","properties":{"search":{"type":"string","description":"Text to filter markets by title. A * stands for any text, so \"BTC above * on *\" matches whole titles of that shape."},"category":{"type":"string","description":"Optional category filter: Crypto, Sports, Economics, or Other."},"limit":{"type":"integer","description":"Max results to return (default 10, max 50).","default":10,"minimum":1,"maximum":50}},"required":[],"description":"Prediction market browse filters"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free -- read-only prediction market data","multipliers":{}}},{"id":"get_trade_history","description":"Get recent trading history (fills) for a HyperLiquid wallet. Returns executed trades with coin, side, size, price, and fees.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"HyperLiquid wallet address to query","example":"0x..."},"limit":{"type":"number","description":"Maximum number of trades to return (default: 50, max: 200)","example":"50"}},"required":["wallet"],"description":"Trade history query parameters"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free - no charge for history queries","multipliers":{}}},{"id":"get_account_summary","description":"Get account summary for a HyperLiquid wallet. Returns account value, margin used, available balance, and position count.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"HyperLiquid wallet address to query","example":"0x..."}},"required":["wallet"],"description":"Account summary query parameters"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free - no charge for account queries","multipliers":{}}},{"id":"get_available_assets","description":"Get list of available tradeable assets on HyperLiquid. Returns asset symbols, current prices, and trading parameters.","inputSchema":{"type":"object","properties":{"filter":{"type":"string","description":"Optional filter by asset symbol prefix","example":"BTC"}},"required":[],"description":"Asset listing parameters"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free - no charge for asset listing","multipliers":{}}},{"id":"chart_screenshot","description":"Generate financial chart screenshots with technical indicators. Supports all HyperLiquid assets and 74 indicators: ADX, ADXFull, ALMA, Aroon, ATR, AtrTrailingStop, Beta, BollingerBands, CandleShape, CCI, ChandelierExit, CMF, Correlation, DEMA, DonchianChannels, DoubleSmoothedEMA, DynamicMoneyFlow, EhlersSuperSmoother, EMA, EmaOfVwap, EPMA, Footprint, FRAMA, FundingRateChart, HMA, HorizontalLinesIndicator, Ichimoku, JMA, KAMA, KeltnerChannels, KST, LiquidationHeatmap, Liquidations, MACD, McGinleyDynamic, MFI, MondayRange, OBV, OpenInterestChart, OrderbookHeatmap, OrderFills, ParabolicSAR, Parallox, PivotPoints, PriceRelativeStrength, PriorRange, RealizedPriceChart, RealOpen, ROC, RSI, Slope, SMA, SMMA, SpreadRatio, StdDev, Stochastic, StochasticRSI, StructuralLevels, SuperTrend, SWMA, TEMA, TMA, TradeBubbles, TSI, UltimateBaselineSystem, Volatility, Volume, VolumeProfile, VWAP, VWMA, WaddahAttarExplosion, WilliamsR, WMA, ZLEMA. For liquidation levels, add the LiquidationHeatmap indicator: it draws estimated liquidation clusters derived from open-interest changes (an estimate, not exchange-reported liquidations). On BTC an image draws only clusters of at least 8000000 USD, the live chart's view. Optional orderbook heatmap overlay via the `heatmap` parameter (resting bid/ask liquidity across the chart's visible window, from recorded history). Returns a PNG image.","inputSchema":{"type":"object","properties":{"coin":{"type":"string","description":"Asset symbol (e.g. BTC, ETH, SOL, xyz:AAPL)"},"interval":{"type":"string","description":"Candle interval","enum":["1m","5m","15m","1h","4h","1d"]},"indicators":{"type":"array","description":"Technical indicators in Name:param format (max 5). Available: ADX, ADXFull, ALMA, Aroon, ATR, AtrTrailingStop, Beta, BollingerBands, CandleShape, CCI, ChandelierExit, CMF, Correlation, DEMA, DonchianChannels, DoubleSmoothedEMA, DynamicMoneyFlow, EhlersSuperSmoother, EMA, EmaOfVwap, EPMA, Footprint, FRAMA, FundingRateChart, HMA, HorizontalLinesIndicator, Ichimoku, JMA, KAMA, KeltnerChannels, KST, LiquidationHeatmap, Liquidations, MACD, McGinleyDynamic, MFI, MondayRange, OBV, OpenInterestChart, OrderbookHeatmap, OrderFills, ParabolicSAR, Parallox, PivotPoints, PriceRelativeStrength, PriorRange, RealizedPriceChart, RealOpen, ROC, RSI, Slope, SMA, SMMA, SpreadRatio, StdDev, Stochastic, StochasticRSI, StructuralLevels, SuperTrend, SWMA, TEMA, TMA, TradeBubbles, TSI, UltimateBaselineSystem, Volatility, Volume, VolumeProfile, VWAP, VWMA, WaddahAttarExplosion, WilliamsR, WMA, ZLEMA. Format: Name (default params), Name:period (e.g. RSI:14), Name:p1:p2 (e.g. BollingerBands:20:2). For liquidation levels, add the LiquidationHeatmap indicator: it draws estimated liquidation clusters derived from open-interest changes (an estimate, not exchange-reported liquidations). On BTC an image draws only clusters of at least 8000000 USD, the live chart's view.","items":{"type":"string","description":null},"example":["RSI:14","SMA:200","BollingerBands:20:2"]},"days":{"type":"integer","description":"History in days (default based on interval)"},"width":{"type":"integer","description":"Image width in pixels","default":1200,"minimum":200,"maximum":1920},"height":{"type":"integer","description":"Image height in pixels","default":600,"minimum":200,"maximum":1080},"zones":{"type":"array","description":"Optional colored rectangles drawn on the chart. Max 50. Each entry: { startTime (ISO-8601 UTC), endTime, topPrice, bottomPrice, text?, color?, borderColor?, borderWidth? }.","items":{"type":"object","description":null}},"annotations":{"type":"array","description":"Optional overlays drawn on the chart. Max 50. Text labels are truncated at 120 chars. Types: trendline, label, arrow, path, zone, measurement. See ChartAnnotation for per-type fields.","items":{"type":"object","description":null}},"priceLevels":{"type":"array","description":"Shorthand for support/resistance zones. Each entry: { label, priceTop, priceBottom }. Expanded into full zones using interval-based time bounds. Counts against the zones cap.","items":{"type":"object","description":null}},"measurements":{"type":"array","description":"Shorthand for % distance annotations between two price levels. Each entry: { priceTop, priceBottom, topLabel?, bottomLabel? }. Expanded into measurement annotations. Counts against the annotations cap.","items":{"type":"object","description":null}},"heatmap":{"type":"object","description":"Optional orderbook heatmap overlay: resting bid/ask liquidity around the mid price across the chart's visible window, read from recorded order book history. Its step follows the candle interval (one column per candle). Pass {} or true for defaults. Without an explicit frame (no anchoring annotation) the image shows six days of candles, kept between 120 and 576 candles, with the price axis centred on the last close, at least 4% each way, so walls on both sides are visible. Fields: lookbackMinutes (1-1052640, default: the visible window), style, minNotionalUsd, colorMaxNotionalUsd, verticalRangePercent, opacity. BTC defaults to the live chart's wall view (minNotionalUsd 25000000, colorMaxNotionalUsd 80000000); other coins default to the floor below and an automatic colour scale. Coverage is best for continuously tracked coins; a coin with little recorded history shows gaps or nothing. The response's heatmapColumns counts the columns of recorded history drawn; levels below minNotionalUsd are hidden, so a high floor can leave them blank, and heatmapNotice says so when none reached it.","example":{"minNotionalUsd":250000},"properties":{"lookbackMinutes":{"type":"integer","description":"Minutes of book history to draw, ending now. Narrows the chart's visible window, never extends it. Omit to cover the whole visible window","minimum":1,"maximum":1052640},"style":{"type":"string","description":"bundled draws each level as a block at its tier height (the live chart's Bundled view); lines draws one thin row per level","enum":["bundled","lines"],"default":"bundled"},"minNotionalUsd":{"type":"number","description":"Hide price levels with less resting size than this (USD). Default 25000000 for BTC","default":5000},"colorMaxNotionalUsd":{"type":"number","description":"Resting size (USD) at which a level reaches full colour; 0 scales to the drawn book. Default 80000000 for BTC","default":0,"minimum":0},"verticalRangePercent":{"type":"number","description":"Price range drawn above and below the mid price, in percent","default":5.0},"opacity":{"type":"number","description":"Overlay opacity","default":0.7,"minimum":0,"maximum":1}}}},"required":["coin","interval"],"description":"Chart screenshot parameters"},"pricing":{"scheme":"exact","basePrice":5000,"currency":"USDC","description":"$0.005 per chart render","multipliers":{}}},{"id":"get_open_orders","description":"Get open (unfilled) orders for a HyperLiquid wallet. Returns order details including coin, side, size, price, and order type.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"HyperLiquid wallet address to query orders for","example":"0x..."}},"required":["wallet"],"description":"Open orders query parameters"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free - no charge for order queries","multipliers":{}}},{"id":"automation_create","description":"Create a new automation rule with natural language conditions and actions. Requires trading authorization. Includes 1000 LLM evaluation checks. The automation evaluates your condition on a schedule and executes the action when met. Trades are charged separately at standard x402 rates.","inputSchema":{"type":"object","properties":{"asset":{"type":"string","description":"Target asset symbol (e.g., ETH, BTC, SOL)","example":"ETH"},"conditionPrompt":{"type":"string","description":"Natural language condition (e.g., 'Buy if RSI drops below 30 on the 4h chart')","example":"Buy if ETH price drops below $3000"},"actionPrompt":{"type":"string","description":"Natural language action to execute when condition is met (e.g., 'Buy $100 of ETH')","example":"Buy $100 of ETH"},"interval":{"type":"string","description":"Chart interval context for evaluation","enum":["15m","30m","1h","2h","4h","6h","8h","12h","1d","1w"],"default":"4h"},"name":{"type":"string","description":"Optional friendly name for the automation (auto-generated if omitted)","example":"ETH RSI DCA Bot"},"webhookUrl":{"type":"string","description":"Optional URL to receive webhook notifications for automation events (condition_met, trade_executed, error, credits_low, etc.)"},"deactivateAfterTrigger":{"type":"boolean","description":"If true, automation deactivates after first trigger (one-shot mode)","default":false},"venue":{"type":"string","description":"Trading venue for the rule (defaults to HyperLiquid). Requires completed onboarding on that venue.","default":"HyperLiquid"}},"required":["asset","conditionPrompt","actionPrompt"],"description":"Automation rule parameters"},"pricing":{"scheme":"exact","basePrice":5000000,"currency":"USDC","description":"$5.00 -- includes 1000 automation evaluation checks. Trades charged separately at standard x402 rates.","multipliers":{}}},{"id":"automation_status","description":"Get the current state of an automation rule including last check result, trigger configuration, recent execution logs, and shared wallet balance.","inputSchema":{"type":"object","properties":{"ruleId":{"type":"integer","description":"The automation rule ID to query"},"logLimit":{"type":"integer","description":"Number of recent logs to include (default 5, max 50)","default":5,"minimum":1,"maximum":50}},"required":["ruleId"],"description":"Automation status query parameters"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free -- no charge for status queries","multipliers":{}}},{"id":"automation_topup","description":"Add 1000 evaluation checks to your automation balance. Balance is shared across all your automations. If automations were paused due to depleted credits, they auto-resume after topup.","inputSchema":{"type":"object","properties":{},"required":[],"description":"No parameters required -- wallet resolved from x402 auth context"},"pricing":{"scheme":"exact","basePrice":5000000,"currency":"USDC","description":"$5.00 -- 1000 additional automation evaluation checks","multipliers":{}}},{"id":"hyperliquid_order","description":"Execute trading operations on HyperLiquid perpetual futures. Supports limit, market, and stop orders with optional take-profit/stop-loss. Actions: create_market, create_limit, create_stop, modify_by_oid, cancel_by_oid, etc.","inputSchema":{"type":"object","properties":{"action":{"type":"string","description":"Trading action to perform","enum":["create_market","create_limit","create_stop","create_batch","modify_by_oid","modify_by_cloid","modify_batch","cancel_by_oid","cancel_by_cloid","cancel_batch"]},"coin":{"type":"string","description":"Asset symbol (e.g., 'BTC', 'ETH')","example":"BTC"},"isBuy":{"type":"boolean","description":"True for buy/long, false for sell/short"},"dollarSize":{"type":"number","description":"Order size in USD","minimum":1,"example":100},"price":{"type":"number","description":"Limit price (required for limit orders)"},"triggerPrice":{"type":"number","description":"Trigger price for stop orders"},"reduceOnly":{"type":"boolean","description":"If true, order will only reduce existing position","default":false},"takeProfitPrice":{"type":"number","description":"Optional take-profit price"},"stopLossPrice":{"type":"number","description":"Optional stop-loss price"},"oid":{"type":"integer","description":"Order ID (for modify/cancel operations)"},"cloid":{"type":"string","description":"Client order ID (alternative to oid)"}},"required":["action"],"description":"Trading order parameters"},"pricing":{"scheme":"exact","basePrice":100000,"currency":"USDC","description":"$0.10 base + 0.01% of trade size","multipliers":{"dollarSize":100}}},{"id":"prediction_market_detail","description":"Get detailed information about a specific prediction market on any supported venue: description, resolution rules, oracle source, expiry, numbered outcomes with probabilities, and optional orderbook depth. Accepts an event name, a venue-qualified ref handle (\"hl-742\", \"pm-287395\"), or a bare numeric id (HyperLiquid HIP-4).","inputSchema":{"type":"object","properties":{"event_id":{"type":"string","description":"Event name (case-insensitive exact match), the venue-qualified ref handle from prediction_markets_browse (\"hl-742\", \"pm-287395\"), or a bare numeric HyperLiquid HIP-4 id."},"include_orderbook":{"type":"boolean","description":"Include top orderbook levels per outcome (default false).","default":false}},"required":["event_id"],"description":"Prediction market detail query"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free -- read-only prediction market data","multipliers":{}}},{"id":"get_spot_balances","description":"Get spot clearinghouse balances for a HyperLiquid wallet. Returns token balances including USDC. Essential for unified account mode where USDC balance lives in the spot clearinghouse.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"HyperLiquid wallet address to query spot balances for","example":"0x..."}},"required":["wallet"],"description":"Spot balance query parameters"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free - no charge for spot balance queries","multipliers":{}}},{"id":"get_positions","description":"Get active trading positions for a HyperLiquid wallet. Returns position size, entry price, unrealized PnL, liquidation price, and leverage.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"HyperLiquid wallet address to query positions for","example":"0x..."}},"required":["wallet"],"description":"Position query parameters"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free - no charge for position queries","multipliers":{}}},{"id":"automation_manage","description":"Start, stop, or delete an existing automation rule. Stopping pauses evaluation without deleting the rule. Deleting soft-deletes the rule (preserves cost history).","inputSchema":{"type":"object","properties":{"ruleId":{"type":"integer","description":"The automation rule ID to manage"},"action":{"type":"string","description":"Management action to perform","enum":["start","stop","delete"]}},"required":["ruleId","action"],"description":"Automation management parameters"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free -- no charge for automation management","multipliers":{}}},{"id":"automation_info","description":"Get automation system metadata: supported assets, valid intervals, trigger types, resource limits, and pricing. Use this before creating automations to understand available options.","inputSchema":{"type":"object","properties":{},"required":[],"description":"No parameters required"},"pricing":{"scheme":"exact","basePrice":0,"currency":"USDC","description":"Free -- no charge for automation info","multipliers":{}}}],"supportedNetworks":["base","megaeth","robinhood"],"paymentAssets":["USDC","USDM","USDG"],"networks":{"base":{"chainId":8453,"caip2":"eip155:8453","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitatorAddress":"0x8E7769D440b3460b92159Dd9C6D17302b036e2d6","decimals":6,"rpcUrl":"https://mainnet.base.org"},"megaeth":{"chainId":4326,"caip2":"eip155:4326","asset":"USDM","assetAddress":"0x2c2d8EF0664432BA243deF0b8f60aF7aB43a60B4","facilitatorAddress":"0x8E7769D440b3460b92159Dd9C6D17302b036e2d6","decimals":18,"rpcUrl":"https://mainnet.megaeth.com/rpc"},"robinhood":{"chainId":4663,"caip2":"eip155:4663","asset":"USDG","assetAddress":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","facilitatorAddress":"0x8E7769D440b3460b92159Dd9C6D17302b036e2d6","decimals":6,"rpcUrl":"https://rpc.mainnet.chain.robinhood.com"}},"recipientAddress":"0xcd1baf2B33781c088B30106289e745972E41b0E8","serviceHealth":{"hyperLiquid":true,"meridian":true,"megaETH":true,"networkHealth":{"base":true,"megaeth":true,"robinhood":true},"lastChecked":"2026-11-12T13:25:43.8615516Z"},"authorization":{"prepareEndpoint":"/x402/authorize/prepare","approveEndpoint":"/x402/authorize/approve","statusEndpoint":"/x402/authorize/status","isFree":true,"referralCode":"DAB1RD"},"defaultPaymentNetwork":"base","networkSelectionHint":"Use query parameter ?network=<id> or header X-Payment-Network: <id>. Both the short name (base) and the CAIP-2 id (eip155:8453) are accepted.","supportedX402Versions":[1,2],"defaultX402Version":1,"versionSelectionHint":"Request x402 v2 (CAIP-2 networks, nested resource object, amount) via POST /x402/v2/{capability}, header X-X402-Version: 2, or ?x402Version=2. Omit to get the default version.","payerStatus":null,"docs":{"authorization":{"steps":["1. POST /x402/authorize/prepare with {payerAddress, hyperLiquidWallet}","2. Receive agentApprovalTypedData and builderFeeTypedData (EIP-712)","3. Sign BOTH typed data objects using wallet.signTypedData(domain, types, message)","4. POST /x402/authorize/approve with both signatures + nonce + builderNonce","5. Verify status via GET /x402/authorize/status?payerAddress=0x..."],"importantNotes":["CRITICAL: Use DIFFERENT nonces - 'nonce' for agent approval, 'builderNonce' for builder fee","Both nonces are returned from /prepare - pass them back to /approve unchanged","Sign with the hyperLiquidWallet (the wallet with trading funds)","Remove EIP712Domain from types before signing (ethers.js handles it automatically)","Authorization is FREE - no x402 payment required","WALLET ROLES: payerAddress = wallet that pays x402 fees (signs EIP-3009 TransferWithAuthorization). hyperLiquidWallet = wallet that trades on HyperLiquid. These can be the same address.","If you already authorized via the DegenAI frontend, the CLI does not need a HyperLiquid private key to place trades."],"exampleCode":"const sig = await wallet.signTypedData({name, version, chainId, verifyingContract}, {Agent: [...]}, message);"},"trading":{"steps":["1. Create EIP-3009 TransferWithAuthorization signature for payment","2. Base64 encode the payment payload as PAYMENT-SIGNATURE header","3. POST /x402/hyperliquid_order with trade parameters","4. Response includes IPFS receipt CID for verification"],"limits":{"minOrderValueUsd":10,"supportedCoins":["0G","10Y","2Y","2Z","30Y","AAOI","AAPL","AAVE","ACE","ADA","AERO","AIXBT","ALGO","ALT","AMAT","AMD","AMZN","ANIME","ANSEM","ANT"],"orderTypes":["market","limit"]}},"commonErrors":{"SIGNATURE_MISMATCH":"Signature was signed by wrong wallet. Ensure you sign with hyperLiquidWallet.","DUPLICATE_NONCE":"HyperLiquid requires unique nonces. Use both 'nonce' and 'builderNonce' from /prepare.","MIN_ORDER_VALUE":"Order value too small. Minimum is $10 USD per order.","NOT_AUTHORIZED":"Trading not authorized. Complete /x402/authorize/prepare and /approve flow first. If you authorized via the frontend, the CLI does not need a HyperLiquid private key.","AGENT_ALREADY_LINKED":"This is OK - agent was already approved on HyperLiquid. Proceed with trading.","MISSING_BUILDER_NONCE":"builderNonce is required. Use the value from /prepare response.","INVALID_NONCE":"Nonce format invalid. Use the exact values from /prepare response.","PAYMENT_INVALID":"Payment verification failed. Check the 'detail' field for the specific Meridian reason (e.g. insufficient_funds, invalid_network, expired signature).","NETWORK_UNSUPPORTED":"Payment was signed for an unsupported network. The payment network must match the 'network' field in the 402 paymentRequirements response, not your local configuration. Check defaultPaymentNetwork in discovery.","NETWORK_DISABLED":"Payment network is temporarily disabled. Use a different supported network."}},"performanceMetrics":{"scheduler_slice":{"totalExecutions":96,"successRate":1,"avgLatencyMs":1156,"p95LatencyMs":2239,"lastExecutedAt":"2026-11-12T13:04:09.9494529Z","uptimeSince":"2026-11-11T23:59:58.8030988Z"}},"feedback":{"endpoint":"/api/feedback/{requestId}","windowMinutes":10,"issues":["response_unclear","data_incorrect","error_unhelpful","doc_mismatch","too_slow","other"],"requiredHeader":"X-Payer-Address"}}