Perp Position Lifecycle

Models a full perpetual futures position from open to close. Computes liquidation price, realized PnL (gross and net of fees), cumulative funding impact over the holding period, taker and maker fees at open and close, total net PnL, and margin returned. Hyperliquid hourly funding cadence by default. Zero PII. Client-side. Works offline.

Tool URL: https://ainumbers.co/chaingraph/art-214-perp-position-lifecycle.html

post/v1/tools/model_perp_position

Request

  • Base URL: https://ainumbers.co
  • URL: https://ainumbers.co/v1/tools/model_perp_position
  • Auth: none declared

Request body

close_fee_typeunknown required
close_tsunknown required
entry_pricenumber
exit_pricenumber
funding_rate_per_intervalnumber
leveragenumber
maker_fee_pctnumber

Percentage value

mmr_pctnumber required

Percentage value

n_intervalsnumber
open_fee_typeunknown required
open_tsunknown required
position_sizenumber
sideunknown required
taker_fee_pctnumber

Percentage value

venueunknown required

Response

Successful tool execution result

close_feenumber required
close_fee_typestring required
close_tsstring required
disclaimerstring required
entry_pricenumber required
exit_pricenumber required
funding_rate_per_intervalnumber required
initial_marginnumber required
leveragenumber required
liq_pricenumber required
maintenance_thresholdnumber required
margin_return_pctnumber required
margin_returnednumber required
mmr_pctnumber required
n_intervalsnumber required
notionalnumber required
open_feenumber required
open_fee_typestring required
open_tsstring required
position_sizenumber required
price_deltanumber required
realized_pnl_grossnumber required
realized_pnl_netnumber required
side'long' | 'short' required
total_feesnumber required
total_funding_impactnumber required
total_net_pnlnumber required
venue'binance' | 'hyperliquid' required

Changes

No recorded changes to this operation across all 1 revision of this API.