Hyperliquid

Perpetuals trading through Thirdfy provider actions. USDC on Base, Arbitrum, Polygon, or Ethereum credits perps. Orders use an off-chain API wallet signer.

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)
Perps funding	Native USDC on Base, Arbitrum, Polygon, or Ethereum. Status returns the next write.
EVM funding txs	May use Gator/ERC-7710 or `agent_wallet` for token movement
Reads	Query master or subaccount address. API-wallet addresses can return empty state.

Discovery

curl "https://api.thirdfy.com/api/v1/agent/actions/catalog"

Surface	Example
MCP	`getProviderActions { provider: "hyperliquid" }`
CLI	`thirdfy-agent actions` with Hyperliquid provider filter

Readiness checklist

Trading wallet holds at least 5 USDC on a supported source chain, or perps margin is already funded.
Onboarding complete (complete_hyperliquid_onboarding or setup/status actions). Follow nextAction from get_hyperliquid_funding_status. When that write is deposit_hyperliquid_cctp, pass sourceChainId (no default) and quote first with quote_hyperliquid_cctp_deposit.
Builder fee approval only when builder monetization is active. Unfunded builder config returns HYPERLIQUID_BUILDER_WALLET_UNFUNDED and orders proceed without builder attachment.
Preflight and delegationStatus (or agentWalletBootstrap) before live writes.
Amount and coin allowlists enforced by venue policy (allowedCoins, max notional).