← Back to Skills Marketplace
Perpulator
by
FarisAlahmad714
· GitHub ↗
· v1.0.0
· MIT-0
92
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install perpulator
Description
Analyze perpetual futures positions directly in Claude Code — liquidation price, risk/reward, PnL, and probability-based trade plans. Powered by Perpulator.
Usage Guidance
This skill appears coherent for its stated purpose: it posts user-supplied trade parameters to the Perpulator API and returns the computed analysis. Before installing or enabling it, consider: 1) The skill will transmit your trade details (symbol, entry, stop, etc.) to perpulator.vercel.app — only proceed if you trust that service. 2) The SKILL.md tells the agent to `echo $PERPULATOR_API_KEY`, which will display your API key in the agent's output or logs; prefer setting a limited-scope or read-only key if supported, and avoid exposing your primary credentials in shared environments. 3) Verify the Perpulator homepage and that the API endpoint is legitimate (the domain matches the homepage here). 4) If you need stronger privacy, ask the skill owner to remove the explicit echo-check and instead have the agent silently test the key (e.g., attempt the API call and handle auth errors) or only prompt the user to confirm they set a key without printing it. If you want, I can suggest an edited SKILL.md that avoids echoing the key and provides safer key-check behavior.
Capability Analysis
Type: OpenClaw Skill
Name: perpulator
Version: 1.0.0
The 'perpulator' skill is a legitimate tool designed to calculate perpetual futures trading metrics. It functions by parsing user-provided trading parameters and sending them via curl to the service's API at perpulator.vercel.app. The skill requires a specific environment variable (PERPULATOR_API_KEY) and its behavior is fully consistent with its stated purpose in SKILL.md, with no evidence of malicious data exfiltration or unauthorized command execution.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (perpetual futures analysis) matches required resources: a single Perpulator API key and curl to call the Perpulator API at perpulator.vercel.app. No unrelated cloud credentials, binaries, or config paths are requested.
Instruction Scope
Instructions are narrowly scoped to parsing user-provided trade parameters and posting them to https://perpulator.vercel.app/api/v1/calculate. One noteworthy instruction: it tells the agent to run `echo $PERPULATOR_API_KEY` (which will print the raw key). That may leak the secret into agent output or logs; otherwise instructions do not access other files, env vars, or external endpoints.
Install Mechanism
No install spec and no code files — instruction-only skill. This is lowest-risk from an install perspective (nothing will be written to disk).
Credentials
Only a single credential is required (PERPULATOR_API_KEY), which is appropriate for an API-backed analysis service. No unrelated secrets or many environment variables are requested.
Persistence & Privilege
Skill does not request always:true or any elevated persistence or modification of other skills/configuration. It is user-invocable and allows autonomous invocation (platform default).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install perpulator - After installation, invoke the skill by name or use
/perpulator - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Perpulator skill — perpetual futures position analyzer.
- Analyze perpetual futures positions with liquidation price, risk/reward, PnL, and probability-based trade plans.
- Parses flexible input formats for all key trade parameters (symbol, side, entry price, margin, leverage, stop loss, take profit, current price).
- Integrates with Perpulator API using an API key.
- Formats and presents a detailed trade analysis, including risk notes and real-time PnL (if provided).
- Gives clear error feedback if required information is missing or the API returns an error.
Metadata
Frequently Asked Questions
What is Perpulator?
Analyze perpetual futures positions directly in Claude Code — liquidation price, risk/reward, PnL, and probability-based trade plans. Powered by Perpulator. It is an AI Agent Skill for Claude Code / OpenClaw, with 92 downloads so far.
How do I install Perpulator?
Run "/install perpulator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Perpulator free?
Yes, Perpulator is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Perpulator support?
Perpulator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Perpulator?
It is built and maintained by FarisAlahmad714 (@farisalahmad714); the current version is v1.0.0.
More Skills