Ostium - Allium Documentation Hub

Ostium is an onchain perpetual futures protocol for crypto and real-world asset markets. Allium coverage is Ostium v1 on Arbitrum: listed markets, opens, closes, liquidations, fees, OLP vault deposits and withdrawals, daily open interest, TVL, and daily protocol metrics. Full chain docs: Arbitrum perpetuals. That schema also contains GMX and Variational Omni. Filter Ostium rows with project = 'ostium'. Ostium markets are identified by market_symbol. On trades and liquidations, market_address and asset_address are null because many Ostium markets are real-world assets with no token contract. On fees, asset_address is USDC (0xaf88d065e77c8cc2239327c5edb3a432268e5831). arbitrum.perpetuals.trades has one row per open, close, or liquidation. Collateral top-ups, collateral removals, and take-profit / stop-loss updates are not separate trades rows.

Schemas

Schema	Perpetual coverage	Docs
`arbitrum.perpetuals`	Listed markets, trades, liquidations, fees, OLP vault movements, daily open interest, TVL components, and daily metrics	markets · trades · liquidations · fees · open interest · user_actions · metrics_daily · overview

Size and open interest

Ostium size and open interest use the same product:

size_usd = collateral_usd × leverage

Use the published size_usd. On an open, leverage is the position leverage after the open. On a close or liquidation, leverage is the position leverage immediately before the close — not extra_fields.leverage, which is the remaining position after the event. Partial closes scale collateral and size by the closed fraction. Open interest on arbitrum.perpetuals.overview is the daily value of the same product, split into long and short. Per-market rows are in arbitrum.perpetuals.open_interest. Listed pairs are in arbitrum.perpetuals.markets.

Fees and revenue

arbitrum.perpetuals.fees has one row per fee event or non-zero execution spread. Use that table for fee-event grain. trades.fee_usd is the trade-level total and already includes execution spread.

fee_usd includes execution fees, rollover, signed funding, and execution spread. Funding keeps its sign: trader-paid is positive, rebate is negative.
On-chain raw priceImpactP is a percent with 18 decimals: size_usd × (priceImpactP / 1e18) / 100. extra_fields.price_impact_p on trades and extra_fields.spread_p on fees already store that percent without the 1e18 scale, so spread is size_usd × price_impact_p / 100 (or spread_p).
revenue_usd is the protocol-retained share: opening developer fees, oracle fees (refunds are negative), and execution spread from 2026-04-28 00:00 UTC. Before that timestamp, spread revenue_usd is 0. Close, builder, vault, rollover, funding, and liquidation components contribute 0 to revenue_usd.

OLP vault and TVL

arbitrum.perpetuals.user_actions for Ostium is OLP vault LP deposits and withdrawals (completed USDC movements). It is not trader margin posted against a position. arbitrum.perpetuals.metrics_daily is end-of-day USDC in the OLP vault (olp_vault) and TradingStorage (trading_storage). TVL on overview.total_tvl_usd is the sum of those two balances.

Sample Query

SELECT
  block_timestamp,
  trader,
  market_symbol,
  side,
  action,
  size_usd,
  collateral_usd,
  price_usd,
  pnl_usd,
  fee_usd,
  transaction_hash
FROM arbitrum.perpetuals.trades
WHERE block_date >= current_date - 30
  AND project = 'ostium'
ORDER BY block_timestamp DESC
LIMIT 100;

​Schemas

​Size and open interest

​Fees and revenue

​OLP vault and TVL

​Sample Query

Schemas

Size and open interest

Fees and revenue

OLP vault and TVL

Sample Query