Skip to main content
POST
Perps - Wallet Transfers
  • Returns historical transfers associated with one Hyperliquid wallet.
  • Use sort_type to read transfers in ascending or descending time order.
  • Use the returned nextCursor as cursor in the next request.
  • limit defaults to 10 and supports up to 20 records per request.
  • This endpoint consumes 5 CU per request.
  • Track deposits, withdrawals, and internal asset movements for a perp wallet.
  • Reconcile wallet funding activity with trading and PnL changes.
  • Build transfer histories for trader research and operational monitoring.
  • Pass a Hyperliquid wallet address in the request body.
  • Start with an empty cursor and use nextCursor to continue pagination.
  • Use sort_type=desc for the newest transfers first or sort_type=asc for chronological processing.
  • Persist the cursor when processing long histories.
  • Use the transaction hash to reconcile transfer records with external transaction data.
  • Combine transfers with Wallet Overview and Trade Fills to explain changes in wallet exposure.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Body

application/json
wallet
string
required
Example:

"0x5b5d51203a0f9079f8aeb098a6523a13f298c060"

sort_type
enum<string>
default:desc
Available options:
asc,
desc
limit
integer
default:10
Required range: 1 <= x <= 20
cursor
string
default:""

Response

JSON object containing a list of transfers with certain fields

success
boolean
required
data
object
required