---
title: "Hyperliquid wallet book"
method: GET
path: "/api/public/hyperliquid/wallet/{address}"
tags: ["Hyperliquid", "free"]
---

# Hyperliquid wallet book

`GET /api/public/hyperliquid/wallet/{address}`

## Request

- Base URL: `https://coinlobster.com`
- URL: `https://coinlobster.com/api/public/hyperliquid/wallet/{address}`
- Auth: none required

One account: live positions, equity, leverage, net bias, unrealized PnL and recent whale prints. Equity, positions and totals are the main market list; profile.dexBooks holds each builder-deployed list (stock, commodity and index markets such as xyz:NVDA) as its own book with its own collateral, never added into the main totals. The live book is public on Hyperliquid so it is keyless; computed history needs a plan.

## Path parameters

- `address` string, required

## Response `200`

Success

- object
  - `success` true, required
  - `data` HyperliquidPosition, required: Hyperliquid names the wallet on both sides of a fill, so a position is attributable to an account.
    - `coin` string
    - `base` string: Parsed symbol. A 1000-unit perp arrives as coin "kPEPE" with base "PEPE".
    - `side` 'long' | 'short'
    - `notionalUsd` number
    - `entryPx` number
    - `liquidationPx` number, nullable
    - `leverage` number, nullable
    - `unrealizedPnl` number, nullable
  - `meta` Meta: Present on every /api/ai/v1 response.
    - `timestamp` string, date-time: When this response was assembled, not when the data was measured.
    - `credits_used` integer: Credits this call spent. Absent on free surfaces and on keyless calls.
    - `credits_remaining` integer: Account balance after this call.
    - `deprecation` string: Present when the request used a deprecated form, e.g. the key in the query string.

---

[API](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api.md) · [All operations](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/revisions/a62c3a47523a?raw)