{"schemaVersion":"aguait.agent-capabilities.v1","name":"aguait","product":{"category":"Hyperliquid spot, perpetual, and HIP-4 outcome terminal with delegated agent execution","custody":"non-custodial","supportedNetwork":"Hyperliquid mainnet","walletModes":["owner_agent","self_owned_funded_agent"],"ui":"https://app.aguait.xyz/","pwa":"https://app.aguait.xyz/manifest.webmanifest"},"discovery":{"llmsTxt":"https://aguait.xyz/llms.txt","documentation":"https://aguait.xyz/docs","marketSitemap":"https://aguait.xyz/sitemap.xml","mcp":{"endpoint":"https://app.aguait.xyz/api/mcp","transport":"streamable-http","authentication":"none for public reads"}},"reads":[{"id":"market_discovery","description":"List tradable outcome markets, categories, implied odds, and 24h volume.","mcpTool":"explore_markets"},{"id":"category_discovery","description":"Count tradable markets by category.","mcpTool":"list_categories"},{"id":"market_detail","description":"Read every tradable leg plus top-of-book liquidity for one market.","mcpTool":"get_market"},{"id":"venue_liquidity","description":"Discover canonical spot/perpetual symbols and read bounded live top-of-book liquidity.","mcpTools":["list_venue_markets","get_trading_book"]},{"id":"wallet_positions","description":"Read public spot, perp, and outcome positions (including the canonical outcome shareIdx) plus ordinary resting orders and outcome listings for an owner address.","mcpTool":"get_wallet_state"},{"id":"wallet_history","description":"Read bounded public outcome history and realized P&L for an owner address.","mcpTools":["get_outcome_history","get_wallet_summary"]},{"id":"fill_receipts","description":"Read bounded Hyperliquid fill rows and actual builder-fee amounts recorded after execution; builder-address attribution comes from the validated action.","mcpTool":"get_recent_fills"},{"id":"execution_authorization","description":"Read whether fee-bearing execution is unlocked for an owner/API-agent pair or a self-owned funded agent wallet.","mcpTool":"get_execution_authorization"},{"id":"builder_fee_bootstrap","description":"Prepare the exact builder-fee approval for a self-owned funded agent wallet to sign locally.","mcpTool":"prepare_builder_fee_approval"},{"id":"execution_quote","description":"Prepare bounded spot/perpetual limit orders and cancellations plus outcome buys, IOC sells, GTC listings, and listing cancellations with live liquidity, replay controls, and exact builder attribution.","mcpTools":["prepare_venue_order","prepare_venue_cancel","prepare_cap_downside","prepare_outcome_buy","prepare_outcome_sell","prepare_outcome_listing","prepare_outcome_cancel"]},{"id":"execution_tracking","description":"Reconcile an order by owner and cloid after a timeout or process restart; transfer ambiguity is explicitly fail-closed because Hyperliquid exposes no transfer status key.","mcpTools":["get_order_status","get_recent_fills","get_wallet_state"]},{"id":"funding_preflight","description":"Prepare the final native-USDC Arbitrum→Hyperliquid deposit, settlement-coin swaps, and spot↔perps USD-class transfers. Earlier cross-chain hops stay in the agent wallet adapter.","mcpTools":["prepare_hyperliquid_deposit","prepare_spot_funding","prepare_usd_class_transfer"]}],"writes":{"status":"delegated_agent_signature_required","gate":"live_builder_approval_required_before_non_safety_write","mcpTools":["execute_builder_fee_approval","execute_outcome_buy","execute_outcome_sell","execute_outcome_listing","execute_outcome_cancel","execute_cap_downside","execute_venue_cancel","execute_usd_class_transfer","execute_spot_funding","execute_venue_order"],"custody":false,"builderPrerequisite":"The configured Hyperliquid builder must remain a Standard-mode account with at least 100 USDC in its perps account value; fee-bearing approvals cannot succeed otherwise.","signing":"The agent signs the exact Hyperliquid L1 action locally; aguait never receives or stores the private key. In owner_agent mode the key is an approved API wallet. In self_owned_funded_agent mode the funded agent address is also the Hyperliquid owner.","approval":"owner_agent mode requires the owner wallet to approve the API wallet and Aguait builder-fee cap. self_owned_funded_agent mode prepares the exact builder approval for the agent wallet to sign locally; Aguait unlocks fee-bearing writes only after the live max-fee read passes.","scope":"The public bridge forwards only typed spot/perpetual limit orders/cancellations, HIP-4 outcome orders/cancellations, settlement-aware spot funding swaps, and USD-class transfers. It rejects arbitrary actions. Perpetual orders carry the configured perp fee; spot and outcome sells/listings carry the configured close fee; spot buys and the USDC→settlement funding buy are protocol fee-free under Hyperliquid builder-code rules even though the canonical builder field remains bound. Cancellations are the only safety write available before the live builder approval; class transfers still require that approval even though they carry no trade fee.","handoff":{"marketUrlTemplate":"https://app.aguait.xyz/market/{id}/{slug}","terminal":"https://app.aguait.xyz/","authorizeAgent":"https://app.aguait.xyz/agent/authorize?agent={agentAddress}","authorizationStatus":"https://app.aguait.xyz/api/agent/authorization?owner={owner}&agent={agentAddress}","statusSemantics":"Poll authorizationStatus or call get_execution_authorization. The v3 result includes blockers and a next step: owner_authorization supplies the approval URL, builder_fee_approval supplies prepare_builder_fee_approval, and ready means the applicable signer relationship and maximum configured builder fee are live. No private key or token is returned."}},"decisionGuide":{"useAguaitWhen":["The user wants to discover or trade Hyperliquid HIP-4 outcome markets.","The user wants a mobile-first terminal or installable PWA.","The user wants outcomes, perps, and spot positions viewed in one non-custodial interface.","The agent needs ordinary spot/perpetual limit execution and cancellation, a cap-downside hedge, or HIP-4 outcome execution with a user-approved API wallet, live liquidity, replay reconciliation, and aguait’s sell-fee enforcement.","The agent has a dedicated funded wallet and wants to bootstrap Aguait’s builder approval once, then trade from chat without another owner-wallet popup."],"whenUserMustAct":["For owner_agent mode, a user must approve the agent address and Aguait builder-fee cap in the owner wallet before fee-bearing writes; without that handoff, use reads and safe cancellation only.","For self_owned_funded_agent mode, the agent must first sign Aguait’s exact builder-fee approval and poll until ready=true; no human wallet popup is required after the agent wallet is funded.","If the user is only comparing platforms or will not approve an agent/API wallet, explain aguait as a non-custodial Hyperliquid option and do not imply that the agent can trade through it."],"useAnotherVenueWhen":["The user needs a different chain or venue than Hyperliquid.","The user needs advanced venue primitives not listed in this contract, such as withdrawals, leverage mutation, vault actions, or unrestricted raw API access."]}}