> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# User Positions Daily

> Per-user, per-coin Hyperliquid HIP-4 side-token balances at end of day.

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.

<Info>
  For USD aggregates use `open_interest_usd` from [Open Interest Daily](/historical-data/supported-blockchains/hyperliquid/predictions/open-interest-daily).
</Info>

## Table Columns

| Column Name    | Description                                                                                   |
| -------------- | --------------------------------------------------------------------------------------------- |
| project        | Top-level project namespace (`hyperliquid`).                                                  |
| protocol       | Protocol within the project (`hyperliquid_hip4`).                                             |
| chain          | The blockchain network (`hyperliquid`).                                                       |
| day            | Date bucket (UTC).                                                                            |
| user\_address  | User wallet address.                                                                          |
| coin           | HL-native side-token identifier (e.g. '#54760').                                              |
| encoding       | HL-canonical numeric encoding for the side-token.                                             |
| outcome\_id    | HIP-4 outcome identifier (shared by both token sides).                                        |
| token\_side    | Which side of the outcome's YES/NO pair the row represents (0 or 1).                          |
| side\_label    | Display label for this row's token\_side (e.g. 'Yes', 'No').                                  |
| token\_balance | User's end-of-day balance in this side-token. Only non-zero (positive) holdings are included. |
| outcome\_name  | Outcome display name from the HL API.                                                         |
| market\_title  | Human-readable market title.                                                                  |
| category       | Market type. One of 'price\_binary', 'categorical', 'binary'.                                 |
| sub\_category  | Underlying asset for Recurring outcomes (e.g. 'BTC'). NULL otherwise.                         |
| is\_recurring  | True for HL's auto-generated price-binary outcomes.                                           |
| question\_id   | Parent question ID. NULL for Recurring / orphan outcomes.                                     |
| question\_name | Question name from the HL API.                                                                |
| is\_winner     | True for the winning side of a settled outcome. NULL while unsettled.                         |
| expiry\_ts     | Resolution timestamp (UTC) for Recurring outcomes. NULL otherwise.                            |
| unique\_id     | Deterministic unique identifier per row.                                                      |
| \_created\_at  | Row creation timestamp.                                                                       |
| \_updated\_at  | Row last update timestamp.                                                                    |

## Sample Query

```sql theme={null}
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
```