Kafka Schema
Topic Name | Description |
---|---|
blocks | Block metadata |
transactions | Block Transaction data |
trades | Includes both the seller and the buyer in the same record. Missing some fields when compared to fills. |
fills | One record for the seller and one record for the buyer. When you have both, you have the trade. It includes extra fields when compared to the trade topic. |
orders | Real-time order data with status changes. Complete visibility as orders progress through their lifecycle. |
misc_events | User events in hyperliquid, including - Funding fees - Backstop liquidations by the HLP Vault - Vault deposits and withdrawals - Transfers - Validator actions and rewards |
Example Data for each Topic
Blocks
Transactions
Raw transaction data from hyperliquid.Cancel Order
a
is an index to an asset that is traded on Hyperliquid. Click through for more information on assets.
Trades
Contains data from both sides of a tradeFills
Contains only one side of a trade, but with a lot more information than what is contained in the trades. FillTrade Fills
Trade fills is the trades topic enhanced with the fills. However currently we are unable to always get all the fills for a trade. If you absolutely require the fill, then it is better to use the fills topic which will always be complete.Misc Events
Event TypesType | Description | Where Clause |
---|---|---|
accountActivationGas | event:LedgerUpdate:delta:type = ‘accountActivationGas’ | |
accountClassTransfer | Moving from Perpetuals balance to Spot balance and vice versa | event:LedgerUpdate:delta:type = ‘accountClassTransfer’ |
deployGasAuction | event:LedgerUpdate:delta:type = ‘deployGasAuction’ | |
deposit | deposits from arbitrum | event:LedgerUpdate:delta:type = ‘deposit’ |
internalTransfer | usdc transfers from one perpetual account to another | event:LedgerUpdate:delta:type = ‘internalTransfer’ |
liquidation | event:LedgerUpdate:delta:type = ‘liquidation’ | |
rewardsClaim | event:LedgerUpdate:delta:type = ‘rewardsClaim’ | |
spotGenesis | event:LedgerUpdate:delta:type = ‘spotGenesis’ | |
spotTransfer | spot token transfers | event:LedgerUpdate:delta:type = ‘spotTransfer’ |
subAccountTransfer | transfer to subaccounts | event:LedgerUpdate:delta:type = ‘subAccountTransfer’ |
vaultCreate | event:LedgerUpdate:delta:type = ‘vaultCreate’ | |
vaultDeposit | deposits into vaults | event:LedgerUpdate:delta:type = ‘vaultDeposit’ |
vaultDistribution | event:LedgerUpdate:delta:type = ‘vaultDistribution’ | |
vaultLeaderCommission | event:LedgerUpdate:delta:type = ‘vaultLeaderCommission’ | |
vaultWithdraw | withdrawals from vaults | event:LedgerUpdate:delta:type = ‘vaultWithdraw’ |
withdraw | withdraws to arbitrum | event:LedgerUpdate:delta:type = ‘withdraw’ |
CDeposit | Staking Deposit | event:CDeposit IS NOT NULL |
CWithdrawal | Staking Withdrawal | event:CWithdrawal IS NOT NULL |
Delegation | event:Delegation IS NOT NULL | |
Funding | Funding fee | event:Funding IS NOT NULL |
ValidatorRewards | event:ValidatorRewards IS NOT NULL |