# Vulcan Position Management

> List, show, close, reduce positions and manage TP/SL on existing positions.

- Skill: `x402agent/vulcan-position-management` (Agent Skill)
- Install (CLI): `npx skillmds add x402agent/vulcan-position-management`
- Raw SKILL.md: https://api.skillmd.com/api/skills/x402agent/vulcan-position-management/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: x402agent (https://skillmd.com/u/x402agent)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/x402agent/vulcan-position-management

---


# vulcan-position-management

Use this skill for:
- Viewing open positions
- Closing or reducing positions
- Attaching TP/SL to existing positions
- Monitoring position PnL and liquidation price

## List All Positions

```
vulcan_position_list → {}
```

Returns all open positions across cross and isolated subaccounts. Each row carries: symbol (with ` [iso]` suffix for isolated), side, size, entry price, mark price, unrealized PnL, `unrealized_pnl_pct` (precomputed; isolated uses subaccount collateral as denominator, cross uses entry-time initial margin), `initial_margin`, `maintenance_margin`, `liquidation_price`, and — for isolated only — `subaccount_collateral` and `subaccount_index`.

## Show Position Detail

```
vulcan_position_show → { symbol: "SOL" }
```

Returns detailed info: PnL, margin, liquidation price, TP/SL prices, subaccount info.

## Close Entire Position

```
vulcan_position_close → { symbol: "SOL", acknowledged: true }
```

Closes via market order on the opposite side. Verify with:

```
vulcan_position_list → {}    # confirm position is gone
```

## Close Every Position (Emergency Flatten)

```
vulcan_position_close_all → { acknowledged: true }
```

Closes every open position across all markets and subaccounts (one market order per position). Pair with `vulcan_trade_cancel → { scope: "all-markets", acknowledged: true }` first if you also want to wipe resting orders. Verify with `vulcan_position_list → {}`.

## Reduce Position

Partially reduce a position by a specified size (in base lots):

```
vulcan_position_reduce → { symbol: "SOL", size: 25, acknowledged: true }
```

## Attach TP/SL to Existing Position

Two tools can set TP/SL on an existing position:

### Using position tool (protective trigger orders)

```
vulcan_position_tp_sl → { symbol: "SOL", tp: 160.0, sl: 140.0, acknowledged: true }
```

### Using trade tool (set/modify)

```
vulcan_trade_set_tpsl → { symbol: "SOL", tp: 160.0, sl: 140.0, acknowledged: true }
```

Both auto-detect position side. Direction rules:
- Long: TP > current price, SL < current price.
- Short: TP < current price, SL > current price.

You can set just TP, just SL, or both.

## Cancel TP/SL

```
vulcan_trade_cancel → { symbol: "SOL", scope: "tpsl", tp: true, sl: true, acknowledged: true }
```

Set `tp: true` to cancel take-profit, `sl: true` to cancel stop-loss, or both.

## View TP/SL

TP/SL prices in `vulcan_position_show` are the authoritative position-level state.

```
vulcan_position_show → { symbol: "SOL" }
# Look for take_profit_price and stop_loss_price fields
```

Conditional trigger legs may also appear in portfolio or order views as reduce-only trigger orders. Treat those as implementation details of the protective orders, not normal resting limits.

## Position Management Flow

1. Review positions: `vulcan_position_list`
2. Get details on specific position: `vulcan_position_show → { symbol }`
3. If needed, adjust TP/SL: `vulcan_trade_set_tpsl → { symbol, tp?, sl?, acknowledged: true }`
4. If needed, reduce: `vulcan_position_reduce → { symbol, size, acknowledged: true }`
5. If needed, close: `vulcan_position_close → { symbol, acknowledged: true }`