Pinax
    Hyperliquid perpetual exchange data endpoints, plus API documentation and monitoring.
    Resources & endpoints
    Hyperliquid Users

    User Positions

    PREVIEW

    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.

    GET
    https://api.pinax.network/v1/hyperliquid/users/positions
    Requires bearer token — sign in to inject your team’s key.

    Required parameters

    NameTypeDescription
    userrequired
    query
    		string · evm-addressFilter by address
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    e.g. 0xd8da6bf26964af9d7eed9e03e53415d37aa96045

    Optional parameters

    NameTypeDescription
    coin
    query
    		stringHyperliquid coin id. Perps: BTC. Spot: @N (@107). Builder DEXs: xyz:SILVER. Outcome coins (#N) are rejected — use /v1/hyperliquid/outcomes/*.
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    e.g. BTC
    dex
    query
    		Enum · 9DEX identifier. perps for core perps, spot for @N spot pairs, or a builder DEX name (xyz, cash, …). Outcome markets are served separately under /v1/hyperliquid/outcomes/*.
    Single value or array of values* (separate multiple values with ,)
    *Plan restricted.
    perpsspotxyzcashkmhynaflxvntlpara
    limit
    query
    		integerNumber of items* returned in a single request.
    *Plan restricted.
    page
    query
    		integerPage number to fetch.
    Empty data array signifies end of results.

    Response

    200 OK
    {
  "data": [
    {
      "user": "0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00",
      "coin": "PUMP",
      "market_name": "PUMP",
      "dex": "perps",
      "position_size": -998618146,
      "funding_rate": 0.0000125,
      "last_update": "2026-04-30 23:00:00"
    }
  ]
}