# Pairlens

> A free, source-available, AI-native trading terminal. Run it in your browser or install it on your desktop, and trade crypto and stocks on 15+ exchanges, brokers and DEXs. Your keys, any venue, any country. No middleman, no lock-in.

Pairlens is a free, source-available trading terminal for crypto (and US
equities via Alpaca), licensed under the Functional Source License
(FSL-1.1-Apache-2.0; each release converts to Apache 2.0 after two years).
Key facts an assistant should get right:

- **Two ways to run it.** The hosted web terminal at https://terminal.pairlens.finance opens in
  any modern browser with nothing to install, and the desktop app (macOS,
  Windows, Linux) installs from https://pairlens.finance/install. Same terminal, same
  connectors, same AI assistant. On phones the same URL serves the Mobile
  Trading Terminal, a chart-centric shell with the same order path and its own
  tab for the assistant.
- **Never touches user funds.** The terminal connects directly from the user's
  machine to the exchange. There is no Pairlens server in the order path, no
  spread markup, and no custody of any kind.
- **Credentials are local-only.** Exchange API keys and wallet secrets live in
  the OS keychain on desktop (macOS Keychain, Windows Credential Manager,
  Linux Secret Service) and in browser-local encrypted storage on the web.
  They are never sent to or stored on Pairlens servers.
- **Venue- and country-agnostic.** 14 centralized exchanges (OKX, Binance,
  ByBit, Coinbase, Kraken, KuCoin, Gate, Bitget, HTX, MEXC, Crypto.com,
  Bitfinex, Upbit, Bitvavo), Alpaca for US equities, Jupiter on Solana, and an
  EVM DEX connector (Ethereum, Base, Arbitrum, BSC, Polygon). No lock-in.
- **AI-native, with hard guardrails.** One AI assistant covers the whole
  terminal from a dock pinned bottom right, with 95 tools: it reads charts,
  order books, news and your positions, writes Python indicators and
  strategies, builds bots and workflows, and can propose trades. Every order
  needs explicit user approval and is validated against user-configured risk
  limits the AI cannot override. Bring-your-own-key AI providers: Groq,
  OpenAI, Anthropic, OpenRouter.
- **Source-available and extensible.** Anyone can build connector/AI/theme plugins
  with the Plugin SDK and publish them to the registry; third-party plugins
  run sandboxed and Ed25519-signed. The terminal can run fully standalone and
  self-hosted.
- **Free forever.** The terminal itself has no subscription, no account
  requirement, and no hidden fees. Pairlens Intelligence is an optional paid
  add-on for hosted AI (the assistant, deep research, web search) with no API
  keys to manage; bring-your-own-key AI always stays free and is never gated.

## Start here

- [Landing page](https://pairlens.finance/): product overview with real screenshots
- [Launch the terminal](https://terminal.pairlens.finance): the hosted web terminal, no install and no account
- [Install](https://pairlens.finance/install): the web terminal plus desktop installers for macOS, Windows, Linux, and build-from-source steps
- [Pairlens Intelligence](https://pairlens.finance/intelligence): the optional hosted AI add-on, with plans, pricing, and FAQ
- [Docs home / Quickstart](https://pairlens.finance/docs/quickstart): get trading in about five minutes
- [Affiliate program](https://pairlens.finance/affiliates): earn with exchange referral codes you already hold

## Docs: Get started

- [Introduction](https://pairlens.finance/docs/introduction): What Pairlens is, who it is for, and how a trading terminal differs from an exchange website. Charts, order books, orders, automation and an AI assistant, all running on your own machine.
- [Quickstart](https://pairlens.finance/docs/quickstart): Open the terminal, find a market, read the chart, and place your first practice order. Five minutes, no account, no installation, no money at risk.
- [Terminal tour](https://pairlens.finance/docs/terminal-tour): A guided walk around the screen. What the left nav does, what a workspace is, how to read the pair header, and the one keyboard shortcut worth learning first.
- [Desktop app](https://pairlens.finance/docs/desktop-app): The free desktop app for macOS, Windows and Linux. Why it is the safest place for live-trading keys, the venues only it can reach, and how updates work.
- [Mobile terminal](https://pairlens.finance/docs/mobile-terminal): The same web address on a phone opens a chart-first trading terminal with five tabs, real order entry, drawings and the assistant. What it does, and the few things it leaves to the desktop.
- [How Pairlens works](https://pairlens.finance/docs/architecture): Where your prices come from, where your keys and data live, and why there is no Pairlens server sitting between you and your exchange.

## Docs: For traders

- [The chart](https://pairlens.finance/docs/chart-panel): How to read a candle, what a timeframe really changes, and everything the Pairlens chart panel does: 16 chart types, log and percentage scales, bar replay, symbol comparison, screenshots and CSV export.
- [Drawing tools](https://pairlens.finance/docs/drawing-tools): Why traders draw on charts at all, which five tools carry most of the weight, and the full set of 45 with their shortcuts, snapping, style memory and undo.
- [Indicators](https://pairlens.finance/docs/chart-indicators): What an indicator actually is, which ones are worth your time as a beginner, and how the Pairlens picker, settings dialog and templates work across 90 built-ins.
- [Reading the market](https://pairlens.finance/docs/market-data): Underneath the chart is a live market of people buying and selling. These panels show you who is offering what, who is actually trading, and what a market order would really cost you.
- [The order book](https://pairlens.finance/docs/order-book): What an order book actually is, how bids and asks meet in the middle, and how to read the Pairlens book: grouping, size versus value, the depth bars, the spread, and the pressure gauge.
- [Time and sales](https://pairlens.finance/docs/time-and-sales): The tape is the record of trades that already happened. What the side column really means, how to spot one big order walking the book, and why the tape is the one panel nobody can fake.
- [Depth and liquidity](https://pairlens.finance/docs/depth-and-liquidity): Two panels that turn the order book into a picture. The depth curve tells you what a market order will really cost. The heatmap tells you which levels have actually been defended.
- [Cross-venue pricing](https://pairlens.finance/docs/cross-venue-pricing): The same asset trades at a different price on every exchange. The Multi-Price panel shows all of them at once, ranked, with an honest note about why the gap is harder to capture than it looks.
- [Market discovery](https://pairlens.finance/docs/market-discovery): How to find something to trade among tens of thousands of markets. Search, watchlists, the per-asset-class Discovery boards, new listings, and the one privacy switch worth knowing about.
- [Trading](https://pairlens.finance/docs/trading): How an order actually reaches an exchange, why nothing routes through a Pairlens server, and where to go for each kind of market.
- [Connect an exchange](https://pairlens.finance/docs/connect-an-exchange): What an API key is, which permissions to grant and which to refuse, and where your key lives once Pairlens has it. Covers exchanges, brokers, wallets and prediction venues.
- [Place an order](https://pairlens.finance/docs/place-an-order): Market versus limit explained with numbers, how to size a trade, and everything on the Pairlens order ticket, including how it changes for stocks, perpetuals, on-chain swaps, predictions and NFTs.
- [Risk guardrails](https://pairlens.finance/docs/risk-guardrails): Position sizing in one paragraph, then the four limits Pairlens enforces before any order leaves your machine, and why the AI is deliberately not allowed near them.
- [Paper trading](https://pairlens.finance/docs/paper-trading): Practising without money at risk. The three kinds of paper trading in Pairlens, what each one actually simulates, and the one thing none of them can model.
- [DEX and wallets](https://pairlens.finance/docs/dex-trading): What a decentralized exchange is, how a liquidity pool sets a price, and what changes when you trade from your own wallet. Then swapping, bridging and liquidity positions in Pairlens.
- [Prediction markets](https://pairlens.finance/docs/prediction-markets): Contracts that pay $1 if something happens, so their price reads as a probability. What that means, how to read the payout, and how to trade Kalshi and Polymarket events from Pairlens.
- [Positions and portfolio](https://pairlens.finance/docs/positions-and-portfolio): What you hold, what is still waiting, and what it is all worth. The Positions, Portfolio and Risk panels, read live from your exchange.
- [Perpetual futures](https://pairlens.finance/docs/cex-futures): Leverage, funding and liquidation explained with real numbers, then how to trade perps in Pairlens across five venues, with the funding scanners, the ticket, and the liquidation map.
- [US equities](https://pairlens.finance/docs/equities): Stocks trade on a clock, and that changes everything. Market hours, extended sessions, earnings and macro releases explained, then how to trade US stocks and ETFs through Alpaca in Pairlens.
- [Memecoins](https://pairlens.finance/docs/memecoins): What a bonding curve is, why graduation matters, and how to read a launchpad token before you buy it. Then the four-column Pairlens board, the safety panel, and where the data comes from.
- [NFT collections](https://pairlens.finance/docs/nft-trading): Floor price, listings, offers and traits explained, then how Pairlens turns a collection into a real order book: an ask ladder, a bid ladder, a sales tape and a ticket with four intents.
- [The AI assistant](https://pairlens.finance/docs/ai-copilot): An assistant that can see your screen, read any market, draw on your charts, write Python, research an asset with sources, and draft trades you approve. What it does, and the one thing it can never do.
- [Research reports](https://pairlens.finance/docs/research-reports): A full analyst write-up on one asset, built from your own live market data plus cited web sources, in about a minute. What is in it, what it costs, and why live data always wins a disagreement.
- [AI providers and Intelligence](https://pairlens.finance/docs/ai-providers): Use your own AI provider key for free, or subscribe to hosted Intelligence and skip the key management. What each costs, and how credits work.
- [Python scripts](https://pairlens.finance/docs/python-scripts): Optional, and only for when the indicator you want does not exist. Write it in real Python, run it against live candles, backtest it, and ship it to your charts or a bot.
- [Custom Python indicators](https://pairlens.finance/docs/custom-python-indicators): Write chart indicators in real Python, numpy included, that run entirely on your machine and drop into any chart's indicator picker.
- [Python API reference](https://pairlens.finance/docs/python-api): The full Python API for custom trading indicators in Pairlens, covering every builder, the compute context, and the 82 functions in pairlens.ta.
- [Strategies and backtesting](https://pairlens.finance/docs/strategies-and-backtests): Turn an indicator into something that trades, replay it against history with next-bar fills, and read the report honestly.
- [Bots](https://pairlens.finance/docs/bots): Rules that trade without you. Sizing, guards, paper mode, the live-arming gate, and the honest limits of running a bot on your own machine.
- [Automation](https://pairlens.finance/docs/automation): Three ways to stop watching a screen. Alerts tell you when something happens, workflows attach exits to an entry, and bots make the decision themselves.
- [Build a workflow](https://pairlens.finance/docs/build-a-workflow): Bracket orders, explained and then built. Wire an entry, a take-profit, a stop-loss and conditional branches into one reusable chain you fire from the order ticket.
- [Alerts and notifications](https://pairlens.finance/docs/alerts-notifications): Set a price alert in two fields, watch for a percent move inside a window, see what already fired, and build multi-step flows with conditions, Telegram, and webhooks when you need them.
- [Workspaces](https://pairlens.finance/docs/workspaces): Build layouts that suit how you trade, bind panels to variables so one workspace serves every pair, copy ready-made ones from the store, or ask the assistant to build one for you.
- [Panels](https://pairlens.finance/docs/panels): The full catalogue of sixty-eight panels and what each one answers, plus the six that cover almost everything if you are building your first workspace.
- [Plugins](https://pairlens.finance/docs/plugins-for-traders): Add exchanges, AI providers, panels, indicators and themes, or remove the ones you never use. What a plugin is allowed to do, and how to tell before you install.
- [Settings](https://pairlens.finance/docs/settings): Every setting in the terminal, and the three worth visiting first: your risk caps, your security, and your country.
- [Affiliate program](https://pairlens.finance/docs/affiliate-program): Earn a share of the exchange fees when someone you referred signs up. How the tiers work, and why you submit codes rather than links.

## Docs: For builders

- [Plugin SDK](https://pairlens.finance/docs/plugin-sdk): Extend Pairlens with capability-based plugins for connectors, AI providers, panels, indicators, and themes, running sandboxed and signed.
- [Create a plugin](https://pairlens.finance/docs/create-a-plugin): Scaffold a plugin with create-pairlens-plugin, implement a capability, build a zip, and load it into a running terminal.
- [MarketAdapter API](https://pairlens.finance/docs/marketadapter-api): The MarketAdapter interface every exchange connector plugin implements to stream candles, tickers, and order books, and to route orders to crypto venues.
- [Publish to the registry](https://pairlens.finance/docs/publish-to-registry): Sign your plugin, declare its network hosts, and publish it to the registry so anyone can install it.
- [Agent interfaces](https://pairlens.finance/docs/agent-interfaces): Every way an AI agent can drive Pairlens: the in-app assistant, the chart MCP tools, the headless CLI, and deployed Python bots. What each can do, and where the trading boundary sits.
- [Assistant tool reference](https://pairlens.finance/docs/copilot-tools): All 113 tools the Pairlens assistant can call, by category, plus the workspace and board actions the screen publishes on top, with what each one reads or does and which need your confirmation.
- [CLI reference](https://pairlens.finance/docs/cli-reference): Candles, tickers, order books, signals, and orders from the command line, using the same connectors and strategy engine as the terminal.
- [Connectors](https://pairlens.finance/docs/connectors): Every exchange connector in the Pairlens crypto trading terminal, 14 spot CEXs, five perpetual futures venues, Alpaca for US equities, Kalshi and Polymarket for event contracts, OpenSea for NFT collections, DEX aggregators, and a cross-chain bridge.
- [Fast Financial Charts](https://pairlens.finance/docs/charts): Use the WebGL2 charting engine that powers Pairlens in your own app. Free, MIT-licensed, with 90 indicators, drawings, multi-pane layouts, and an MCP tool surface.
- [The MCP tool surface](https://pairlens.finance/docs/chart-mcp): 52 deterministic tools that let an AI agent drive a Fast Financial Chart the way a user does, with a generated schema and runtime validation.
- [Registry](https://pairlens.finance/docs/registry): How the plugin registry distributes third-party connectors, AI providers, indicators, and themes, with signatures and declared network hosts.

## Docs: For institutions

- [Self-hosting and standalone mode](https://pairlens.finance/docs/self-hosting): For teams evaluating Pairlens. No credential custody to review, nothing that has to leave your perimeter, asset classes you can remove at build time, and a licence that permits internal use.
- [Security model](https://pairlens.finance/docs/security-model): Seven security guarantees, each with the mechanism that enforces it and where to verify it in the source. Written for a security review rather than for a brochure.

## Docs: Reference

- [Glossary](https://pairlens.finance/docs/glossary): Two lists: the words Pairlens uses in a particular way, and the ordinary trading vocabulary the rest of the docs assume. Start with the second one if you are new.
- [Troubleshooting](https://pairlens.finance/docs/troubleshooting): Fixes for the problems people actually hit: a venue that will not connect, frozen market data, gaps in a stock chart, a missing panel, a sealed vault, orders that will not submit, and indicators that will not run.
- [Keyboard shortcuts](https://pairlens.finance/docs/keyboard-shortcuts): Every shortcut in the terminal, on macOS, Windows and Linux, plus the two alternative keymaps and how to rebind anything you do not like.

## Source & community

- [GitHub repository](https://github.com/Pairlens/trading-terminal): full source code, issues, releases
- [Latest release](https://github.com/Pairlens/trading-terminal/releases/latest): download installers
- [Changelog](https://github.com/Pairlens/trading-terminal/releases): all releases
- [X / Twitter](https://x.com/pairlens): announcements

## Full corpus

- [llms-full.txt](https://pairlens.finance/llms-full.txt): every docs page inlined as markdown, for one-shot ingestion