---
title: "Perp Position Lifecycle"
method: POST
path: "/v1/tools/model_perp_position"
---

# Perp Position Lifecycle

`POST /v1/tools/model_perp_position`

## Request

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

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

## Request body

- object
  - `close_fee_type` unknown, required
  - `close_ts` unknown, required
  - `entry_price` number
  - `exit_price` number
  - `funding_rate_per_interval` number
  - `leverage` number
  - `maker_fee_pct` number: Percentage value
  - `mmr_pct` number, required: Percentage value
  - `n_intervals` number
  - `open_fee_type` unknown, required
  - `open_ts` unknown, required
  - `position_size` number
  - `side` unknown, required
  - `taker_fee_pct` number: Percentage value
  - `venue` unknown, required

## Response `200`

Successful tool execution result

- object
  - `close_fee` number, required
  - `close_fee_type` string, required
  - `close_ts` string, required
  - `disclaimer` string, required
  - `entry_price` number, required
  - `exit_price` number, required
  - `funding_rate_per_interval` number, required
  - `initial_margin` number, required
  - `leverage` number, required
  - `liq_price` number, required
  - `maintenance_threshold` number, required
  - `margin_return_pct` number, required
  - `margin_returned` number, required
  - `mmr_pct` number, required
  - `n_intervals` number, required
  - `notional` number, required
  - `open_fee` number, required
  - `open_fee_type` string, required
  - `open_ts` string, required
  - `position_size` number, required
  - `price_delta` number, required
  - `realized_pnl_gross` number, required
  - `realized_pnl_net` number, required
  - `side` 'long' | 'short', required
  - `total_fees` number, required
  - `total_funding_impact` number, required
  - `total_net_pnl` number, required
  - `venue` 'binance' | 'hyperliquid', required

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)