# Comparand

> Hyperliquid market history you and your agents can query. Research only. Hyperliquid only. No forecasts, no signals, no advice.

## What Comparand is

Comparand is a research service over Hyperliquid market history. You, or an AI agent working for you, can ask what the market looked like, when it looked like this before, and which liquidation cascades happened on a given day. Every answer says which data it came from and what its limits are.

## What it will not do

- No forecasts. Labels and analogs describe the past.
- No trade signals.
- No advice on what to trade. Not investment advice.
- No order placement or other execution.
- Hyperliquid only. No other exchange.

## Endpoints

- Base URL: https://api.comparand.xyz
- MCP endpoint: https://api.comparand.xyz/mcp (streamable HTTP)
- Auth on every call: Authorization: Bearer <key>
- REST examples and an MCP config block: https://comparand.xyz/docs

## How to get a key

1. Choose a plan at https://comparand.xyz/pricing.
2. Pay through Stripe Checkout.
3. The welcome page shows your key once. Save it then. It cannot be shown again.

Plans:

- Starter: $19 per month. Includes $25 of usage each month. 60 requests per minute. Live labels included.
- Pro: $79 per month. Includes $120 of usage each month. 300 requests per minute. Live labels included.

When a plan's included usage is used up, calls are refused until the next UTC month. Nothing is billed extra.

## Launch tools

Each line gives the price. Row prices charge for each row returned.

- hl_coverage: archive days, the coin list, and which days are complete. Free. Call this first.
- hl_provenance: the full provenance record for one archive day. Free.
- usage: your key's usage for the current UTC month. Free.
- hl_labels: per-minute labels for one coin over a start and end time in the archive. $0.005 per row.
- hl_labels_snapshot: labels for every coin at one UTC minute. $0.005 per row.
- hl_cascade_events: the liquidation cascade events for one archive day. $0.005 per row.
- hl_labels_live: the newest per-minute labels for one coin from the live feed. $0.005 per row. Refused when the data is stale.
- hl_analogs: the past moments nearest to one coin's state at one decision time, with the outcome over the next 1 or 4 hours. $0.05 per packet.

## Not available yet

These are off at launch and are not part of either plan:

- Backtests of market-making rules.
- Strategy reports.
- Research projects.
- Wallet lookups.
- Order-book replay.

## Pages

- https://comparand.xyz/: Home. What Comparand is, data coverage, and what you can query today.
- https://comparand.xyz/pricing: Starter and Pro monthly plans, included usage, and request limits.
- https://comparand.xyz/docs: REST and MCP usage, tools, keys, and limits.
- https://comparand.xyz/methods: How the answers are built, what the analog search can and cannot show, and where the cascade screen and backtests fail.
- https://comparand.xyz/coverage: The archive counts, the known gap days, the days with no cohort data, and what is not established.
- https://comparand.xyz/llms-full.txt: Full plain-text version of the docs page.
- https://comparand.xyz/support: Billing, lost API keys, cancellations, and failed payments.
- https://comparand.xyz/terms: Terms of use for the research data and paid plans.
- https://comparand.xyz/privacy: What data Comparand stores and how to ask for deletion.

## Contact

hello@comparand.xyz