Docs
⌘ K

User Positions

GET/v1/hyperliquid/users/positions

Returns the current signed position (position_size) per coin for a user, reconstructed from the latest funding snapshot per (user, coin) pair. Positive position_size indicates a long position, negative indicates a short. Each row also carries the funding rate applied at that snapshot and the snapshot timestamp.

Filter by coin for a single coin, or dex to return only positions on one venue (xyz, cash, etc.).

Caveat: positions opened and fully closed between two funding snapshots are never observed during settlement and will not appear here.

Query Parameters

ParameterDescriptionValue
user
string

Filter by address

  • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
  • Format: evm-address
Required
coin
string

Hyperliquid coin identifier. Core perps have no prefix (BTC, HYPE); spot pairs use @N (@107); builder DEXs prefix the symbol with the DEX name (xyz:SILVER).

    dex
    string

    DEX identifier. perps for core perps, spot for @N spot pairs, or a builder DEX name (e.g. xyz, cash). New builder DEXs are added on Hyperliquid permissionlessly — call /v1/hyperliquid/dexes for the live set.

      limit
      integer

      Number of items* returned in a single request.
      *Plan restricted.

      • Default value: 10
      • Minimum value: 1
      • Maximum value: 1000
      page
      integer

      Page number to fetch.
      Empty data array signifies end of results.

      • Default value: 1
      • Minimum value: 1
      • Maximum value: 767465558638

      Potential Responses

      StatusDescription
      200

      Successful Response

      400

      Client side error

      401

      Authentication failed

      403

      Forbidden

      404

      Not found

      500

      Server side error