Skip to main content

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.

The hyperliquid.unhydrated.perpetual_positions_eod table contains end-of-day perpetual position snapshots for every (user, type, coin) on Hyperliquid. One row per day, keeping the last snapshot of the day.

Table Columns

Identifiers

Column NameDescription
block_dateCalendar date of the position snapshot.
userUser wallet address.
typePosition type. Currently always ‘oneWay’.
coinCoin of the position.
timestampTimestamp of the last snapshot taken on this day.
_created_atRow creation timestamp.
_updated_atRow last update timestamp.

Position

Column NameDescription
sziSize of the position.
leverage_typeType of leverage used (e.g. ‘cross’, ‘isolated’).
leverage_valueLeverage multiplier.
entry_pxEntry price.
position_valuePosition value.
unrealized_pnlUnrealized PnL.
return_on_equityReturn on equity.
liquidation_pricePrice that would trigger liquidation.
margin_usedMargin used to maintain the position.
max_leverageMaximum leverage allowed for this position.

Funding

Column NameDescription
cumulative_funding_all_timeCumulative funding paid / received all time.
cumulative_funding_since_openCumulative funding paid / received since the position was opened.
cumulative_funding_since_changeCumulative funding paid / received since the last position change.

Sample Query

SELECT
  block_date,
  user,
  coin,
  szi,
  entry_px,
  position_value,
  unrealized_pnl
FROM hyperliquid.unhydrated.perpetual_positions_eod
WHERE block_date >= CURRENT_DATE - 7
ORDER BY block_date DESC, ABS(position_value) DESC
LIMIT 100