tessera-api
Clean Hyperliquid market data — straight into Polars & DuckDB.
The official Rust client for Tessera — order-flow-enriched OHLCV, funding-rate, and positioning datasets built from raw Hyperliquid trade data, delivered as Parquet over a REST API.
Why tessera-api
- Read where the data lives. Partitioned Parquet is read directly from object storage over HTTPS range requests. Predicate and projection pushdown mean only the row groups and columns your query touches cross the wire — no temp files, no glue code.
- Two engines, one API. Lazily into Polars
LazyFrames (default feature), or into an in-memory DuckDB database you query with plain SQL (duckdbfeature). - Sync and async.
TesseraClientfor scripts and batch jobs;AsyncTesseraClientfor tokio services. - Typed end to end. Response models are generated from the OpenAPI spec at build time,
every failure is a
TesseraErrorvariant, and transient failures (429/5xx) are retried with exponential backoff andRetry-Afterhandling.
Installation
Requires Rust 1.85+. Grab a free API key (no card required) at tesseralytics.dev:
The free tier covers every coin and all three datasets over the trailing 30 days; full history is available as one-off download bundles (see Free tier and history bundles).
Free tier and history bundles
The free tier needs no card. It covers every coin and all three datasets —
gold_ohlcv_1m, gold_funding_1h and gold_positioning_1h — over the trailing 30 days.
The API serves that window at month granularity, so a free key sees the current and
previous calendar month; the window is the only restriction.
History beyond the window is sold as one-off download bundles of the closed months. Each bundle carries all three datasets, is frozen at purchase, and is perpetual on the account — every API key you hold inherits it:
| Bundle | Markets | Price |
|---|---|---|
| Tessera Majors | BTC, ETH, SOL, HYPE | $19 once |
| Tessera HIP-3 (xyz) | Every xyz: HIP-3 market |
$24 once |
| Tessera All Markets | Every coin Tessera publishes | $29 once |
The open month is never included. datasets() and partitions() already reflect your
entitlement, so the client needs no plan logic of its own. See
pricing for the full comparison.
Quickstart
use TesseraClient;
Lazy scans
scan mints presigned URLs and returns a LazyFrame; the Parquet bytes are only read
when you .collect(). Filters and column selections push down to object storage:
use *;
Presigned URLs are short-lived (~15 minutes). Collect promptly; for long-lived graphs,
re-run scan to mint fresh URLs.
Multiple coins and months
coin and month arguments accept a single value or any collection; months also accept
an inclusive MonthSpan. Multi-partition reads append coin/month columns so rows stay
attributable to their source partition:
use ;
The current month is day-backed: it has no single month object, so the API publishes one
Parquet per day. read, scan and to_duckdb concatenate those day objects transparently —
a partition is still one logical month, and provenance columns stay per partition.
Months outside the trailing 30-day window are not served (TesseraError::NotFound) unless
your account holds a bundle covering them — call partitions() to discover what's
available, as in the quickstart.
Async
Inside a tokio runtime, use AsyncTesseraClient (the sync client owns a private runtime
and must not be constructed from async code):
use AsyncTesseraClient;
async
SQL with DuckDB
Opt in to the duckdb feature (drop the default polars feature if you don't need both):
= { = "0.1", = false, = ["duckdb"] }
to_duckdb returns an in-memory connection exposing a tessera view over the presigned
Parquet; filters and aggregations push down to object storage via httpfs:
use TesseraClient;
Configuration
use Duration;
use ;
ClientConfig also exposes base_url and user_agent.
Error handling
Every failure is a TesseraError; match on the variants you care about (or use the
status_code() / code() helpers):
use ;
The raw API
The typed endpoints are also available directly — for browsing the catalog or fetching the Parquet bytes yourself:
Documentation
- 🦀 Rust guide: https://tesseralytics.dev/rust-client
- 🦀 API reference: https://docs.rs/tessera-api
- 🌐 Product & pricing: https://tesseralytics.dev
License
GPL-3.0 © Tessera. See LICENSE.