Position Snapshot

Generate OHLC candlestick charts overlaid with live position data — entries, limit orders, PnL, and custom zones.

When To Use

• User asks to see their position on a chart
• User wants a visual of where their orders are relative to price action
• User says "show me where we are" or "chart my position"

Workflow

1. Gather position data — call hl_account() (or orderly_positions()) to get current position: entry price, size, side, uPnL, leverage, liquidation price
2. Gather open orders — call hl_open_orders() to get resting limit orders
3. Fetch OHLC data — call hl_candles(coin=ASSET, interval="4h", lookback=336) for 14 days of 4H candles (adjust interval/lookback to user preference)
4. Run the render script — pass data as JSON args to scripts/render_position_chart.py
5. Present the chart — display from output/ directory

Render Script