Hyperliquid Docs
  • About Hyperliquid
    • Core contributors
  • Onboarding
    • How to start trading
    • How to use the HyperEVM
    • Connect mobile via QR code
    • Export your email wallet
    • Testnet faucet
  • Hyperliquid L1
    • L1 overview
    • Staking
    • HyperEVM
    • Bridge
    • API servers
    • Clearinghouse
    • Oracle
    • Order book
    • Multi-sig
  • Hyperliquid Improvement Proposals (HIPs)
    • HIP-1: Native token standard
    • HIP-2: Hyperliquidity
    • Frontend checks
  • Trading
    • Perpetual assets
    • Contract specifications
    • Fees
    • Builder codes
    • Order book
    • Order types
    • Take profit and stop loss orders (TP/SL)
    • Margining
    • Liquidations
    • Entry price and pnl
    • Funding
    • Miscellaneous UI
    • Auto-deleveraging
    • Robust price indices
    • Self-trade prevention
    • Portfolio graphs
    • Uniswap perpetuals
    • Hyperps
    • Market making
  • Vaults
    • Protocol vaults
    • For vault leaders
    • For vault depositors
  • Validators
    • Running a validator
    • Delegation program
  • Referrals
  • Points
  • Historical data
  • Risks
  • Bug bounty program
  • Audits
  • Brand kit
  • For developers
    • API
      • Notation
      • Asset IDs
      • Tick and lot size
      • Nonces and API wallets
      • Info endpoint
        • Perpetuals
        • Spot
      • Exchange endpoint
      • Websocket
        • Subscriptions
        • Post requests
        • Timeouts and heartbeats
      • Error responses
      • Rate limits
      • Bridge2
      • Deploying HIP-1 and HIP-2 assets
    • HyperEVM
      • Dual-block architecture
      • Raw HyperEVM block data
      • Interacting with HyperCore
      • HyperCore <> HyperEVM transfers
      • Wrapped HYPE
      • JSON-RPC
Powered by GitBook
On this page
  • Market data
  • Asset metadata snapshots

Historical data

Historical data is zipped using LZ4 compression format and uploaded to S3 in the bucket hyperliquid-archive approximately once a month. L2 book snapshots are available in market_data and asset contexts are available in asset_ctxs. No other historical data sets are provided via s3 (e.g. trades or data for spot markets). You can use the API to record additional historical data sets yourself. Note that the requester of the data must pay for transfer costs.

Market data

Format: s3://hyperliquid-archive/market_data/[date]/[hour]/[datatype]/[coin].lz4

If you have installed AWS CLI (see https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) and LZ4 (https://github.com/lz4/lz4 or install from your package manager), then you can read the files as follows:

aws s3 cp s3://hyperliquid-archive/market_data/20230916/9/l2Book/SOL.lz4 /tmp/SOL.lz4 --request-payer requester
unlz4 --rm /tmp/SOL.lz4
head /tmp/SOL

Asset metadata snapshots

Format: s3://hyperliquid-archive/asset_ctxs/[date].csv.lz4

PreviousPointsNextRisks

Last updated 3 days ago