HyperCore · Market data

Token metadata

Metadata of up to 100 tokens: supply, creator, logo and socials when indexed, family, spam. Also POST with a JSON body.

GET https://api.femtos.xyz/v1/tokens

Parameters

Param	In	Example or values
`layer`	query	`hypercore`
`addresses`	query	`HYPE,PURR,BTC`

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/tokens?layer=hypercore&addresses=HYPE%2CPURR%2CBTC"

Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.

Field	Type	Meaning
`layer`	string	Layer
`tokens[]`	object	In the order asked: TokenMeta (hyperevm / elysium) or Coin (hypercore): {address, symbol, name, decimals, totalSupply, creator, createdAt, createdBlock, logo, description, socials, family, …}
`missing`	string[]	Asked, not found
`asOf`	int \| null	Time of `height`: the layer head the answer is cut at (EVM: indexed head; HyperCore: ingested head) (Unix ms)
`height`	int \| null	Head block of the layer the answer is cut at
`testnet`	boolean	Elysium testnet: USD values from testnet pools, nominal
`syncing`	true	Present while the layer syncs: data only up to dataUntil
`dataUntil`	int \| null	Indexed head time while the layer syncs (Unix ms)

Markets GET /v1/markets
Every tradable perp, spot, HIP-3 and outcome market with 24 h stats.
Candles GET /v1/candles
OHLCV of any HyperCore market down to 1 s, ascending, UTC-aligned.
Forming candle WS hc.candles
The forming candle, pushed once per block where it changes.
Trades GET /v1/trades
Latest fills of one market, newest first.
Trades stream WS hc.trades
All trades of one market as they happen: raced between our node and Hyperliquid's public feed, first copy sent, the other dropped.
Best bid / offer WS hc.bbo
Top of book of one market each block: raced between Hyperliquid's public feed and our node (newest block wins, our node corrects the same block).
Order book GET /v1/book
L2 book of one market with order counts, from our node.
Book stream WS hc.book
Full-depth book, then the levels each block changes.
Order updates WS hc.orders
Every order status change, filterable by coin, user and status.
HYPE price WS prices.hype
HYPE from the Hyperliquid oracle, perp mark and exchanges.
Token prices GET /v1/prices
USD price of up to 100 tokens in one call, each with its source and provenance.
Price history GET /v1/prices/history
USD closes per unit of up to 25 tokens over a window, or the price of 100 tokens at one time (at=).
Token candles GET /v1/candles
OHLCV of a token through its USDC market (a perp coin: the perp).