# mylittlechart

> Free open-source desktop trading terminal with 462+ technical indicators, 60+ exchange connectors, and a local Agent API for programmatic access.

mylittlechart is a native desktop application (Windows, macOS, Linux) for cryptocurrency and stock market charting. Built in Rust with GPU-accelerated rendering.

## Documentation

- [Changelog](https://mylittlechart.org/changelog): Version history and release notes
- [Roadmap](https://mylittlechart.org/roadmap): Planned features and development status
- [Privacy Policy](https://mylittlechart.org/privacy): Data handling and privacy practices
- [Terms of Service](https://mylittlechart.org/terms): Usage terms

## Downloads

- [Windows (x64)](https://mylittlechart.org/api/updates/latest?platform=win64): Latest Windows build metadata (JSON)
- [macOS (ARM)](https://mylittlechart.org/api/updates/latest?platform=macos-arm64): Latest macOS build metadata (JSON)
- [Linux (x64)](https://mylittlechart.org/api/updates/latest?platform=linux64): Latest Linux build metadata (JSON)

## Agent API

mylittlechart exposes a local REST API on port 17420 for AI agents and scripts to interact with the running terminal.

Authentication: Bearer token via `Authorization: Bearer <api_key>` header or `?api_key=<key>` query parameter.
Keys are generated in the terminal's User Settings panel. Three tiers: read_only, read_write, admin.

### Endpoints

Health:
- `GET /api/v1/health` — Server status (no auth required)

Market Data:
- `GET /api/v1/bars?exchange={id}&symbol={pair}&timeframe={tf}&limit={n}` — OHLCV candle data
- `GET /api/v1/connectors` — List available exchange connectors
- `GET /api/v1/watchlists` — Current watchlist symbols and prices

Window Discovery:
- `GET /api/v1/windows` — List all open windows with IDs
- `GET /api/v1/windows/{id}` — Window details (tabs, active chart)
- `GET /api/v1/windows/{id}/tabs` — List tabs in a window
- `GET /api/v1/windows/{id}/tabs/{tab}/charts` — Charts in a tab
- `GET /api/v1/windows/{id}/tabs/{tab}/charts/{chart}` — Single chart state

Chart Control (read_write tier):
- `POST /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/viewport` — Set view_start, bar_spacing, or named mode (fit_all, latest, zoom_in, zoom_out)
- `POST /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/symbol` — Switch symbol on a chart

Indicators:
- `GET /api/v1/indicators?symbol={pair}` — Computed indicator values for a symbol
- `GET /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/indicators` — List indicators on a chart
- `POST /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/indicators` — Add indicator
- `PATCH /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/indicators/{ind_id}` — Update indicator params
- `DELETE /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/indicators/{ind_id}` — Remove indicator

Drawing Primitives:
- `GET /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/primitives` — List drawings
- `POST /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/primitives` — Add drawing
- `PATCH /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/primitives/{prim_id}` — Update drawing
- `DELETE /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/primitives/{prim_id}` — Remove drawing

Catalog:
- `GET /api/v1/catalog/indicators?search={query}` — Search 462+ indicators by name
- `GET /api/v1/catalog/primitives` — List all 100+ drawing tool types

Screenshots:
- `POST /api/v1/windows/{id}/tabs/{tab}/charts/{chart}/screenshot` — Capture chart as PNG (base64, sync, 5s timeout)

API Key Management (admin tier):
- `GET /api/v1/keys` — List API keys
- `POST /api/v1/keys` — Create new API key
- `DELETE /api/v1/keys/{label}` — Delete API key

### CLI Tool

`zengeld-agent` is a standalone CLI client for the Agent API.
Config: `~/.zengeld-agent.toml` with `endpoint` and `api_key` fields.
Default endpoint: `http://localhost:17420`

### Write Semantics

All write endpoints (POST/PATCH/DELETE) return `202 Accepted` immediately. Commands are queued and applied on the next render frame. Only `screenshot` is synchronous.

## Product Capabilities

### Technical Indicators (462+)
22 categories: Average (22), Momentum (94), Channels (42), Signal Processing (55), Volatility (41), Statistics (25), Candles (18), Volume (17), Levels (19), Accumulation (13), Entropy (12), Kalman (11), Trend (15), Trend Stop (11), Chaos (11), Regression (6), Adaptive (5), Position (18), Divergence (13), Book (4), Clusters (6), Ratio (4)

### Exchange Connectors (60+)
CEX: Binance, Bybit, OKX, KuCoin, Kraken, Coinbase, Gate.io, MEXC, HTX, Bitget, BingX, Bitfinex, Bitstamp, Gemini, Phemex, Crypto.com, Upbit, Deribit
DEX: HyperLiquid, dYdX, Paradex, Lighter.xyz, Uniswap, Jupiter, Raydium, GMX, Polymarket
Data: Polygon.io, Finnhub, Tiingo, Twelvedata, CryptoCompare, Coinglass, WhaleAlert, Bitquery, DefiLlama, Yahoo Finance, Alpha Vantage, Dukascopy, FRED, BLS, JQuants, KRX
Brokers: Alpaca, Interactive Brokers, Oanda, Angel One, Zerodha, Fyers, Dhan, Upstox, Tinkoff, MOEX

### Drawing Tools (100+)
14 categories: Lines (9), Channels (4), Shapes (10), Fibonacci (11), Pitchforks (4), Gann (4), Elliott Wave (5), Patterns (6), Cycles (3), Projection (5), Volume Profile (2), Measurement (3), Annotations (13), Brushes (2)

### Chart Types (8)
Candles, Hollow Candles, Heikin Ashi, OHLC Bars, Line, Area, Baseline, Histogram

### Timeframes
Standard: 1m, 5m, 15m, 30m, 1H, 4H, 1D, 1W, 1M
Custom timeframes supported (any minute value)

### Alerts (12 conditions, 5 sources, 4 delivery channels)
Conditions: Crossing Up/Down/Both, Greater/Less Than, Entering/Exiting/Inside/Outside Channel, Moving Up/Down %
Sources: Price level, Drawing primitive, Indicator line, Crossing pair, Signal
Delivery: Popup, Sound, Webhook, Telegram bot

## Community

- [Discord](https://discord.gg/4rCD8yaF): Community chat and support
- [Telegram](https://t.me/mylittlechart): Telegram group
- [GitHub](https://github.com/ZENG3LD): Source code and releases

## Optional

- [Update API](https://mylittlechart.org/api/updates/latest?platform=win64): JSON metadata for latest release (version, sha256, download_url, file_size)