Hyperliquid Market Data — OHLCV, Funding Rates & Positioning (Tessera)

Working · 3.3 s

dev.tesseralytics/hyperliquid-datav0.1.0 Domain verified

Hyperliquid perp market data for LLMs: OHLCV, funding, open interest, positioning & forecasts.

Crypto & Web3 Finance & Payments

Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://tesseralytics.dev/mcp

Authorization (required)

Tessera API key as a Bearer token: `Bearer <your-api-key>`. Get a free key at https://tesseralytics.dev.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

describe_dataset

The full dictionary for ONE downloadable dataset: description plus every column's type, nullability and plain-English meaning. Pass a name from list_datasets. Open — no key needed. For the fields the query tools accept, use list_fields.

assetstring, required

Dataset name, as returned by `list_datasets`.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

describe_dataset

Argument	Type	Description
asset*	string	Dataset name, as returned by `list_datasets`.

Input schema (JSON)

{
  "type": "object",
  "title": "DatasetArg",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "Dataset name, as returned by `list_datasets`."
    }
  },
  "description": "Which dataset's dictionary to return."
}

funding_divergence

Rank markets by how far their funding has diverged from a benchmark (default ETH) over a trailing window. Pick bar (1d, the default, or 1h on a Pro key) to read completed days or completed hours. metric=rate compares mean funding over the window; metric=cum_funding_spread compares how far a market's cumulative funding level travelled inside the window (its high minus its low, so never negative) — that is not the funding the window accumulated, which is funding_paid_7d (or funding_rate_7d_avg times the window's completed-interval count). Returns the most diverged in each direction. Markets with no funding reading are excluded from both lists. Descriptive only.

Argument	Type	Description
bar	string	`1d` (the default) for completed UTC days, `1h` for completed UTC hours. An interval, at either grain, is stamped by the instant it closes — an hourly `…T09:00:00Z` is the hour that ended at 09:00.
coins	array	Restrict to these markets.
scope	string	`crypto` (the default), `hip3`, or `all`.
top_n	integer	Markets per ranked list, 1..50. Defaults to 10.
metric	string	`rate` (the default) ranks each market's mean funding over the window minus the benchmark's; `cum_funding_spread` ranks the spread of the cumulative funding level over the window — its high minus its low, so always non-negative — minus the benchmark's. That is not the funding the window accumulated: `cum_funding` is a running total, so a market whose level retraced has a large spread and a negative accumulation (and one that reversed inside the window has a spread several times its true accumulation). Measured 2026-10-13 over 34 markets and the trailing 168 hours, the expression below reproduced the served value exactly, while `SUM(funding_paid)` over the same window disagreed in sign for 11 of them (TRX +0.00440 vs −0.00445) and by up to 100× (CASHCAT 0.2050 vs 0.0020). The accumulation is `funding_paid_7d`, or equivalently `funding_rate_7d_avg` × the window's completed-interval count — 7 intervals at the daily grain and 168 at the hourly one.
benchmark	string	The market whose funding is the yardstick. Defaults to ETH.
window_days	integer	Length of the trailing window in days, 1..365. Defaults to 7.

Input schema (JSON)

{
  "type": "object",
  "title": "DivergenceArgs",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "bar": {
      "type": "string",
      "default": null,
      "nullable": true,
      "description": "`1d` (the default) for completed UTC days, `1h` for completed UTC hours.\nAn interval, at either grain, is stamped by the instant it **closes** —\nan hourly `…T09:00:00Z` is the hour that ended at 09:00."
    },
    "coins": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": null,
      "nullable": true,
      "description": "Restrict to these markets."
    },
    "scope": {
      "type": "string",
      "default": null,
      "nullable": true,
      "description": "`crypto` (the default), `hip3`, or `all`."
    },
    "top_n": {
      "type": "integer",
      "format": "uint",
      "default": null,
      "minimum": 0,
      "nullable": true,
      "description": "Markets per ranked list, 1..50. Defaults to 10."
    },
    "metric": {
      "type": "string",
      "default": null,
      "nullable": true,
      "description": "`rate` (the default) ranks each market's mean funding over the window\nminus the benchmark's; `cum_funding_spread` ranks the **spread of the\ncumulative funding level** over the window — its high minus its low, so\nalways non-negative — minus the benchmark's. That is not the funding the\nwindow accumulated: `cum_funding` is a running total, so a market whose\nlevel retraced has a large spread and a *negative* accumulation (and one\nthat reversed inside the window has a spread several times its true\naccumulation). Measured 2026-10-13 over 34 markets and the trailing 168\nhours, the expression below reproduced the served value exactly, while\n`SUM(funding_paid)` over the same window disagreed in sign for 11 of\nthem (TRX +0.00440 vs −0.00445) and by up to 100× (CASHCAT 0.2050 vs\n0.0020). The accumulation is `funding_paid_7d`, or equivalently\n`funding_rate_7d_avg` × the window's completed-interval count — 7\nintervals at the daily grain and 168 at the hourly one."
    },
    "benchmark": {
      "type": "string",
      "default": null,
      "nullable": true,
      "description": "The market whose funding is the yardstick. Defaults to ETH."
    },
    "window_days": {
      "type": "integer",
      "format": "uint",
      "default": null,
      "minimum": 0,
      "nullable": true,
      "description": "Length of the trailing window in days, 1..365. Defaults to 7."
    }
  }
}

get_universe

The coverage picture: the last complete interval, how many markets are in the universe for a scope, how much history sits behind them, and how densely it is populated. Pick bar (1d, the default, or 1h on a Pro key) to describe completed days or completed hours. The range counts cover the last 7 days at bar: 1h (pass days, 1..30, to widen them) and the whole published range at bar: 1d. A compact SUMMARY by default — pass top_n (1..50) only if you need the per-market counts.

Argument	Type	Description
bar	string	`1d` (the default) for completed UTC days, `1h` for completed UTC hours. An interval, at either grain, is stamped by the instant it closes — an hourly `…T09:00:00Z` is the hour that ended at 09:00.
day	string	The day or hour to describe: `YYYY-MM-DD` or `latest` at `bar: 1d`, a completed `YYYY-MM-DDTHH:00:00Z` (the hour that ended there) or `latest` at `bar: 1h`.
days	integer	How many days of completed intervals the range counts cover, 1..30. Defaults to 7 at `bar: 1h` — the hourly source publishes one object per completed hour, so an unbounded inventory would open every hour ever published — and to the whole published range at `bar: 1d`, whose source is one object per month. The window the counts actually covered is `interval_start`..`interval_end`, and `notes` says when it was bounded.
scope	string	`crypto` (the default), `hip3`, or `all`.
top_n	integer	Per-market detail is off by default; passing a value (1..50) returns that many markets, listed by name, alongside the summary.

Input schema (JSON)

list_datasets

List the downloadable datasets: one-line summary, the plan required, and the month range available. Open — no key needed. Then use describe_dataset for one dataset's columns, or list_fields for the fields the query tools accept.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_fields

Every field the query tools accept, each with its meaning, unit, whether it can be missing, and which bars (1d, 1h) it exists on. Open — no key needed. Call this before query_cross_section, screen_universe or query_series. Percentile, z-score and the top_pct/bottom_pct conditions rank within the markets your plan can see, so they need a wide slice.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

live_market

What is happening right now: mark price, current hourly funding, open interest (one-sided — counted once per contract, half of the both-sides figure Hyperliquid's own UI shows, so it is directly comparable with the oi_usd column the bar tools return), 24-hour traded notional and premium for up to 25 markets, taken straight from the venue's public API and stamped with the moment it was read. Use this for 'now' questions; the bar=1d and bar=1h tools answer completed intervals only.

Argument	Type	Description
coins*	array	The markets to snapshot, 1..25.

Input schema (JSON)

{
  "type": "object",
  "title": "LiveMarketArgs",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "coins"
  ],
  "properties": {
    "coins": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The markets to snapshot, 1..25."
    }
  }
}

query_cross_section

Rank the whole market on ONE completed interval: pick bar (1d, the default, or 1h on a Pro key), columns, an order_by field and top_n. Answers 'top markets by funding / open interest / returns on the latest day or hour' and 'what percentile is BTC on open interest'. day defaults to the last complete interval; scope defaults to crypto (HIP-3 markets track an underlying that closes, so their flow is not comparable); stat=percentile|zscore ranks within your eligible markets; window_days recomputes the trailing-window fields; min_usd_volume_7d_avg keeps dust out of the ranking and the ranking is computed after it. Field names come from list_fields — never guess them, they are snake_case compound names and each one lists the bars it exists on; for a cut ('top decile by X') use screen_universe.

Argument	Type	Description
bar	string	`1d` (the default) for completed UTC days, `1h` for completed UTC hours. An interval, at either grain, is stamped by the instant it closes — an hourly `…T09:00:00Z` is the hour that ended at 09:00.
day	string	The day or hour to rank. For `bar: 1d`, `YYYY-MM-DD` or `latest` (the default: the most recent complete day). For `bar: 1h`, a completed hour as `YYYY-MM-DDTHH:00:00Z` — the hour that ended at that instant — or `latest`.
stat	string	`raw` (the default), `percentile`, or `zscore`. Percentile and z-score are ranked within the markets your plan can see, so they need a slice of at least four markets.
coins	array	Restrict to these markets. A market outside your plan's coverage is ignored rather than widening the answer.
scope	string

query_series

The series for one market or a few (max 10): one row per market per interval over a trailing window, oldest first. Pick bar (1d, the default, for one row per day, or 1h on a Pro key for one row per completed hour). Answers 'is this move backed by real flow' and 'how has positioning built up'. ending_day defaults to the last complete interval. The whole answer is capped, so markets times window_days (times 24 at bar 1h) must stay inside the row cap; the response states the window it used.

Argument	Type	Description
bar	string	`1d` (the default) for completed UTC days, `1h` for completed UTC hours. An interval, at either grain, is stamped by the instant it closes — an hourly `…T09:00:00Z` is the hour that ended at 09:00.
coins*	array	The markets to return, 1..10.
scope	string	`crypto` (the default), `hip3`, or `all`.
columns	array	Fields to return per row, from `list_fields`. The interval column (`day` at 1d, `hour` at 1h) and `coin` are always included.
ending_day	string	The last interval to include: `YYYY-MM-DD` or `latest` at `bar: 1d`, a completed `YYYY-MM-DDTHH:00:00Z` (the hour that ended there) or `latest` at `bar: 1h`.
window_days	integer	Length of the trailing window in days, 1..365. Defaults to 7. At `bar: 1h` one window day is 24 hourly rows.

Input schema (JSON)

screen_universe

Screen the whole market on ONE completed interval with several conditions ANDed together. Pick bar (1d, the default, or 1h on a Pro key; a free key is screened at 1d). Conditions use op >, <, >=, <=, between, top_pct or bottom_pct; top_pct/bottom_pct are deciles of your eligible markets, and the liquidity floor is applied before the deciles so they are measured over the population you are choosing from. Answers 'top-decile funding with bottom-decile open-interest change' and 'open interest rising faster than volume'. A market that does not report a field never satisfies a condition on it.

Argument	Type	Description
bar	string	`1d` (the default) for completed UTC days, `1h` for completed UTC hours. An interval, at either grain, is stamped by the instant it closes — an hourly `…T09:00:00Z` is the hour that ended at 09:00.
day	string	The day or hour to screen: `YYYY-MM-DD` or `latest` at `bar: 1d`, a completed `YYYY-MM-DDTHH:00:00Z` (the hour that ended there) or `latest` at `bar: 1h`.
coins	array	Restrict to these markets.
scope	string	`crypto` (the default), `hip3`, or `all`.
columns	array	Fields to return per market, from `list_fields`.
order_by	string	The field to rank the matches by. Defaults to the interval's traded notional.
conditions*

{ "type": "object", "title": "CrossSectionArgs", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "bar": { "type": "string", "default": null, "nullable": true, "description": "`1d` (the default) for completed UTC days, `1h` for completed UTC hours.\nAn interval, at either grain, is stamped by the instant it **closes** —\nan hourly `…T09:00:00Z` is the hour that ended at 09:00." }, "day": { "type": "string", "default": null, "nullable": true, "description": "The day or hour to rank. For `bar: 1d`, `YYYY-MM-DD` or `latest` (the\ndefault: the most recent complete day). For `bar: 1h`, a completed hour\nas `YYYY-MM-DDTHH:00:00Z` — the hour that *ended* at that instant — or\n`latest`." }, "stat": { "type": "string", "default": null, "nullable": true, "description": "`raw` (the default), `percentile`, or `zscore`. Percentile and z-score\nare ranked **within the markets your plan can see**, so they need a\nslice of at least four markets." }, "coins": { "type": "array", "items": { "type": "string" }, "default": null, "nullable": true, "description": "Restrict to these markets. A market outside your plan's coverage is\nignored rather than widening the answer." }, "scope": { "type": "string", "default": null, "nullable": true, "description": "`crypto` (the default), `hip3`, or `all`. Restricted markets track an\nunderlying that closes, so their flow is not comparable on a weekend." }, "top_n": { "type": "integer", "format": "uint", "default": null, "minimum": 0, "nullable": true, "description": "How many markets to return, 1..50. Defaults to 20." }, "columns": { "type": "array", "items": { "type": "string" }, "default": null, "nullable": true, "description": "Fields to return per market, from `list_fields`. `coin` is always\nincluded. Defaults to price, traded notional and the interval's return." }, "order_by": { "type": "string", "default": null, "nullable": true, "description": "The field to rank by. Need not appear in `columns`. Defaults to the\ninterval's traded notional." }, "descending": { "type": "boolean", "default": null, "nullable": true, "description": "Rank largest first (the default). Set false for the smallest." }, "window_days": { "type": "integer", "format": "uint", "default": null, "minimum": 0, "nullable": true, "description": "Recompute the trailing-window fields over this many days, 1..365\n(default 7). The response always states the window it used." }, "min_usd_volume_7d_avg": { "type": "number", "format": "double", "default": null, "nullable": true, "description": "Drop markets whose average daily traded notional over the window is\nbelow this value, so dust cannot top a ranking." } } }

{ "type": "object", "$defs": { "ConditionArg": { "type": "object", "required": [ "op", "value" ], "properties": { "op": { "type": "string", "description": "One of `>`, `<`, `>=`, `<=`, `between`, `top_pct`, `bottom_pct`.\n`top_pct`/`bottom_pct` keep the best/worst `value` percent of the\nmarkets you can see by that field." }, "value": { "type": "number", "format": "double", "description": "The threshold. For `top_pct`/`bottom_pct` this is a percentage, e.g. 10\nfor the top decile." }, "column": { "type": "string", "default": null, "nullable": true, "description": "The field to test, from `list_fields`. Accepted under either name —\n`field`, which is what every other argument on this surface calls it, or\nits original `column`. Validated as present rather than required by the\nschema, so a condition that names no field is rejected by name below\ninstead of by a deserializer message no caller can act on." }, "value2": { "type": "number", "format": "double", "default": null, "nullable": true, "description": "Required for `between`: the upper bound, inclusive." } }, "description": "One condition of a screen." } }, "title": "ScreenArgs", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "conditions" ], "properties": { "bar": { "type": "string", "default": null, "nullable": true, "description": "`1d` (the default) for completed UTC days, `1h` for completed UTC hours.\nAn interval, at either grain, is stamped by the instant it **closes** —\nan hourly `…T09:00:00Z` is the hour that ended at 09:00." }, "day": { "type": "string", "default": null, "nullable": true, "description": "The day or hour to screen: `YYYY-MM-DD` or `latest` at `bar: 1d`, a\ncompleted `YYYY-MM-DDTHH:00:00Z` (the hour that *ended* there) or\n`latest` at `bar: 1h`." }, "coins": { "type": "array", "items": { "type": "string" }, "default": null, "nullable": true, "description": "Restrict to these markets." }, "scope": { "type": "string", "default": null, "nullable": true, "description": "`crypto` (the default), `hip3`, or `all`." }, "columns": { "type": "array", "items": { "type": "string" }, "default": null, "nullable": true, "description": "Fields to return per market, from `list_fields`." }, "order_by": { "type": "string", "default": null, "nullable": true, "description": "The field to rank the matches by. Defaults to the interval's traded\nnotional." }, "conditions": { "type": "array", "items": { "$ref": "#/$defs/ConditionArg" }, "description": "Conditions, all of which must hold. A market that does not report a\nfield never satisfies a condition on it." }, "descending": { "type": "boolean", "default": null, "nullable": true, "description": "Rank largest first (the default)." }, "max_results": { "type": "integer", "format": "uint", "default": null, "minimum": 0, "nullable": true, "description": "How many markets to return, 1..50. Defaults to 25." }, "min_usd_volume_7d_avg": { "type": "number", "format": "double", "default": null, "nullable": true, "description": "Drop markets below this average daily traded notional over the window." } } }