Hyperliquid Deposit
Deposit USDC into Hyperliquid for perpetual trading via cross-chain bridge (Relay Protocol). Accepts USDC from any supported chain (Arbitrum, Ethereum, Base, Polygon, Optimism, Avalanche). Ideal for: funding a new account, adding margin, and activating trading.
Catalog action Hyperliquid wallet
Deposit USDC into Hyperliquid for perpetual trading via cross-chain bridge (Relay Protocol). Accepts USDC from any supported chain (Arbitrum, Ethereum, Base, Polygon, Optimism, Avalanche). Ideal for: funding a new account, adding margin, and activating trading.
This action can require a wallet connector, gas, token movement, or an external side effect. Test with simulation or a controlled amount before using it in a live workflow.
At a Glance
| Field | Value |
|---|---|
| Action ID | hyperliquid-deposit |
| Category | Hyperliquid |
| Connector | wallet |
| Requires gas | No |
| Funds movement | None declared |
| Tags | hyperliquid, deposit, usdc, bridge |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
amount | string | Yes | Amount to deposit (human-readable, e.g., '100' for 100 USDC). Minimum 1 USDC equivalent. |
sourceChainId | number | No | Source chain to pull tokens from. Defaults to Arbitrum (42161). Supported: 1 (Ethereum), 10 (Optimism), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 43114 (Avalanche). |
sourceTokenAddress | string | No | Token address on the source chain to swap from. Defaults to USDC. When a non-USDC token is provided, Relay Protocol swaps it to USDC and bridges to Hyperliquid. |
amountRaw | string | No | Raw amount in the source token's smallest units (e.g., wei). Required when sourceTokenAddress is a non-USDC token. Overrides the amount field for relay execution. |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
status | string | Yes | Deposit outcome |
transactionHash | string | No | Transaction hash on the source chain |
depositedAmount | string | No | USDC amount deposited (human-readable) |
sourceChainId | number | No | Chain ID the USDC was bridged from |
isFirstDeposit | boolean | No | True if the Hyperliquid account had zero funds before this deposit |
Examples
json{ "type": "hyperliquid-deposit", "payload": { "amount": "1000000" }, "children": [], "connector": { "type": "wallet", "id": "conn_wallet" }}
bashcurl -X POST "https://api.b3os.org/v1/actions/hyperliquid-deposit/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "amount": "1000000" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.