A professional-grade perpetual futures position analyzer that calculates liquidation prices, risk/reward ratios, and trade plans within your AI workflow.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install perpulator
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install perpulator using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Perpulator?
Perpulator is a powerful technical analysis skill designed for traders who want to evaluate crypto perpetual futures positions without leaving their development environment. By integrating the Perpulator API into Claude Code, this tool transforms raw trade parameters into actionable financial intelligence, providing deep insights into margin requirements and notional exposure.
As part of the Openclaw Skills ecosystem, Perpulator bridges the gap between AI coding agents and financial markets. It allows developers and traders to simulate complex trading scenarios, calculate precise liquidation points, and manage risk using probability-based trade planning through a simple conversational interface.
Perpulator Use Cases
- Calculating exact liquidation prices for high-leverage long or short positions.
- Evaluating Risk/Reward ratios before executing trades on exchanges.
- Real-time PnL tracking by providing current market prices to the analyzer.
- Determining the specific percentage move required to trigger a liquidation event.
- Planning stop-loss and take-profit levels for automated or manual trading strategies.
How Perpulator Works
- The skill checks for a valid PERPULATOR_API_KEY in the local environment.
- It extracts trading parameters such as symbol, side, entry price, margin, and leverage from the user's natural language input.
- The agent normalizes flexible inputs (e.g., converting '10x' to an integer or 'buy' to 'long').
- A secure POST request is sent to the Perpulator API containing the structured position data.
- The skill parses the JSON response and generates a formatted analysis table including notional size and risk metrics.
- A final risk assessment is calculated to show the percentage move distance to liquidation.
Perpulator Setup
To use Perpulator within your Openclaw Skills collection, you must set your API key:
- Obtain a free key from perpulator.vercel.app/settings.
- Set the environment variable in your terminal:
export PERPULATOR_API_KEY=perp_your_key_here
- Verify the installation by checking the variable:
echo $PERPULATOR_API_KEY
Perpulator Data Schema & Taxonomy
Perpulator processes position metadata through a structured schema to ensure precision in financial calculations:
| Field | Type | Description |
|---|---|---|
symbol |
String | Asset ticker (e.g., BTC, ETH) |
side |
String | Trade direction: long or short |
entryPrice |
Number | Entry price in USD |
positionSize |
Number | Margin/Collateral in USD |
leverage |
Number | Multiplier (1-125x) |
stopLoss |
Number | Optional exit price for risk calculation |
takeProfit |
Number | Optional exit price for reward calculation |
currentPrice |
Number | Optional price for live PnL analysis |
Perpulator Advanced Features
- Multi-format input parsing: Supports shorthand like 'SL:', 'target:', and '10X' for rapid entry.
- Real-time Risk Assessment: Automatically calculates the specific percentage move that would result in a 100% loss of collateral.
- Notional Exposure Calculation: Translates margin and leverage into the total market value of the position.
- Comprehensive Error Handling: Provides specific feedback on API errors or missing parameters to guide the user to a valid calculation.
SKILL.md
Loading
Related Openclaw Skills
wacli
A command-line interface for sending WhatsApp messages to third parties and managing chat history programmatically.
Sega Information Station
A specialized research skill providing comprehensive insights into Sega's corporate history, business scope, and global market presence.
Subtitle Generator Japanese to English
A cloud-powered AI agent skill that automatically transcribes, translates, and burns English subtitles into Japanese video files.
CookLikeHOC Recipe Search
An AI agent skill that enables users to search and retrieve authentic Home Original Chicken recipes from the open-source CookLikeHOC repository.
SEO Backlink Submitter
Automate the submission of websites to AI and SEO directories to build high-quality backlinks efficiently.
OpenClaw Life Coach
A professional yet empathetic AI life coach that combines emotional validation with the GROW model to help users navigate confusion and clarify personal goals.
Featured*
