Docs

usdSend payload - USD Transfers

Decode Hyperliquid `usdSend` payloads for USD transfers, returned through Dwellir's read-only L1 gRPC API.

Read-only action reference

Dwellir's Hyperliquid gRPC API returns this decoded action payload through StreamBlocks and GetBlock. It does not submit or execute this action. Submit supported user write actions through Hyperliquid's native POST /exchange endpoint.

The decoded usdSend payload records an internal USD transfer between Hyperliquid addresses.

Sample Data

JSON
{
  "signature": {
    "r": "0x2bb37a8b0c893d0e4a2f0e28e2411aad8fd31baeccb4188fb7aa58b92478ba96",
    "s": "0x6b806e50eabbfa1d275a0afc9e932296df700bc9022af48ef7b87e806da9b538",
    "v": 27
  },
  "action": {
    "type": "usdSend",
    "signatureChainId": "0xa4b1",
    "hyperliquidChain": "Mainnet",
    "destination": "0x192c181edebbad21a90e3aeec3519d30528c6d60",
    "amount": "17.18",
    "time": 1768146943132
  },
  "nonce": 1768146943132
}

View this transaction on Hypurrscan

Field Reference

Action Fields

FieldTypeDescription
typestringAlways "usdSend"
signatureChainIdstringChain ID for EIP-712 signing
hyperliquidChainstringTarget chain: "Mainnet" or "Testnet"
destinationstringRecipient's address
amountstringAmount in USD
timenumberTransaction timestamp

Use Cases

Internal Transfer Tracking

Monitor USD movements between accounts:

Python
def process_usdSend_action(action):
    destination = action.get('destination')
    amount = action.get('amount')
    print(f"USD transfer: ${amount} to {destination[:10]}...")