Hyperliquid
Perpetuals trading via Thirdfy provider actions. Bridge2 funding, API wallet signing, and builder fee readiness.
Category: Trading
Hyperliquid perpetuals are exposed through the governed action catalog under provider hyperliquid. Orders are signed by an off-chain API wallet (venue signer), not by ERC-7710 Gator grants.
Credential model
| Layer | Model |
|---|---|
| Exchange orders | Hyperliquid API wallet / agent wallet (off-chain signer) |
| Bridge2 funding | Arbitrum USDC. This is not Base spot delegation. |
| EVM funding txs | May use Gator/ERC-7710 or agent_wallet for bridge and token movement |
| Reads | Query master or subaccount address. API-wallet addresses can return empty state. |
Discovery
| Surface | Example |
|---|---|
| MCP | getProviderActions { provider: "hyperliquid" } |
| CLI | thirdfy-agent actions with Hyperliquid provider filter |
Readiness checklist
- Bridge2 funded with Arbitrum USDC for the target account.
- Onboarding complete (
complete_hyperliquid_onboardingor setup/status actions). - Builder fee approval only when builder monetization is active. Unfunded builder config returns
HYPERLIQUID_BUILDER_WALLET_UNFUNDEDand orders proceed without builder attachment. - Preflight and
delegationStatus(oragentWalletBootstrap) before live writes. - Amount and coin allowlists enforced by venue policy (
allowedCoins, max notional).
Execution lanes
runMode | Use |
|---|---|
agent_wallet | Solo agent-owned wallet for setup and perps signing |
thirdfy / hybrid | Delegated user capital with active binding and venue policy |
MetaMask/Gator delegation protects EVM calldata paths. It is not the signing authority for Hyperliquid order / cancel calls.
MCP sequence (summary)
getProviderActions { provider: "hyperliquid" }- Discovery / L2 / user state reads
- Onboarding or setup/status actions
- Orders via
walletExecuteorexecuteIntentwith chosenrunMode
See Thirdfy MCP for the full recommended sequence.
Hosted deploy
Hyperliquid perps templates are on EarnClaw (docs.earnclaw.com). EarnClaw hosts; Thirdfy governs execution.