API reference, Market data

Predicted funding

The funding rate each perp, HIP-3 included, will pay at the next hour if it ended now, with its average premium and formula terms.

Elysium: not served
HyperCore
HyperEVM: not served

Not on Elysium or HyperEVM: perps and their funding are HyperCore's: the EVM layers trade on AMM pools, with no perp

GET https://api.femtos.xyz/v1/hypercore/funding/predicted

Parameters

Param	In	Example or values	Meaning
`coin`	query	`BTC`	One perp (BTC, xyz:TSLA); every perp when absent
`dex`	query	(optional)	main (the main perp dex) or a HIP-3 dex (xyz, para…); every dex when absent

Example

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/hypercore/funding/predicted?coin=BTC"

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

Response fields

Field	Type	Meaning
`rows[]`	object	Main dex first, then each HIP-3 dex, each in its universe order; delisted perps left out: {coin, dex, rate, premiumAvg, premium, interestRate, clamp, multiplier, nextFundingTime, asOf}
`rows[].coin`	string	Perp: BTC, xyz:TSLA (HIP-3)
`rows[].rate`	decimal	Predicted hourly rate of the running hour, as a fraction (0.0000125 = 0.00125 % an hour; positive: longs pay shorts): Hyperliquid's own (its asset context's `funding`), every digit
`rows[].premiumAvg`	decimal \| null	Average premium of the hour's samples so far, derived from the rate with the asset's terms as read each minute: 10 decimals, known to ±4e-10 ÷ multiplier (not every digit); null when the rate does not tell it: within clamp of interestRate (the rate is then the interest alone: the usual case, 76 % of main-dex perps, BTC among them, at 13:00 UTC on 2026-11-09), a multiplier under 0.01, a rate at the cap. A hyperp (a pre-launch perp, whose samples count 1 % of the formula) would get a wrong average (none listed on 2026-11-09), and so would an asset in the minute after its terms change; its rate stays right
`rows[].premium`	decimal \| null	Latest premium (the asset context's): the next sample is the premium at its block
`rows[].interestRate`	decimal	Interest rate of the formula, per 8 h
`rows[].clamp`	decimal	How far the rate may move from the average premium toward the interest rate, per 8 h
`rows[].multiplier`	decimal	Multiplier of the rate (HIP-3; 1 on the main dex)
`rows[].nextFundingTime`	ms	When the running hour settles: the next whole UTC hour (Unix ms; Hyperliquid's predictedFundings gives the start of the running hour). It moves on once the hour is over: when the rate changes after it, or 15 s after it when the rate stays the same. The new hour's first rate can carry the settled hour's time for one read of its dex (up to 60 s on a dex served from Hyperliquid's public API)
`rows[].asOf`	ms	When its dex's asset contexts were last read (Unix ms): every second for the main dex, every 5 s for a HIP-3 dex, every 60 s for a dex hl-compat serves from Hyperliquid's public API; a dex not read for 3 of its periods is left out

Related: Market data

Markets GET /v1/markets Elysium, HyperCore, HyperEVM
Every tradable perp, spot, HIP-3 and outcome market with 24 h stats, its last 5 minutes and last hour, and a trending score.
Markets stream WS elysium.markets | hc.markets | hyperevm.markets Elysium, HyperCore, HyperEVM
The GET /v1/markets list of HyperCore (prices, 24 h volume and change), or the markets of a watchlist (`pairs`), pushed on subscribe and when it changes.
Token screener GET /v1/tokens/top Elysium, HyperEVM
The tokens of HyperEVM, one row each over all their pools: trending, volume, gainers, losers, new, market cap, liquidity.
Token screener stream WS elysium.tokens.top | hyperevm.tokens.top Elysium, HyperEVM
The GET /v1/tokens/top answer of HyperEVM (one row per token with activity (a swap in 24 h, or a pool created in the last hour), over all its pools: price, 1 h / 24 h change, volume, liquidity, market cap, holders, trending score), or the rows of a watchlist (`addresses`), pushed on subscribe, then on each indexed block with a swap: the rows of the pools each indexed block traded made again at once (5 m / 1 h windows and traders, price, market cap, FDV, last trade, trend score), in the order of the last rebuild; the order and the other fields at each rebuild (at most every 60 s).
Pool screener GET /v1/pools/top Elysium, HyperEVM
The pools of HyperEVM, one row each: trending, volume, gainers, losers, new, market cap, liquidity.
Pool screener stream WS elysium.pools.top | hyperevm.pools.top Elysium, HyperEVM
The GET /v1/pools/top answer of HyperEVM (one row per pool of the tokens with activity (a swap in 24 h, or a pool created in the last hour): both tokens, liquidity, windows, trending score), pushed on subscribe, then on each indexed block with a swap: the rows of the pools each indexed block traded made again at once (5 m / 1 h windows and traders, price, market cap, FDV, last trade, trend score), in the order of the last rebuild; the order and the other fields at each rebuild (at most every 60 s).
Candles GET /v1/candles Elysium, HyperCore, HyperEVM
OHLCV of any HyperCore market down to 1 s, ascending, UTC-aligned.
Forming candle WS elysium.candles | hc.candles | hyperevm.candles Elysium, HyperCore, HyperEVM
The forming candle, pushed once per block where it changes.
Token candles GET /v1/candles Elysium, HyperCore, HyperEVM
OHLCV of a token through its USDC market (a perp coin: the perp).
Token candles stream WS elysium.token.candles | hc.token.candles | hyperevm.token.candles Elysium, HyperCore, HyperEVM
A token's candles by name (its USDC market; a perp coin: the perp), the forming candle pushed once per block where it changes.
Trades GET /v1/trades Elysium, HyperCore, HyperEVM
Latest fills of one market, newest first.
Trades stream WS elysium.trades | hc.trades | hyperevm.trades Elysium, HyperCore, HyperEVM
All trades of one market as they happen: raced between our node and Hyperliquid's public feed, first copy sent, the other dropped.
Swap history stream WS elysium.trades.history | hyperevm.trades.history Elysium, HyperEVM
The latest swaps of a token or pool on HyperEVM (GET /v1/trades with filters), pushed on subscribe, then each block with a new swap it shows.
Order book GET /v1/book HyperCore
L2 book of one market with order counts, from our node.
Book stream WS hc.book HyperCore
Full-depth book, then the levels each block changes.
Named wallets on the book WS hc.book.named HyperCore
Who sits on the book: the resting limit orders of the named wallets (funds, traders, KOLs), by level, live.
Walls on the book WS hc.book.walls HyperCore
Every large resting order on the book with its owner, live, and whether that owner's walls hold or are pulled when the price comes.
Wall reliability GET /v1/hypercore/walls HyperCore
Which accounts' large resting orders hold when the price comes, and which are pulled.
Walls held or pulled GET /v1/hypercore/walls/events HyperCore
One market's walls the price came to, one by one: held or pulled, when and whose.
Best bid / offer WS hc.bbo HyperCore
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).
Asset contexts stream WS hc.ctx HyperCore
Mark, oracle, mid, funding, open interest and 24 h volume of every HyperCore market, pushed as they change: one read per second for every subscriber.
Order updates WS hc.orders HyperCore
Every order status change, filterable by coin, user and status. One frame per block with all its matching events.
Token prices GET /v1/prices Elysium, HyperCore, HyperEVM
USD price of up to 100 tokens in one call, each with its source and provenance.
Price history GET /v1/prices/history Elysium, HyperCore, HyperEVM
USD closes per unit of up to 25 tokens over a window, or the price of 100 tokens at one time (at=).
HYPE price WS prices.hype HyperCore
HYPE from HyperCore’s spot mid (each block), the Hyperliquid oracle and perp mark, and exchanges.
Token prices stream WS elysium.prices | hyperevm.prices Elysium, HyperEVM
USD prices of up to 100 HyperEVM tokens, as GET /v1/prices answers them, pushed in each block that changes one.
Pool detail GET /v1/pools/{address} Elysium, HyperEVM
One pool: dex, fee, tokens, liquidity in USD, depth, 5m to 24h activity, top LPs.
Pool stream WS elysium.pool | hyperevm.pool Elysium, HyperEVM
One pool on HyperEVM (GET /v1/pools/{address}: price, liquidity and depth, 5m to 24h activity, LPs), pushed on subscribe, then in each block that touches it: swap, liquidity added or removed, balance moved.
Liquidity events GET /v1/liquidity Elysium, HyperEVM
Liquidity added to and removed from one pool, newest first.
Liquidity events stream WS elysium.liquidity | hyperevm.liquidity Elysium, HyperEVM
Liquidity added to and removed from one pool on HyperEVM (GET /v1/liquidity), pushed on subscribe, then in each block that adds or removes some.
Daily token volume GET /v1/volume Elysium, HyperEVM
USD swap volume of a token per UTC day, both sides of every priced swap.
Sandwiches GET /v1/mev/sandwiches Elysium
Every sandwich on Elysium, newest first: the victim, the bot, the pool, the USD lost.
Sandwich stream WS elysium.mev Elysium
Each sandwich (MEV) on Elysium pools, the moment its back-run is indexed.
MEV stats GET /v1/mev/stats Elysium
What bots took on Elysium over a window: sandwiches, victims, arbitrage, top bots, pools and routers.
Sandwich bots GET /v1/mev/bots Elysium
The sandwich bots of Elysium, most USD taken first.
Sandwich bot GET /v1/mev/bots/{address} Elysium
One sandwich bot of Elysium: what it took, from whom, where.

Agent guide (agents.md)llms.txt OpenAPI MCP server Get an API key Changelog

Predicted funding

Parameters

Example

Response fields

Related: Market data

More