Skip to main content
POST
Perps - Wallet Trade Fills
  • Returns historical perpetual trade fills for one Hyperliquid wallet.
  • Use sort_type to read fills 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.
  • Build a wallet’s perpetual execution history.
  • Analyze entry and exit activity, realized PnL, fees, and traded volume.
  • Support trader attribution, performance review, and position lifecycle analysis.
  • 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 fills first or sort_type=asc for chronological processing.
  • Persist the cursor when processing long histories.
  • Deduplicate by transaction hash when combining pages or polling repeatedly.
  • Combine fills with Wallet Open Positions to compare execution history with current 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 trade fills with certain fields

success
boolean
required
data
object
required