Connect to Hyperliquid via Vezgo API

Data mapping

A field-level guide to the Vezgo API data for Hyperliquid — what each attribute means and where to read it — so you can map it into your own system.

How to read a transaction

Each value movement touching the connected account's spot balance maps to a single Vezgo transaction with one part. Read the movement from parts[0] and any fee from fees[]:

• Spot trades — a fill produces two Vezgo transactions, one per leg: the token bought (parts[0].direction "received") and the token paid with ("sent"). Both share the on-chain hash, with a -1 / -2 suffix in misc.origin_id distinguishing the legs; misc.origin_type is the fill direction (Buy, Sell, Spot Dust Conversion). They are not merged into a single trade transaction, so transaction_type is "other" — pair them on the hash prefix and read the direction from the part.
• Trading fee — fees[] on the first leg only, in the token Hyperliquid actually charged (USDC on most pairs, but the base token on others, e.g. a PURR or USOL fee).
• Transfers — user-to-user spot transfers, transfers between the spot and perps balances, and cross-dex sends. transaction_type is deposit or withdrawal and misc.origin_type names the ledger event (spotTransfer, accountClassTransfer, send).
• Staking — moving HYPE into the staking balance appears as a withdrawal from spot (misc.origin_type "cStakingTransfer", description "Stake HYPE"), and a completed unstake as a deposit back into spot ("Unstake HYPE"). Delegating between validators moves nothing in spot and is not reported.
• Other spot credits — genesis token distributions (misc.origin_type "spotGenesis"), HyperCore lending supply/withdraw ("borrowLend") and rewards claims ("rewardsClaim").

// One Vezgo transaction = one spot movement
const id   = tx.misc.origin_id;        // on-chain hash (fills add a -1 / -2 leg suffix)
const kind = tx.misc.origin_type;      // "Buy" | "Sell" | "spotTransfer" | "cStakingTransfer" | ...

const move = tx.parts?.[0];            // the movement: direction, ticker, amount
const fee  = tx.fees?.[0];             // trading fee, in the token it was charged in

// A spot trade is two transactions sharing the hash prefix — join them to rebuild the trade:
const [hash, leg] = String(id).split(/-(?=[12]$)/);

// Hyperliquid has no tokenTransfers / nftTransfers / internalTransfers arrays.