femtos

HyperCore · Price-level maps

Forced flow

Stop-loss / take-profit orders and liquidations on the same buckets: the cascade (stops + liquidations, with the move) and the take-profits (against it) at each price.

GET https://api.femtos.xyz/v1/hypercore/forced-flow

Parameters

ParamInExample or values
coinqueryBTC
bucketsquery40
stepquery(optional)
range_pctquery10

Example

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/hypercore/forced-flow?coin=BTC&buckets=40&range_pct=10"

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

Response fields

FieldTypeMeaning
buckets[]objectAscending price: {pxLo, pxHi, stops, liquidations, cascade, forced, cumCascadeSell, cumCascadeBuy, cumSell, cumBuy}
buckets[].cascadeobjectFires with the move: sell = sell stop-losses + long liquidations; buy = buy stop-losses + short liquidations: {sell, buy}
buckets[].forcedobjectcascade + take-profits: sell = sell stops / take-profits + long liquidations; buy = buy ones + short liquidations: {sell, buy}
buckets[].cumCascadeSelldecimal | nullBuckets at or under the mark's: cascade sell notional from the mark down to this bucket; null over it
buckets[].cumSelldecimal | nullBuckets at or under the mark's: forced sell notional from the mark down to this bucket; null over it
summaryobjectInside the grid: cascade selling at or under the mark's bucket and buying at or over it; sell take-profits at or over it and buy ones at or under it; forced = cascade + take-profits on each side: {cascadeSellBelow, cascadeBuyAbove, takeProfitSellAbove, takeProfitBuyBelow, sellBelow, buyAbove}
stopsobjectCut of the stops: {asOf, height, positions}
liquidationsobjectCut of the liquidation prices: {asOf, height, coverage}
markPxdecimal | nullMark: last trade
rangePctdecimalrange_pct applied
stepdecimal | nullBucket width

Related: Price-level maps

  • Liquidation price map GET /v1/hypercore/liquidation-map
    Liquidation prices of every open position, from Hyperliquid's formula on each account's state, bucketed like the stop map.
  • Stop map stream WS hc.stops.map
    The GET /api/hypercore/stops map, pushed whole on subscribe and every 5 s when it changes.
  • Liquidation map stream WS hc.liquidations.map
    The GET /api/hypercore/liquidation-map map, pushed whole on subscribe and every 5 s when it changes.
  • Forced flow stream WS hc.forced_flow.map
    The GET /api/hypercore/forced-flow map, pushed whole on subscribe and every 5 s when it changes.

More