Skip to content
← Data catalog

Hyperliquid hourly funding rates

gold_funding_1h hourly, partitioned per (coin, month)

gold_funding_1h is hourly Hyperliquid funding-rate data for every perpetual market: the current rate, an annualized view, and a month-continuous cumulative funding total. Download the full funding-rate history as Parquet or query it through the Tessera API. Funding is the carry longs and shorts pay to keep the perp tethered to spot.

Use it for: Funding-carry and basis strategies, measuring the cost of holding a perp, or reading crowded positioning from persistent funding.

Grain
1h
Columns
6
Partition
coin × month
History
October 2025 →
Price
Free, trailing month

Timing · time marks the snapshot

`time` is the hour the funding settles for (UTC): the rate is charged at `time` for the hour that ended there, which is the venue's own convention (the print is published moments after `time`). funding_rate and annualized are the point-in-time rate for that hour; cum_funding is the running total through `time`. Every field is knowable at `time`. There is no forward window.

A day of BTC, bar by bar

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

Annualized funding

Cumulative funding

Bars in the day
24
Mean annualized
+7.39%
Rates paid today
+2.03e-04
Cumulative at close
+0.000190

The hours behind it

The first four hours of 2026-11-16, exactly as the Parquet returns them. The file holds all 24 hourly bars of the day for BTC.

timefunding_rateannualizedcum_fundingbootstrap_source
00:00+1.25e-05+10.95%0.070863carried_from_prior
01:00+1.25e-05+10.95%0.070876carried_from_prior
02:00+1.25e-05+10.95%0.070888carried_from_prior
03:00+1.25e-05+10.95%0.070901carried_from_prior

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 hour, every column in the dictionary below.

  • REST reference for the route, the error shapes and the pagination.
  • Python and Rust clients stream it into Polars or DuckDB 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_funding_1h/BTC/2026-11/download

Python

import tessera

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

Data dictionary

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

snapshot · as of timestamp
Column What it means
time The hour this funding observation applies to (UTC).
coin Which market this row is for.
funding_rate The hourly funding rate. When it's positive, longs pay shorts (the crowd is long and pays for it); when negative, shorts pay longs.
annualized The same rate scaled to a yearly figure (× 24 × 365) so you can compare carry against other yields at a glance. It is a point-in-time print annualized, not a plausible carry: a single stress hour annualizes to an absurd figure (one −0.38 %/h hour, a real squeeze print, reads as ≈ −3 300 %/yr). For context, the venue's neutral print is +0.00125 %/h (≈ +11 %/yr) and October 2026's hour-to-hour range ran to −0.5 %/h (≈ −4 400 %/yr), mostly on thin HIP-3 markets. Compare a row against the funding distribution, or use cum_funding for carry actually paid. How it's computed: funding_rate * 24 * 365.
cum_funding Running total of funding since the series began, stitched across month boundaries: a lifetime level, not an interval's carry, so a cross-sectional rank on it mixes carry with listing age and size. How it's computed: Cumulative funding_rate, spliced across month boundaries.
bootstrap_source Housekeeping flag for how the cumulative total was seeded at the previous partition boundary: the prior hour for this hourly series, the prior month at a month boundary. Ignore unless auditing continuity.
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.