Skip to content

Charts

API endpoints for chart image generation.

Provides endpoints for generating PNG chart images for round-trip trades, trade journeys, PnL summaries, and bar segments.

router = APIRouter(prefix='/api', tags=['charts']) module-attribute

api_run_chart_image(run_id, symbol, start_ns, end_ns, direction, pnl, chart_type='c_bars', context=100) async

Return a PNG chart image for a round-trip trade.

Source code in src/onesecondtrader/dashboard/routers/charts.py 
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
@router.get("/runs/{run_id}/chart.png")
async def api_run_chart_image(
    run_id: str,
    symbol: str,
    start_ns: int,
    end_ns: int,
    direction: str,
    pnl: float,
    chart_type: str = "c_bars",
    context: int = 100,
) -> Response:
    """Return a PNG chart image for a round-trip trade."""
    strategy_key = get_strategy_key(run_id)
    chart_settings = load_chart_settings(strategy_key) or None
    image_bytes = generate_chart_image(
        run_id,
        symbol,
        start_ns,
        end_ns,
        direction,
        pnl,
        chart_type,
        chart_settings=chart_settings,
        context=context,
    )
    return Response(content=image_bytes, media_type="image/png")

api_trade_journey_chart(run_id, symbol=None) async

Return a Trade Journey chart image for round-trip trades in a run, optionally filtered by symbol.

Source code in src/onesecondtrader/dashboard/routers/charts.py 
54
55
56
57
58
59
60
61
@router.get("/runs/{run_id}/trade-journey.png")
async def api_trade_journey_chart(run_id: str, symbol: str | None = None) -> Response:
    """Return a Trade Journey chart image for round-trip trades in a run, optionally filtered by symbol."""
    roundtrips = get_roundtrips(run_id)
    if symbol:
        roundtrips = [rt for rt in roundtrips if rt["symbol"] == symbol]
    image_bytes = generate_trade_journey_chart(run_id, roundtrips)
    return Response(content=image_bytes, media_type="image/png")

api_pnl_summary_chart(run_id, symbol=None) async

Return a PnL Summary chart image for round-trip trades in a run, optionally filtered by symbol.

Source code in src/onesecondtrader/dashboard/routers/charts.py 
64
65
66
67
68
69
70
71
@router.get("/runs/{run_id}/pnl-summary.png")
async def api_pnl_summary_chart(run_id: str, symbol: str | None = None) -> Response:
    """Return a PnL Summary chart image for round-trip trades in a run, optionally filtered by symbol."""
    roundtrips = get_roundtrips(run_id)
    if symbol:
        roundtrips = [rt for rt in roundtrips if rt["symbol"] == symbol]
    image_bytes = generate_pnl_summary_chart(roundtrips)
    return Response(content=image_bytes, media_type="image/png")

api_segment_chart_image(run_id, symbol, start_ns, end_ns, period_start_ns=None, period_end_ns=None, chart_type='c_bars', highlight_start_ns=None, highlight_end_ns=None) async

Return a PNG chart image for a bar segment.

Source code in src/onesecondtrader/dashboard/routers/charts.py 
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
@router.get("/runs/{run_id}/segment-chart.png")
async def api_segment_chart_image(
    run_id: str,
    symbol: str,
    start_ns: int,
    end_ns: int,
    period_start_ns: int | None = None,
    period_end_ns: int | None = None,
    chart_type: str = "c_bars",
    highlight_start_ns: int | None = None,
    highlight_end_ns: int | None = None,
) -> Response:
    """Return a PNG chart image for a bar segment."""
    strategy_key = get_strategy_key(run_id)
    chart_settings = load_chart_settings(strategy_key) or None
    image_bytes = generate_segment_chart_image(
        run_id,
        symbol,
        start_ns,
        end_ns,
        period_start_ns,
        period_end_ns,
        chart_type,
        chart_settings=chart_settings,
        highlight_start_ns=highlight_start_ns,
        highlight_end_ns=highlight_end_ns,
    )
    return Response(content=image_bytes, media_type="image/png")