User Positions Daily 🌱 - Allium Documentation Hub

The hyperliquid.predictions.user_positions_daily table contains one row per (day, user, coin) for every user holding a non-zero balance on a Hyperliquid HIP-4 side-token. Settled outcomes are excluded from the settlement day onward.

Table Details

Property	Value
Table Name	`hyperliquid.predictions.user_positions_daily`
Table Status	Beta 🌱
Unique Key	`day`, `user_address`, `coin`

For USD aggregates use open_interest_usd from Open Interest Daily.

Table Columns

Column Name	Data Type	Description
project	VARCHAR(16777216)	Top-level project namespace (`hyperliquid`).
protocol	VARCHAR(16777216)	Protocol within the project (`hyperliquid_hip4`).
chain	VARCHAR(16777216)	The blockchain network (`hyperliquid`).
day	DATE	Date bucket (UTC).
user_address	VARCHAR(16777216)	User wallet address.
coin	VARCHAR(16777216)	HL-native side-token identifier (e.g. ‘#54760’).
encoding	NUMBER(38,0)	HL-canonical numeric encoding for the side-token.
outcome_id	NUMBER(38,0)	HIP-4 outcome identifier (shared by both token sides).
token_side	NUMBER(38,0)	Which side of the outcome’s YES/NO pair the row represents (0 or 1).
side_label	VARCHAR(16777216)	Display label for this row’s token_side (e.g. ‘Yes’, ‘No’).
token_balance	NUMBER(22,10)	User’s end-of-day balance in this side-token. Only non-zero (positive) holdings are included.
outcome_name	VARCHAR(16777216)	Outcome display name from the HL API.
market_title	VARCHAR(16777216)	Human-readable market title.
category	VARCHAR(16777216)	Market type. One of ‘price_binary’, ‘categorical’, ‘binary’.
sub_category	VARCHAR(16777216)	Underlying asset for Recurring outcomes (e.g. ‘BTC’). NULL otherwise.
is_recurring	BOOLEAN	True for HL’s auto-generated price-binary outcomes.
question_id	NUMBER(38,0)	Parent question ID. NULL for Recurring / orphan outcomes.
question_name	VARCHAR(16777216)	Question name from the HL API.
is_winner	BOOLEAN	True for the winning side of a settled outcome. NULL while unsettled.
expiry_ts	TIMESTAMP_NTZ(9)	Resolution timestamp (UTC) for Recurring outcomes. NULL otherwise.
unique_id	VARCHAR(16777216)	Deterministic unique identifier per row.
_created_at	TIMESTAMP_NTZ(9)	Row creation timestamp.
_updated_at	TIMESTAMP_NTZ(9)	Row last update timestamp.

Sample Query

SELECT
  day,
  user_address,
  coin,
  side_label,
  token_balance,
  market_title
FROM hyperliquid.predictions.user_positions_daily
WHERE day >= CURRENT_DATE - 7
  AND user_address = '<user_address_to_search>'
ORDER BY day DESC, coin
LIMIT 200