Skip to main content
This schema is currently in Beta.
The perpetuals vertical on Arbitrum contains position activity, liquidations, fees, and daily protocol metrics for on-chain perpetual futures protocols. Current coverage includes GMX (v1 and v2), Ostium v1, and Variational Omni. Each row is tagged with project, protocol, and version so you can filter to a specific protocol, and any fields unique to a protocol are available in the extra_fields column.

​
Trades

arbitrum.perpetuals.trades contains one row per position-change event (increase, decrease, or liquidation) for GMX and Ostium.

​
Liquidations

arbitrum.perpetuals.liquidations contains GMX and Ostium perpetual position liquidations, exposed with the same schema as arbitrum.perpetuals.trades.

​
Fees

arbitrum.perpetuals.fees contains one row per GMX or Ostium fee event, with the protocol revenue share. GMX fee_type values are position, liquidation, swap, mint, or redeem. Ostium fee_type is position or liquidation.

​
Metrics

arbitrum.perpetuals.overview contains daily protocol metrics per protocol: volume, open interest, fees, revenue, total value locked, and activity counts across GMX, Ostium, and Variational Omni.

​
Ostium

Ostium trades rows are opens, closes, and liquidations. Collateral top-ups, collateral removals, and take-profit / stop-loss updates are not separate trades rows. Ostium also exposes OLP collateral and on-chain TVL tables:
  • arbitrum.perpetuals.user_actions - user USDC deposits and withdrawals on the OLP vault (not trader margin).
  • arbitrum.perpetuals.metrics_daily - daily on-chain total value locked by component and token.

​
Variational Omni

Variational Omni also exposes settlement-pool, collateral-flow, and platform snapshot tables:
  • arbitrum.perpetuals.settlement_pools - one row per settlement pool holding user USDC collateral.
  • arbitrum.perpetuals.user_actions - user USDC collateral deposits and withdrawals.
  • arbitrum.perpetuals.metrics_daily - daily on-chain total value locked by component and token.
  • arbitrum.perpetuals.market_overview - hourly platform-level snapshots of volume, open interest, and TVL.
  • arbitrum.perpetuals.market_metrics - hourly per-market snapshots of mark price, open interest, funding, and quote depth.

​
Identity columns

Every table carries the following columns: Our Arbitrum Perpetuals schema contains the following tables: