Documentation

psych is an on-chain behavioral analytics platform for Solana traders. It reads the public swap history from any wallet, runs pattern detection across trade sequences, computes realized P&L, and surfaces the psychological habits that most traders never notice in themselves.

It is not a portfolio tracker. It is not a trading terminal. It does not tell you what to buy. It tells you how you behave, and where that behavior costs you money.

P&L computed across six time windows (1D, 7D, 30D, 90D, 180D, 1Y) using FIFO cost basis on your actual on-chain swaps. Includes an interactive equity curve, win rate, profit factor, expectancy, max drawdown, average hold time, and per-DEX trade breakdown.

All metrics are derived from priced swaps. Unpriced trades (missing USD value) are excluded from statistics but still appear in the timeline.

16+ patterns detected automatically from trade timing, sizing, and sequencing:

Revenge trading — Rapid re-entry after a loss, usually with larger size.

Tilt streaks — Clusters of losing trades in short time windows.

Overtrading — Excessive trade frequency relative to your baseline.

Loss clustering — Repeated losses on the same token or pair.

Time-of-day bias — Concentration of losing trades at specific hours.

Position sizing drift — Gradual or sudden deviation from normal trade sizes.

Streaming AI chat with full server-side context injection. The model receives your PnL summary, recent trades, behavioral signals, DEX usage breakdown, and active guardrail rules before generating a response.

The coach analyzes discipline, not markets. It will call out tilt, acknowledge streaks of consistency, and give concrete behavioral action items. Responses include sentiment tags that drive the companion cat's reactions.

Full swap parsing and source attribution across the Solana DEX ecosystem:

Jupiter — v4 and v6 aggregator. Detected via Helius source labels with aggregator precedence.

Raydium — AMM, CLMM, and CPMM pools.

Orca — Whirlpool concentrated liquidity.

Meteora — DLMM and standard pools.

Pump.fun — Bonding curve AMM. Parsed via token/native transfer reconstruction when structured swap events are absent.

Attribution uses Helius labels first, then falls back to program ID matching.

Theme switching between dark, light, and system preference. Cat reactivity tuning (low, normal, high). Reduced motion toggle. Trade data export to CSV and JSON. One-click deletion of all stored data.

Settings persist to localStorage immediately and sync to the database when a wallet is connected.

psych reads public on-chain data only. No private keys are ever requested or stored. No wallet signatures. No exchange API connections.

All data can be exported or deleted at any time from the settings page. The same information psych reads is visible to anyone on a block explorer.

Is this financial advice?

No. psych is a behavioral analysis tool. It does not recommend trades, tokens, or positions.

Why only Solana?

Solana has the fastest and most active DEX ecosystem with fully parseable on-chain swap data. Every trade is visible and attributable.

What about CEX trades?

Centralized exchange trades happen off-chain and are not visible from a wallet address. psych only analyzes on-chain DEX swaps.

How is P&L calculated?

FIFO (first-in, first-out) cost basis. Buy entries are tracked per token mint, and sells are matched against the oldest open position. USD pricing comes from Jupiter Price API.

What if my wallet has thousands of transactions?

psych fetches up to 300 recent transactions per sync, which is sufficient for meaningful behavioral analysis across all time windows.