> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ironflow.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Ironflow API: Hyperliquid market data over REST

> Hyperliquid market data over REST: tick-level fills and trades, candles, funding, open interest, mark prices and wallet analytics, with a year of fill history.

Ironflow is institutional-grade market data infrastructure for Hyperliquid. Tick-level fills, candles, funding rates, open interest, mark prices, and full wallet analytics, queryable over REST with a year of tick-level history. We run proprietary Hyperliquid node infrastructure, index every block, and expose one unified schema across HL native perps, HIP-3 builder markets (RWA, equities, custom indexes), HIP-4 outcome contracts, and HL spot pairs.

## What you can build

<CardGroup cols={2}>
  <Card title="Quant Research" icon="chart-line">
    A year of tick-level fills across 2,600+ markets. Full trade tape, per-wallet fills, realized PnL on every closing fill.
  </Card>

  <Card title="Wallet Analytics" icon="user">
    Reconstruct any HL wallet end-to-end: open positions, funding payments, maker/taker split, full ledger. Four `/v1/analytics/user-*` endpoints.
  </Card>

  <Card title="Wallet Tracking" icon="eye">
    Rank wallets by realized performance, inspect any wallet's per-market record, and watch their fills with per-address queries.
  </Card>

  <Card title="Market Monitoring" icon="bell">
    Funding, open interest, and mark price series for every perp, native and builder-deployed, under one symbol scheme.
  </Card>
</CardGroup>

## The dataset

Stored data with no record caps on list endpoints. Per-key rate limits apply per tier — see [Rate Limits & Errors](/concepts/rate-limits).

| Endpoint | Data | Resolution |
| - | - | - |
| `/v1/trades` | All fills across all participants | Full tick |
| `/v1/fills` | Fills for a specific address | Full tick |
| `/v1/candles` | OHLCV aggregates | 1m / 5m / 15m / 1h / 4h / 1d |
| `/v1/funding` | Funding rate history | Per interval |
| `/v1/open-interest` | OI snapshots | 10 seconds |
| `/v1/mark-prices` | Mark + oracle prices | 10 seconds |
| `/v1/markets` | Market registry across all classes | Live |
| `/v1/analytics/*` | Wallet + market analytics | Aggregated |

## Data availability

* **Coverage:** Hyperliquid HyperCore — native perps + HL spot + every HIP-3 builder market + HIP-4 outcome contracts. One schema, one API, the full HL economy.
* **Tick-level history:** fills and trades for the last 12 months (rolling). Funding rates, mark prices, and open interest build forward from their enable dates.
* **Freshness:** sub-second from block to queryable row.
* **Uptime:** monitored at [status.ironflow.sh](https://status.ironflow.sh).

Symbols follow four patterns: perps (`BTC-PERP`), HL spot (`HYPE/USDC` or numeric `@285`), HIP-3 builder markets (`<issuer>:<base>-PERP`, e.g. `flx:GAS-PERP`, `xyz:NVDA-PERP`), and HIP-4 outcome contracts (e.g. `BTC-78213-20260503-Yes`). See [Sources & Markets](/concepts/sources-and-markets) for the full symbol scheme and filter modes.

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Call the API without a key, or get a free key for more.
  </Card>

  <Card title="Quickstart" icon="bolt" href="/quickstart">
    First live data in under 5 minutes.
  </Card>
</CardGroup>

***

Ironflow is an independent product. Not affiliated with or endorsed by Hyperliquid or Pear Protocol. Not investment advice. See the [Terms](https://ironflow.sh/terms), [Privacy Policy](https://ironflow.sh/privacy) and [Risk Disclosure](https://ironflow.sh/risk-disclosure).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.