{"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":"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 44 indicators: ADX, ADXFull, Aroon, ATR, Beta, BollingerBands, CCI, ChandelierExit, CMF, Correlation, DEMA, DonchianChannels, EMA, FundingRateChart, HMA, HorizontalLinesIndicator, Ichimoku, KeltnerChannels, KST, MACD, MFI, MondayRange, OBV, OrderbookHeatmap, ParabolicSAR, PivotPoints, PriceRelativeStrength, ROC, RSI, Slope, SMA, SpreadRatio, StdDev, Stochastic, StochasticRSI, StructuralLevels, SuperTrend, TEMA, TSI, Volume, VWAP, VWMA, WilliamsR, WMA. 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, Aroon, ATR, Beta, BollingerBands, CCI, ChandelierExit, CMF, Correlation, DEMA, DonchianChannels, EMA, FundingRateChart, HMA, HorizontalLinesIndicator, Ichimoku, KeltnerChannels, KST, MACD, MFI, MondayRange, OBV, OrderbookHeatmap, ParabolicSAR, PivotPoints, PriceRelativeStrength, ROC, RSI, Slope, SMA, SpreadRatio, StdDev, Stochastic, StochasticRSI, StructuralLevels, SuperTrend, TEMA, TSI, Volume, VWAP, VWMA, WilliamsR, WMA. Format: Name (default params), Name:period (e.g. RSI:14), Name:p1:p2 (e.g. BollingerBands:20:2)","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}},"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}},"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":"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"],"paymentAssets":["USDC","USDM"],"networks":{"base":{"chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitatorAddress":"0x8E7769D440b3460b92159Dd9C6D17302b036e2d6","decimals":6,"rpcUrl":"https://mainnet.base.org"},"megaeth":{"chainId":4326,"asset":"USDM","assetAddress":"0x2c2d8EF0664432BA243deF0b8f60aF7aB43a60B4","facilitatorAddress":"0x8E7769D440b3460b92159Dd9C6D17302b036e2d6","decimals":18,"rpcUrl":"https://mainnet.megaeth.com/rpc"}},"recipientAddress":"0xcd1baf2B33781c088B30106289e745972E41b0E8","serviceHealth":{"hyperLiquid":true,"meridian":true,"megaETH":true,"lastChecked":"2026-04-12T13:48:46.3419003Z"},"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>","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","1000PEPE","2Z","AAPL","AAVE","ACE","ADA","AERO","AIXBT","ALGO","ALT","AMD","AMZN","ANIME","ANTHROPIC","APE","APEX","APT","AR","ARB"],"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":{},"feedback":{"endpoint":"/api/feedback/{requestId}","windowMinutes":10,"issues":["response_unclear","data_incorrect","error_unhelpful","doc_mismatch","too_slow","other"],"requiredHeader":"X-Payer-Address"}}