Tool reference

Tool names on this page are the 30 names that @phantom/mcp-server@1.2.9 returns from tools/list.

wallet_status reports the session stored on this machine. It does not prove that Phantom still accepts that session. Call wallet_addresses when you need a server-backed check.

solana_send, evm_send, and transfer use a simulation-first flow by default. Omit confirmed on the first call to preview the action, then pass confirmed: true only after the user approves the simulation.

Monad support has been deprecated.

Sui support has been deprecated.

BNB Smart Chain (BSC, eip155:56; chain ID 56) is not supported by the released MCP/CLI transaction tools. Use a supported network for the intended operation. Balance visibility and quote availability do not prove signing or sending support.

Wallet operations

wallet_status

Reads the session stored on this machine. It does not authenticate and it does not call Phantom. connected: true means the local session has a wallet id and an organization id. Call wallet_addresses when the server must accept the session. No parameters. The first tool call that needs the wallet after the server starts loads the stored session and checks it with Phantom. If Phantom rejects it with HTTP 401 or 403, the server deletes the session and opens the device-code sign-in in the browser. That call waits for approval and then continues. wallet_status does not run this check. After that startup check, on HTTP 401, the shared CLI wrapper refreshes the session once and retries that call. If the refresh fails, it clears the local session and returns AUTH_EXPIRED. Call login, then retry the original tool yourself. That wrapper only runs when the original HTTP error reaches it. In @phantom/cli@3.0.0, wallet_addresses catches the client error and throws a new error that keeps only the message, so the wrapper never sees status 401. A rejected session on that call fails as Failed to get wallet addresses: ..., with no refresh and no AUTH_EXPIRED. Call login and retry. The sign, send, and transfer handlers in that release replace errors the same way. This is a defect in the published package, not a difference in which tools exist. A transaction submission failure is separate from an expired session. HTTP 403 responses with type submission-failed, and errors with code -32009, stay submission errors. A rejected submission is not a reason to rotate the session.

wallet_addresses

Gets all blockchain addresses for the authenticated embedded wallet (Solana, Ethereum, Bitcoin, Sui). Sui address output has been deprecated.

Parameter	Type	Required	Description
`derivationIndex`	number	No	Derivation index for the addresses (default: `0`)

Example response:

{
  "walletId": "05307b6d-2d5a-43d6-8d11-08db650a169b",
  "addresses": [
    { "addressType": "Solana", "address": "H8FpYTgx4Uy9aF9Nk9fCTqKKFLYQ9KfC6UJhMkMDzCBh" },
    { "addressType": "Ethereum", "address": "0x8d8b06e017944f5951418b1182d119a376efb39d" },
    { "addressType": "BitcoinSegwit", "address": "bc1qkce5fvaxe759yu5xle5axlh8c7durjsx2wfhr9" },
    { "addressType": "Sui", "address": "0x039039cf69a336cb84e4c1dbcb3fa0c3f133d11b8146c6f7ed0d9f6817529a62" }
  ]
}

wallet_balances

Returns token holdings for the authenticated wallet with live USD pricing via the Phantom portfolio API.

Parameter	Type	Required	Description
`networks`	string[]	No	Filter by network names (for example `["solana", "ethereum", "base", "polygon", "arbitrum", "bitcoin"]`). Omit to return balances across the portfolio networks. `arbitrum` remains a balance filter. Sends on Arbitrum are rejected. The `monad` and `sui` filters have been deprecated.

solana_send

Simulates, signs, and broadcasts a Solana transaction.

Parameter	Type	Required	Description
`transaction`	string	Yes	Base64-encoded transaction (standard base64 with `A-Za-z0-9+/=`)
`networkId`	string	No	Solana network identifier (e.g., `solana:mainnet`). Defaults to `solana:mainnet`.
`derivationIndex`	number	No	Derivation index for the account (default: `0`)
`walletId`	string	No	Wallet ID to use for signing (defaults to authenticated wallet)
`confirmed`	boolean	No	Omit to simulate first. Set to `true` only after the user approves the preview.

Example request:

{
  "transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQABAgMEBQYH...",
  "networkId": "solana:mainnet"
}

evm_send

Simulates, signs, and broadcasts an EVM transaction with automatic gas estimation.

Parameter	Type	Required	Description
`chainId`	number \| string	Yes	EVM chain ID (e.g., `1`, `"8453"`, or `"0x2105"`)
`to`	string	No	Destination address (`0x`-prefixed)
`value`	string	No	Value in wei as a hex string (e.g., `"0x0"`)
`data`	string	No	Calldata as a hex string
`gas`	string	No	Gas limit as a hex string. Auto-estimated with a 20% buffer if omitted.
`gasLimit`	string	No	Alias for `gas` — accepted directly from DeFi aggregator responses (e.g. LI.FI). If both `gas` and `gasLimit` are provided, `gas` takes precedence.
`gasPrice`	string	No	Legacy gas price in wei
`maxFeePerGas`	string	No	EIP-1559 max fee per gas
`maxPriorityFeePerGas`	string	No	EIP-1559 priority fee
`nonce`	string	No	Transaction nonce. Auto-fetched if omitted.
`type`	string	No	Transaction type such as `"0x2"`
`derivationIndex`	number	No	Derivation index for the account (default: `0`)
`walletId`	string	No	Wallet ID to use for signing (defaults to authenticated wallet)
`confirmed`	boolean	No	Omit to simulate first. Set to `true` only after the user approves the preview.

Chain reads use the SDK endpoint for the selected network. rpcUrl is not an input. Arbitrum (chainId 42161) is rejected before signing. BNB Smart Chain (chainId 56, eip155:56) is unsupported and fails before signing. See the supported networks. Example request:

{
  "chainId": 8453,
  "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "value": "0x2386F26FC10000",
  "data": "0x"
}

solana_sign

Signs a UTF-8 message on Solana.

Parameter	Type	Required	Description
`message`	string	Yes	The UTF-8 message to sign
`networkId`	string	Yes	Solana network identifier (e.g., `solana:mainnet`)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)
`walletId`	string	No	Wallet ID to use (defaults to authenticated wallet)

evm_sign

Signs a UTF-8 message using EIP-191 personal signing for EVM chains.

Parameter	Type	Required	Description
`message`	string	Yes	The UTF-8 message to sign
`chainId`	number	Yes	EVM chain ID (e.g., `1` for Ethereum, `8453` for Base)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)
`walletId`	string	No	Wallet ID to use (defaults to authenticated wallet)

evm_sign-typed

Signs structured data using EIP-712 for EVM chains. Used for DeFi permits and other typed data flows.

Parameter	Type	Required	Description
`typedData`	object	Yes	EIP-712 typed data object
`chainId`	number	Yes	EVM chain ID (e.g., `1` for Ethereum, `8453` for Base)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)
`walletId`	string	No	Wallet ID to use (defaults to authenticated wallet)

simulate

Simulates a transaction and returns expected asset changes, security warnings, and blocking conditions without submitting on-chain. Use this to preview what a transaction will do before signing or sending. Supports Solana, EVM (Ethereum, Base, Polygon), Bitcoin, and an Arbitrum preview. Sending on Arbitrum is rejected. Monad and Sui simulation support have been deprecated. The userAccount wallet address is auto-derived from the authenticated session for Solana and EVM chains. Supply it explicitly for Sui and Bitcoin.

Parameter	Type	Required	Description
`chainId`	string	Yes	CAIP-2 chain ID (e.g., `solana:mainnet`, `eip155:1`, `eip155:8453`, `sui:mainnet`)
`type`	string	Yes	`transaction` or `message`
`params`	object	Yes	Chain-specific transaction parameters (see below)
`url`	string	No	dApp origin URL where the transaction originates (e.g., `https://jup.ag`)
`context`	string	No	Transaction context hint: `swap`, `bridge`, `send`, or `gaslessSwap`
`userAccount`	string	No	Wallet address to simulate for. Auto-derived for Solana and EVM chains.
`language`	string	No	Response language code (e.g., `en`, `es`, `ja`). Defaults to `en`.
`derivationIndex`	number	No	Derivation index for address lookup (default: `0`)
`walletId`	string	No	Wallet ID override (defaults to authenticated wallet)

Chain-specific params shapes:

Solana: { transactions: ["<base58>"] }
EVM: { transactions: [{ from, to, value, data, chainId, type }] }
Sui: { rawTransaction: "<bytes>" }
Bitcoin: { transaction: "<raw>", userAddresses?: ["bc1q..."] }
EVM message: { message: "0x..." }

Response shape

The result is a discriminated union on type ("transaction" or "message") with a strongly typed schema. Treat any non-empty block as a blocking condition that should prevent signing or sending.

Field	Type	Description
`type`	`"transaction"` \| `"message"`	Discriminator matching the request `type`.
`block`	object \| null	Blocking warning that should prevent the action. Omitted or `null` when safe.
`expectedChanges`	array	Asset and message changes the user can expect.
`warnings`	array	Non-blocking advisory warnings.
`advancedDetails`	object \| null	Chain-specific details for transaction or message scanning.
`error`	string \| null	Error message for transactions, or a `SimulationErrorCode` enum for messages.
`simulationError`	object \| null	Optional transaction simulation error details.
`occurredSlippage`	number \| null	Optional slippage value for swap-context transaction simulations.

Each expectedChanges[] entry is one of:

type: "AssetChange" - name, changeText, changeSign (PLUS | MINUS | EQUAL), asset ({ type: "fungible" | "collectible" | "native" | "unknown", symbol, decimals, amount, usdValue? }), changeType (approval | revokal | transfer | mint | unknown), and optional image, context, metadata.
type: "MessageOnly" - message, fallbackMessage, changeType, and optional image, context, metadata.

Each warning (block or warnings[]) has { message, severity, kind? }. severity is an integer where lower numbers are more severe:

Severity	Meaning
`1`	Critical alert
`2`	Alert
`3`	Critical error
`4`	Error

advancedDetails shape depends on the chain and request type:

EVM transaction: { chainId, advancedRows, gas, gasLimit, tokenChange?, contractAddresses }. Each contract address has a type of spender, contract, or unknown.
Solana transaction: { chainId, tokenChange, advancedRows, requestId, safeguard?, totalFee, feePayers }.
Sui transaction: { chainId, tokenChange, requestId, gas: { computationCost, storageCost, storageRebate, nonRefundableStorageFee, totalGasUsed } }.
Bitcoin transaction: { inputs, outputs } with amounts in satoshis.
EVM message: { contractAddress }.
Solana message: { errorSignInWithSolana }.

Example transaction response (EVM transfer):

{
  "type": "transaction",
  "expectedChanges": [
    {
      "type": "AssetChange",
      "name": "Ether",
      "changeText": "-0.001 ETH",
      "changeSign": "MINUS",
      "changeType": "transfer",
      "fallbackMessage": "Send 0.001 ETH",
      "asset": {
        "type": "native",
        "symbol": "ETH",
        "decimals": 18,
        "amount": "1000000000000000",
        "usdValue": 2.19
      }
    }
  ],
  "warnings": [],
  "advancedDetails": {
    "chainId": "eip155:8453",
    "advancedRows": [],
    "gas": [21000],
    "gasLimit": 21000,
    "contractAddresses": []
  }
}

Example blocking response (malicious approval):

{
  "type": "transaction",
  "block": {
    "message": "This transaction grants unlimited spending approval to a flagged address.",
    "severity": 1,
    "kind": "malicious_approval"
  },
  "expectedChanges": [],
  "warnings": []
}

evm_allowance

Returns the ERC-20 token allowance granted by an owner address to a spender address on any supported EVM chain. Use this before a swap to check whether an approval transaction is needed. When ownerAddress is omitted, the authenticated wallet address is used automatically.

Parameter	Type	Required	Description
`chainId`	number \| string	Yes	EVM chain ID (e.g., `8453` for Base, `1` for Ethereum). Accepts a number, decimal string, or hex string (e.g., `"0x2105"`).
`tokenAddress`	string	Yes	ERC-20 token contract address (`0x`-prefixed)
`spenderAddress`	string	Yes	Address of the spender to check allowance for (e.g., a swap router)
`ownerAddress`	string	No	Address of the token owner. Defaults to the authenticated wallet address.
`walletId`	string	No	Wallet ID (defaults to authenticated wallet). Only used when `ownerAddress` is omitted.
`derivationIndex`	number	No	Derivation index for the account (default: `0`). Only used when `ownerAddress` is omitted.

Allowance reads use the SDK endpoint for chainId. rpcUrl is not an input. Example response:

{
  "chainId": 1,
  "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "ownerAddress": "0xf81ea875f910eaf8e9b27167f018d0e1b696963a",
  "spenderAddress": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
  "allowance": "0",
  "allowanceHex": "0x0"
}

transfer

Transfers native tokens or SPL/ERC-20 tokens across Solana and supported EVM networks using a simulation-first flow.

Parameter	Type	Required	Description
`networkId`	string	Yes	Network identifier (e.g., `solana:mainnet`, `eip155:1`)
`to`	string	Yes	Recipient address
`amount`	string	Yes	Transfer amount as a string (e.g., `"0.5"`)
`amountUnit`	string	No	`ui` for token units, `base` for atomic units (default: `ui`)
`tokenMint`	string	No	SPL mint or ERC-20 contract address. Omit for native token transfers
`decimals`	number	No	Token decimals. Required for ERC-20 transfers when `amountUnit` is `ui`
`derivationIndex`	number	No	Derivation index for the account (default: `0`)
`walletId`	string	No	Wallet ID to use (defaults to authenticated wallet)
`createAssociatedTokenAccount`	boolean	No	Solana only. Create destination ATA if missing (default: `true`)
`confirmed`	boolean	No	Omit to simulate first. Set to `true` only after the user approves the preview.

Chain reads use the SDK endpoint for networkId. rpcUrl is not an input. Arbitrum (eip155:42161) is rejected before signing. BNB Smart Chain (eip155:56) is unsupported and fails before signing. See the supported networks. Example (SOL transfer):

{
  "networkId": "solana:mainnet",
  "to": "H8FpYTgx4Uy9aF9Nk9fCTqKKFLYQ9KfC6UJhMkMDzCBh",
  "amount": "0.1"
}

Swaps and portfolio

buy

No fees on swaps. Phantom does not charge transaction fees, platform fees, or commission on swaps executed through the MCP server. Your users keep what they swap. Fetches a swap quote from the Phantom routing engine for Solana, supported EVM networks, and cross-chain swaps. Optionally signs and sends the initiation transaction when execute: true.

Cross-chain swaps work in both directions: Solana to EVM and EVM to Solana. Cross-chain swaps can also target Hypercore/Hyperliquid when supported.

Parameter	Type	Required	Description
`amount`	string	Yes	Sell amount (e.g., `"0.5"`)
`sellChainId`	string	No	CAIP-2 chain ID for the sell token (default: `solana:mainnet`)
`buyChainId`	string	No	CAIP-2 chain ID for the buy token (defaults to `sellChainId`; set a different value for cross-chain swaps)
`buyTokenMint`	string	No	Token to buy. Solana mint address or EVM `0x` contract address (omit for native token)
`buyTokenIsNative`	boolean	No	`true` to buy the native token of the destination chain
`sellTokenMint`	string	No	Token to sell. Solana mint address or EVM `0x` contract address (omit for native token)
`sellTokenIsNative`	boolean	No	`true` to sell the native token (default when `sellTokenMint` is omitted)
`amountUnit`	string	No	`ui` for token units, `base` for atomic units (default: `base`)
`sellTokenDecimals`	number	No	Decimals for the sell token. Required for EVM tokens when `amountUnit` is `ui`
`buyTokenDecimals`	number	No	Decimals for the buy token. Required for EVM tokens when `amountUnit` is `ui` and `exactOut` is `true`
`slippageTolerance`	number	No	Slippage tolerance in percent (0–100)
`autoSlippage`	boolean	No	Enable automatic slippage calculation (default: `true`)
`exactOut`	boolean	No	If `true`, treat `amount` as the buy amount rather than the sell amount
`execute`	boolean	No	If `true`, sign and send the initiation transaction immediately. Default: `false`, which returns the quote only.
`base64EncodedTx`	boolean	No	Solana only. Include base64-encoded transaction data in the quote response (default: `false`)
`taker`	string	No	Override the taker address
`derivationIndex`	number	No	Derivation index for the taker address (default: `0`)
`walletId`	string	No	Wallet ID to use (defaults to authenticated wallet)

Quotes use the SDK endpoint for the selected network. rpcUrl and quoteApiUrl are not inputs. Arbitrum is rejected as a sell or buy chain. BNB Smart Chain (eip155:56) is unsupported; do not use it as a sell or buy chain. Example (Solana swap: sell SOL for USDC):

{
  "amount": "0.1",
  "sellChainId": "solana:mainnet",
  "sellTokenIsNative": true,
  "buyTokenMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "amountUnit": "ui",
  "execute": true
}

Example (cross-chain swap: sell SOL for ETH on Base):

{
  "amount": "0.5",
  "sellChainId": "solana:mainnet",
  "sellTokenIsNative": true,
  "buyChainId": "eip155:8453",
  "buyTokenIsNative": true,
  "amountUnit": "ui",
  "execute": true
}

wallet_rebalance

Analyzes portfolio allocation and rebalances via token swaps. No fees on any swaps executed during rebalancing. Portfolio rebalancing uses the same zero-fee swap routing as buy. Analyzes portfolio allocation and rebalances to target percentages via token swaps. Currently supports Solana only. Uses a two-phase flow: call with phase: "analyze" to inspect current allocations, then phase: "execute" with targetAllocations to rebalance. Pass dryRun in the execute phase to preview without executing.

Parameter	Type	Required	Description
`phase`	string	Yes	`analyze` to view current allocations, `execute` to rebalance
`targetAllocations`	array	No	Required for `execute` phase. Array of `{caip19, targetPercent, symbol?}` objects. Percentages must sum to 100.
`dryRun`	string	No	`"true"` during the `execute` phase returns the swap plan without executing (default: `false`)
`slippageTolerance`	number	No	Slippage tolerance in percent for each swap (default: `1`)
`minTradeUsd`	number	No	Minimum USD value for a trade to execute (default: `1.0`)
`network`	string	No	Network to rebalance on. Currently only `solana` is supported (default: `solana`).
`walletId`	string	No	Wallet ID to use (defaults to authenticated wallet)

Session and billing

Re-authenticates with Phantom. Use this to log in for the first time, switch accounts, or refresh an expired session.

Parameter	Type	Required	Description
`displayMode`	string	No	`browser` (default) opens the authorization URL. `text` returns the device-code prompt as text for a headless session.

logout

Clears the stored session and credentials from disk. It does not call Phantom. The next tool call needs a new login. No parameters.

price

Returns the portfolio price for one token.

Parameter	Type	Required	Description
`address`	string	Yes	Token mint or contract address. Pass `native` for the chain’s native token.
`chain`	string	Yes	`solana`, `ethereum`, `base`, `polygon`, `arbitrum`, `bitcoin`, `sui`, or `monad`. `monad` and `sui` are deprecated. `arbitrum` is a price lookup, not a send network.
`currency`	string	No	ISO 4217 currency code. Default: `USD`.

pay

Pays for daily API access when another tool returns API_PAYMENT_REQUIRED. Pass the preparedTx value from that error response, then retry the original tool call.

Parameter	Type	Required	Description
`preparedTx`	string	Yes	Base64-encoded unsigned Solana transaction returned by the API payment error
`derivationIndex`	number	No	Derivation index for the account (default: `0`)
`walletId`	string	No	Wallet ID to use (defaults to authenticated wallet)

Perpetuals

Looking for a Hyperliquid-focused walkthrough instead of the full tool catalog? See the dedicated perps tools guide.

Read-only

Tool	Description
`perps_markets`	Returns available perp markets with price, funding, open interest, 24h volume, and max leverage
`perps_account`	Returns perp account balance and available trading margin
`perps_positions`	Returns open positions with size, direction, leverage, unrealized PnL, and liquidation price
`perps_orders`	Returns open perp orders such as limit, TP, and SL orders
`perps_history`	Returns historical fills with fees and closed PnL

All five accept an optional walletId. All except perps_markets also accept an optional derivationIndex (default: 0).

perps_deposit

Bridges tokens from an external chain (Solana, Base, Ethereum, Polygon) into Hyperliquid as USDC via cross-chain swap. Uses a quote-first flow by default. Arbitrum is rejected as a source chain. BNB Smart Chain (eip155:56) is unsupported; do not use it as a source chain.

Parameter	Type	Required	Description
`sourceChainId`	string	Yes	Source chain CAIP-2 ID (for example `"solana:mainnet"`, `"eip155:8453"`, `"eip155:1"`, `"eip155:137"`). Arbitrum (`eip155:42161`) is rejected. BNB Smart Chain (`eip155:56`) is unsupported.
`amount`	string	Yes	Amount to send in human-readable units (e.g. `"100"` for 100 USDC, `"0.5"` for 0.5 SOL)
`sellTokenMint`	string	Conditional	Token contract/mint address to sell. Required unless `sellTokenIsNative` is `true`; the released handler does not supply a default token.
`sellTokenIsNative`	boolean	No	Sell the native token. Default: `false`.
`sellTokenDecimals`	number	Conditional	Required for EVM ERC-20 deposits (for example, `6` for USDC). `perps_deposit` always interprets `amount` in human-readable units.
`execute`	boolean	No	If `false` (default), returns the quote only. If `true`, signs and broadcasts immediately.
`walletId`	string	No	Wallet ID (defaults to authenticated wallet)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)

Example (deposit SOL into Hyperliquid as USDC):

{
  "sourceChainId": "solana:mainnet",
  "amount": "10",
  "sellTokenIsNative": true,
  "execute": true
}

perps_open

Opens a market or limit long/short perpetual position.

Parameter	Type	Required	Description
`market`	string	Yes	Market symbol (e.g. `"BTC"`, `"ETH"`, `"SOL"`)
`direction`	string	Yes	`"long"` or `"short"`
`sizeUsd`	number	Yes	Position size in USD (for example `100` for $100 notional value)
`leverage`	number	Yes	Leverage multiplier (e.g. `1` for 1x, `10` for 10x)
`orderType`	string	Yes	`"market"` or `"limit"`
`limitPrice`	number	No	Required when `orderType` is `"limit"`. Positive limit price, for example `50000`.
`marginType`	string	No	`"isolated"` (default) or `"cross"`
`reduceOnly`	boolean	No	When `true`, the order can only reduce an existing position. Default: `false`.
`walletId`	string	No	Wallet ID (defaults to authenticated wallet)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)

Example (market long):

{
  "market": "ETH",
  "direction": "long",
  "sizeUsd": 100,
  "leverage": 5,
  "orderType": "market"
}

perps_close

Closes a perpetual position fully or partially.

Parameter	Type	Required	Description
`market`	string	Yes	Market symbol of the position to close (e.g. `"BTC"`)
`sizePercent`	number	No	Percentage of position to close (0–100, default: `100` for full close)
`walletId`	string	No	Wallet ID (defaults to authenticated wallet)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)

perps_cancel

Cancels an open perpetual order by ID.

Parameter	Type	Required	Description
`market`	string	Yes	Market symbol (e.g. `"BTC"`)
`orderId`	integer	Yes	The numeric order ID to cancel (from `perps_orders`)
`walletId`	string	No	Wallet ID (defaults to authenticated wallet)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)

perps_leverage

Updates leverage and margin mode for a market.

Parameter	Type	Required	Description
`market`	string	Yes	Market symbol (e.g. `"BTC"`)
`leverage`	number	Yes	Leverage multiplier (e.g. `1` for 1x, `10` for 10x)
`marginType`	string	Yes	`"cross"` or `"isolated"`
`walletId`	string	No	Wallet ID (defaults to authenticated wallet)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)

perps_transfer

Moves USDC from Hypercore spot into the perps margin account.

Parameter	Type	Required	Description
`amountUsdc`	string	Yes	Amount of USDC to move from spot to perps (e.g. `"100"` for 100 USDC)
`walletId`	string	No	Wallet ID (defaults to authenticated wallet)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)

perps_withdraw

Bridges USDC from the Hyperliquid perpetuals account to an external chain (Solana, Base, Ethereum, Arbitrum, Polygon) via the Relay bridge.

Parameter	Type	Required	Description
`amountUsdc`	string	Yes	Amount of USDC to withdraw (e.g. `"50"` for 50 USDC)
`destinationChainId`	string	Yes	Destination chain CAIP-2 ID (e.g. `"solana:mainnet"`, `"eip155:8453"`, `"eip155:1"`, `"eip155:42161"`, `"eip155:137"`)
`buyToken`	string	No	CAIP-19 token to receive on the destination chain. Defaults to USDC on the destination chain if omitted.
`walletId`	string	No	Wallet ID (defaults to authenticated wallet)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)

Example:

{
  "amountUsdc": "50",
  "destinationChainId": "solana:mainnet"
}

perps_deposit and perps_withdraw-hl-spot return a quote until you pass execute: true. The other perp write tools submit the signed action on the call. Use perps_markets, perps_account, and perps_positions first to verify the intended trade.

Funding flow

Moving funds in and out of perps is a two-step process: Deposit chain (external → perps):

perps_deposit — bridges tokens from Solana, Base, Ethereum, or Polygon into Hyperliquid as USDC. Arbitrum is rejected as a source chain. BNB Smart Chain (eip155:56) is unsupported; do not use it as a source chain.
perps_transfer — moves USDC from Hyperliquid spot into the perps margin account.

Withdraw chain (perps → external):

perps_withdraw — bridges USDC from perps directly to the destination chain in one step.

perps_withdraw-hl-spot

Bridges USDC from the Hyperliquid spot account to an external chain. Funds must already be in spot. Arbitrum is a valid destination here.

Parameter	Type	Required	Description
`amountUsdc`	string	Yes	USDC amount to bridge, for example `"8.0"`.
`destinationChainId`	string	Yes	Destination CAIP-2 id, including `eip155:42161` for Arbitrum.
`buyToken`	string	No	CAIP-19 token to receive. Defaults to USDC on the destination chain.
`execute`	boolean	No	`false` (default) returns the quote. `true` signs and broadcasts.
`walletId`	string	No	Wallet ID (defaults to authenticated wallet)
`derivationIndex`	number	No	Derivation index for the account (default: `0`)

The CLI command is phantom perps withdraw-hl-spot. Arbitrum remains a valid bridge destination for this withdrawal and for perps_withdraw.

Supported networks

Network identifiers follow the CAIP-2/CAIP-10 format.

Solana

Network	Identifier
Mainnet	`solana:mainnet`
Devnet	`solana:devnet`
Testnet	`solana:testnet`

Ethereum and EVM networks

Network	Identifier
Ethereum Mainnet	`eip155:1`
Ethereum Sepolia	`eip155:11155111`
Polygon Mainnet	`eip155:137`
Polygon Amoy	`eip155:80002`
Base Mainnet	`eip155:8453`
Base Sepolia	`eip155:84532`
Robinhood Chain	`eip155:4663`
Robinhood Chain Testnet	`eip155:46630`
Monad (deprecated)	`eip155:143`
Monad Testnet (deprecated)	`eip155:10143`

Arbitrum One (eip155:42161) and Arbitrum Sepolia (eip155:421614) stay in the CLI for Hyperliquid EIP-712 signing, portfolio balance reads, and withdraw bridge destinations. transfer, evm_send, buy, and perps_deposit reject them. BNB Smart Chain (BSC, eip155:56; chain ID 56) is not supported by the released MCP/CLI transaction tools. The same EVM address can receive assets on BSC without the MCP being able to move them. Balance visibility and quote availability do not establish signing or sending support.

Bitcoin

Network	Identifier
Mainnet	`bip122:000000000019d6689c085ae165831e93`

Sui (deprecated)

Network	Identifier
Mainnet	`sui:mainnet`
Testnet	`sui:testnet`

Overview

Setup and reference

Wallet operations

wallet_status

wallet_addresses

wallet_balances

solana_send

evm_send

solana_sign

evm_sign

evm_sign-typed

simulate

Response shape

evm_allowance

transfer

Swaps and portfolio

buy

wallet_rebalance

Session and billing

logout

price

pay

Perpetuals

Read-only

perps_deposit

perps_open

perps_close

perps_cancel

perps_leverage

perps_transfer

perps_withdraw

Funding flow

perps_withdraw-hl-spot

Supported networks

Solana

Ethereum and EVM networks

Bitcoin

Sui (deprecated)

​Wallet operations

​wallet_status

​wallet_addresses

​wallet_balances

​solana_send

​evm_send

​solana_sign

​evm_sign

​evm_sign-typed

​simulate

​Response shape

​evm_allowance

​transfer

​Swaps and portfolio

​buy

​wallet_rebalance

​Session and billing

​login

​logout

​price

​pay

​Perpetuals

​Read-only

​perps_deposit

​perps_open

​perps_close

​perps_cancel

​perps_leverage

​perps_transfer

​perps_withdraw

​Funding flow

​perps_withdraw-hl-spot

​Supported networks

​Solana

​Ethereum and EVM networks

​Bitcoin

​Sui (deprecated)

Wallet operations

wallet_status

wallet_addresses

wallet_balances

solana_send

evm_send

solana_sign

evm_sign

evm_sign-typed

simulate

Response shape

evm_allowance

transfer

Swaps and portfolio

buy

wallet_rebalance

Session and billing

login

logout

price

pay

Perpetuals

Read-only

perps_deposit

perps_open

perps_close

perps_cancel

perps_leverage

perps_transfer

perps_withdraw

Funding flow

perps_withdraw-hl-spot

Supported networks

Solana

Ethereum and EVM networks

Bitcoin

Sui (deprecated)