Funding

Perp funding per coin as an APR, ranked against every perp in the market, plus market temperature and funding alerts.

Funding is the rate a perp position pays or earns while it is held. Shumi turns each coin’s rate into a yearly APR, ranks it against every perp it tracks, and gives the whole market a temperature.

​

Get funding for one coin or the market

Terminal

shumi funding momentum --symbol BTC
shumi funding momentum

Bare shumi funding prints help only.

API

curl "https://api.shumi.ai/api/cli/funding/momentum?symbol=BTC" \
  -H "Authorization: Bearer shumi_sk_your_key_here"

AI agent

Connect the MCP server and call get_funding_momentum, with symbol for one coin.

​

Read one coin

{"symbol":"BTC","apr":11,"ratePct":0.0013,"intervalH":1,"source":"hyperliquid","tier":"neutral","percentile":0.65}

Field	Meaning
apr	Funding as a yearly rate, in percent. 11 means 11% a year
ratePct	The raw rate per funding interval, in percent
intervalH	Hours between funding payments on the source venue
source	The venue the rate came from
percentile	Where this APR sits among every perp in the snapshot (616 in the example). 0.65 means higher than 65% of them
tier	The percentile as a label

The tier uses the exact percentile; the response shows it rounded to two decimals, so a displayed 0.80 can still be neutral.

Percentile	Tier
0.90 and above	hot
0.80 to 0.89	warm
0.21 to 0.79	neutral
0.11 to 0.20	cool
0.10 and below	cold

--symbol answers for any perp in the snapshot. The market-wide call returns:

• a fixed watch list of large coins, 43 in the example, sorted by APR
• market: the market temperature, such as neutral, and the median APR it is read from
• distribution: p10 to p90, min, max and totalAssets

​

Read the market temperature

market.temperature reads the median perp’s funding against the resting rate. Hyperliquid and Variational charge a fixed interest component, so about 10.95% APR is the resting rate with no crowding at all. Only funding above or below that is positioning. medianPremiumApr is that difference:

medianPremiumApr	Temperature
20 or more	hot
5 to 20	warm
-5 to 5	neutral
-20 to -5	cool
below -20	cold

For example: "temperature":"neutral","medianApr":11,"medianPremiumApr":0. positive, negative and total count the coins on the watch list. Use medianApr as the market level; one outlier market can skew avgApr.

Ask it in chat: Which perps have the highest and lowest funding APR right now, and where does BTC rank?

​

Positive and negative funding

Positive funding is a cost on a long perp. Negative funding is a cost on a short. shumi coin risk BTC states it for the coin in carry_if_long and carry_if_short.

Funding applies to perpetual positions only. A spot position pays and receives nothing.

Funding tells you who is crowded and what a held position costs. For timing, pair it with the trend in a signal.

​

See funding alerts

shumi funding alerts

API: GET /api/cli/funding/alerts. Agent tool: get_funding_alerts.

Field	Meaning
asset	The coin
triggerZone	The zone funding entered, for example negative
fundingAtTrigger, fundingIntervalH	The rate when it fired, and the funding interval in hours
source	The exchange
firedAt	When it fired