Skip to content
← Data catalog

Hyperliquid 1-minute OHLCV data

gold_ohlcv_1m 1-minute bars, partitioned per (coin, month)

gold_ohlcv_1m is 1-minute Hyperliquid OHLCV candle data enriched with order flow: open/high/low/close, volume, the aggressor buy/sell split, cumulative volume delta (CVD), fees and realized PnL, for every perpetual market. Download the historical candles as a Parquet dataset or query them through the Tessera API. Every market is free over the trailing month; the closed months are sold as one-off Parquet bundles.

Use it for: Backtesting intraday strategies, building volume-profile and CVD signals, or charting Hyperliquid price with the order-flow context raw candles can't show.

Grain
1m
Columns
25
Partition
coin × month
History
October 2025 →
Price
Free, trailing month

Timing · time marks the interval start

`time` is the START of the minute; each bar covers the half-open interval [time, time + 1 minute). Every field is computed over that forward window, so a bar labelled `time` embeds information up to time + 60s. Do not use a bar to make a decision AS OF `time` itself, and lag by one bar before joining to point-in-time data (this is the OPPOSITE labelling to gold_positioning_1h, whose flow fields are backward-looking).

A day of BTC, bar by bar

2026-11-16 16:00–20:00 UTC. Read straight out of the Parquet a free key downloads, at the dataset's own grain.

buy_vol sell_vol open 64,439.00 · close 65,040.00 (+0.93%)
64,27564,55064,82565,10016:0017:0018:0019:00BTC · USDBTC per minute
Bars in the day
1,440
Trades
464,177
Notional
$3.9B
Day range
63,875 – 65,687

The candles behind it

The first six minutes of the window. Every column but Δ is copied from the Parquet; Δ is the running total of aggressor_delta from the window's first bar. The file holds all 1,440 bars of 2026-11-16 for BTC.

timeopenhighlowclosevolumebuy_volsell_volaggressor_deltaΔ since 16:00
16:0064,439.064,454.064,371.064,415.083.2630.1853.08-22.90-22.9
16:0164,414.064,544.064,399.064,524.085.5560.8424.71+36.12+13.2
16:0264,518.064,583.064,508.064,509.026.9313.7813.16+0.62+13.8
16:0364,508.064,537.064,467.064,498.055.542.3353.20-50.87-37.0
16:0464,497.064,497.064,391.064,414.017.652.6515.00-12.35-49.4
16:0564,414.064,430.064,326.064,337.081.9934.5647.43-12.87-62.2

Scroll the table sideways for the rest of the columns.

Download it, or read it

One call returns a presigned URL per day object for the open month, and a single URL for a closed one. The file is Parquet: partition columns, one row per candle, every column in the dictionary below.

  • REST reference for the route, the error shapes and the pagination.
  • Python, Rust and TypeScript clients stream it into Polars, DuckDB or Arrow without a local copy.
  • MCP serves this schema through describe_dataset, so an agent can read the columns before it queries.

HTTP

curl -s -H "Authorization: Bearer $TESSERA_API_KEY" \
  https://tesseralytics.dev/v1/datasets/gold_ohlcv_1m/BTC/2026-11/download

Python

import tessera

client = tessera.TesseraClient()          # reads $TESSERA_API_KEY
df = client.read("gold_ohlcv_1m", "BTC", "2026-11")
print(df.head())

Data dictionary

25 columns, every one documented. The same table is served by describe_dataset to an MCP client and by /v1/catalog/gold_ohlcv_1m over HTTP.

window starting at timestamp
Column What it means
time The minute this bar covers (its starting timestamp, UTC). How it's computed: Minute bucket start, UTC.
coin Which market this row is for. HIP-3 markets carry a deployer prefix, e.g. xyz:NVDA.
open Price at the start of the minute.
high Highest trade price during the minute.
low Lowest trade price during the minute.
close Price at the end of the minute: the one most people mean by 'the price'.
volume How much traded in the minute, in base units (the coin's own size, not USD). Multiply by `vwap` for the quote notional. The raw activity level. How it's computed: Total traded volume in the minute.
buy_vol The slice of volume where the aggressor was buying (lifting the offer). Demand pressure. How it's computed: Volume on aggressor-buy fills.
sell_vol The slice of volume where the aggressor was selling (hitting the bid). Supply pressure. How it's computed: Volume on aggressor-sell fills.
aggressor_delta Net aggressive pressure this minute: buy_vol minus sell_vol. Positive means buyers were leaning on the book harder than sellers. How it's computed: buy_vol - sell_vol (stateless per-bar).
cvd The running total of aggressor_delta: a continuous line of cumulative net buying. When price rises but CVD is flat or falling, the move isn't backed by aggressive flow and is more likely to fade. How it's computed: Running cumulative aggressor_delta, continuous across day and month boundaries (gold-owned).
trade_count How many individual trades happened in the minute: a proxy for activity and fragmentation.
unique_takers How many distinct wallets took liquidity this minute. Broad participation vs. one big player.
vwap The volume-weighted average fill price for the minute: a fairer 'where did it actually trade' than the close.
total_fees All trading fees paid in the minute.
taker_fees Fees paid by the aggressive side (takers).
maker_fees Fees paid, or rebates earned, on the passive side (makers).
taker_open_long_vol Aggressive volume that opened new long positions: fresh long risk entering.
taker_open_short_vol Aggressive volume that opened new short positions: fresh short risk entering.
taker_close_long_vol Aggressive volume that closed existing longs: longs taking profit or cutting.
taker_close_short_vol Aggressive volume that closed existing shorts: shorts covering.
closed_pnl_long Realized profit or loss booked by longs that closed this minute.
closed_pnl_short Realized profit or loss booked by shorts that closed this minute.
funding_rate The prevailing hourly funding rate at this minute, carried forward from the funding feed. Positive means longs pay shorts. How it's computed: Forward-filled from bronze_funding (NULL before first event).
bootstrap_source Housekeeping flag for how the running CVD was seeded at the previous partition boundary: the prior day for this daily series, the prior month at a month boundary ('cold_start' or 'carried_from_prior'). Ignore unless you're auditing continuity. How it's computed: 'cold_start' or 'carried_from_prior'.
Join it to the other two datasets

Same markets, same month partition, same timestamp convention on the hourly pair.

Free now, or buy the history once

Every dataset and every market is free over the trailing month. The full history from October 2025 is bought once as a Parquet bundle, with no subscription.