Skip to main content
Alpha — The Market Data API is in alpha. Schema and response format may change. To request access, contact us or reach out to your account manager.
Allium’s Market Data API provides a single interface for navigating tradeable markets — reference metadata, latest and historical pricing, and perps primitives (funding, open interest, liquidations) — across trading venues.

​
Key Features

Unified Market Reference

List, filter, and search markets across venues and instrument types with a single canonical market_id.

Pricing & Candles

Latest price snapshots and historical OHLCV candles at standard institutional intervals.

Perps Primitives

Funding rates, open interest, and liquidations for perpetual markets.

​
Resource model

Market data is organized around two resources:
  • Market — a tradeable instrument on a specific venue, keyed by a canonical slug {venue}:{instrument_type}:{pair}, e.g. hl:perp:BTC-USDC, hl:spot:HYPE-USDC.
  • Asset — a canonical entity (e.g. asset:bitcoin) that aggregates a token across all of its deployments and markets. Asset-keyed endpoints are coming soon.
instrument_type is one of perp or spot today. future and option are reserved for future use.

​
Supported venues

Hyperliquid is the only venue available today. Additional CEX and DEX venues (e.g. Binance, dYdX, Uniswap) are coming soon — to request prioritization of a specific venue, reach out to your account manager.
The endpoint surface does not change as venues are added — the venue dimension simply grows, and the same market_id shape extends to new venues.

​
Conventions

All numeric response fields are returned as JSON strings to preserve precision. Several values (notional, open interest in base units) exceed JSON’s 2^53 safe-integer range, so parsing them as numbers would silently round. Parse them with an arbitrary-precision decimal type.

​
Authentication

All endpoints require an API key passed in the X-API-KEY header. The base URL is https://api.allium.so. 
curl --url "https://api.allium.so/api/v1/markets?venue=hyperliquid&instrument_type=perp" \
  --header "X-API-KEY: YOUR_API_KEY"