galleonlabs/crypto-defi-skills / packages/derivatives/skills/jupiter-perps
jupiter-perps
VerifiedUse when inspecting Jupiter Perpetuals position and PositionRequest accounts, borrowing fees, triggers or pending close evidence on Solana.
| File | Kind | Size |
|---|---|---|
| ATTRIBUTION.md | markdown | 958 B |
| LICENSE | other | 1.0 KB |
| SKILL.md | skill md | 3.5 KB |
| agents/openai.yaml | config | 252 B |
| references/reads.md | markdown | 1.1 KB |
SKILL.md
View on GitHub---
name: jupiter-perps
description: "Use when inspecting Jupiter Perpetuals position and PositionRequest accounts, borrowing fees, triggers or pending close evidence on Solana."
license: MIT
compatibility: "Read-only protocol APIs or RPC through existing configured tools. No signer included."
metadata:
author: "Galleon Labs"
version: "0.2.3"
---
# Jupiter perps
Return a Jupiter Perps account/position assessment using the deployed program's exact account schema. The official Perps overview still labels its REST API a work in progress; do not invent a live `/perps/order` API or infer support from the Swap API.
## Resolve position identity
Collect cluster, owner, side, custody and collateral-custody accounts, Position address and any request signature. Resolve the official program and verified current account layout. Read the Position, relevant Custody and PositionRequest accounts at a recorded slot through configured Solana RPC or an existing supported official tool.
Position identity includes side and both custody identities; do not combine different collateral assets because they share a token symbol. `sizeUsd` and `collateralUsd` are distinct raw USD-scaled amounts; token collateralDelta uses its mint decimals. A zero `sizeUsd` is a closed position, but historical realized proceeds require transaction/history evidence because a closed account's displayed PnL can reset.
## Read costs and contingent actions
Evaluate entry/mark, size, collateral, borrow accumulator and request state. Borrowing costs derive from the difference between custody cumulative interest and the position snapshot using current program math; do not label them interchangeable with signed cross-venue funding.
Read active trigger requests separately from current position exposure. For increases and decreases, inspect side-dependent priceSlippage direction, swap minimum, entirePosition flag and intended size delta. A newly created PositionRequest is an instruction waiting for execution, not a completed close. Its ATA can temporarily hold deposit/withdraw assets.
## Return the unsigned decision
Show position/account identities, slot, leverage assumptions, cost sources, pending requests and missing evidence. Preparation must use the currently supported official UI or a verified program integration; the linked third-party IDL parsing example is community code, not a guaranteed maintained signing service. Keep signing and instruction submission outside research.
If a request disappears, distinguish executed/rejected/closed using its transaction and current Position/ATA balances; do not infer fill from disappearance alone. On timeout reconcile the original signature before retrying. Unsupported API, stale custody data or unknown program version remains a named capability gap.
## Worked result
Synthetic Position sizeUsd is 5,000,000,000 at six decimals: $5,000 exposure. A full-close request exists with executed=false and current size unchanged. Report $5,000 observed exposure and pending close. An eventual zero-size reread plus successful close receipt and returned collateral establish completion; a request creation signature alone does not.
## Sources and limits
Primary documentation and source reviewed 2026-10-25; no account authorization, signing or financial action was tested. [Read recipes and current primary sources](references/reads.md) ship with this skill. Recheck supported deployments and schemas before a consequential handoff. Research adds no permission to trade, transfer, vote or change account authority.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |