---
title: "Perp Liquidation Calculator"
method: POST
path: "/v1/tools/compute_perp_margin"
---

# Perp Liquidation Calculator

`POST /v1/tools/compute_perp_margin`

## Request

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

Computes liquidation price and margin health for perpetual futures positions. Supports isolated and cross-margin modes across Hyperliquid, dYdX v4, Binance, GMX v2, and Aster. Venue-specific MMR tiers, portfolio margin with spot-hedge offset, and GREEN/AMBER/RED health indicator. Zero PII. Client-side. Works offline.

**Tool URL:** https://ainumbers.co/chaingraph/art-213-perp-liquidation-calculator.html

## Request body

- object
  - `correlation` number
  - `entry_price` number
  - `leverage` number
  - `mark_price` number, required
  - `mmr_pct` number, required: Percentage value
  - `mode` unknown, required
  - `position_size` number
  - `side` unknown, required
  - `spot_offset_usd` number: Amount in US dollars
  - `venue` unknown, required

## Response `200`

Successful tool execution result

- object
  - `buffer` number, required
  - `buffer_pct` number, required
  - `cross_margin_efficiency` object, nullable, required
  - `disclaimer` string, required
  - `distance_to_liq_pct` number, required
  - `entry_price` number, required
  - `health` 'AMBER' | 'GREEN', required
  - `imr_pct` number, required
  - `initial_margin` number, required
  - `leverage` number, required
  - `liq_price` number, required
  - `maintenance_threshold` number, required
  - `margin_balance` number, required
  - `mark_price` number, required
  - `mark_price_note` string, required
  - `mmr_pct` number, required
  - `mode` 'cross' | 'isolated', required
  - `notional` number, required
  - `portfolio_margin_note` string, nullable, required
  - `position_size` number, required
  - `side` 'long' | 'short', required
  - `unrealized_pnl` number, required
  - `venue` 'dydx_v4' | '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)