Your trading journal, risk engine, and proposal system — in one CLI and SDK.
Stop spreadsheeting your trades. Tradia gives you structured proposals, position sizing, risk checks, journals, backtests, and accountability reports from your terminal.
npm install @talocode/tradiaEvery trader hits the same wall: you take a trade, forget why, and repeat the same mistake. Tradia codifies your process so every decision is planned, reviewed, and learned from.
| Without Tradia | With Tradia |
|---|---|
| Gut-feel entries | Structured proposals with invalidation criteria |
| Forgot why you entered | Journals with lessons and discipline scores |
| No idea if your strategy works | Backtest equity curves, win rates, drawdowns |
| No accountability | Public updates explaining your trades |
# 1. Propose a trade — get a structured plan with risk baked in
tradia propose --symbol XAUUSD --market forex --strategy liquidity_sweep --balance 500 --risk 0.5 --entry 2365.5 --stop 2372 --target 2350
# 2. Journal the result — capture the lesson
tradia journal --file trade-result.json
# 3. Analyze your performance
tradia performance --file trades.json
# 4. Share accountability
tradia public-update --file performance-report.json| Capability | What it does |
|---|---|
| Proposal Engine | Generates structured trade proposals with entry, stop, target, invalidation, and risk-reward |
| Risk Engine | Position sizing, max drawdown, exposure limits, revenge trading detection |
| Journals | Trade entries with lessons, discipline scores, emotional state tracking |
| Performance Analysis | Win rate, profit factor, expectancy, max drawdown, R-multiples |
| Backtest Simulation | Equity curves, Monte Carlo, strategy comparison |
| Accountability Cards | Public-facing trade explanations for transparency |
| Portfolio Reports | Account-level performance summaries across all positions |
| Exports | Markdown and JSON for sharing or further analysis |
import { TradiaClient } from '@talocode/tradia'
const tradia = new TradiaClient()
// Propose a trade with full risk analysis
const proposal = await tradia.trade.propose({
market: 'forex',
symbol: 'XAUUSD',
accountBalance: 500,
riskPercent: 0.5,
strategy: 'liquidity_sweep',
entry: 2365.5,
stopLoss: 2372,
takeProfit: 2350,
})
// → { entry, stopLoss, takeProfit, riskReward, positionSize, maxDrawdown, invalidation }
// Journal the outcome
const journal = await tradia.trade.journal({
trade: proposal,
outcome: { pnl: 45.20, closed: true },
lessons: ['Waited for confirmation — good discipline'],
})
// → { disciplineScore, lessons, emotionalState }
// Analyze performance over time
const analysis = await tradia.performance.analyze({
trades: [journal, journal2, journal3],
accountBalance: 500,
})
// → { winRate, profitFactor, expectancy, maxDrawdown }| Command | Description |
|---|---|
tradia propose |
Generate a structured trade proposal |
tradia risk |
Check risk parameters and position sizing |
tradia journal |
Create a trade journal entry |
tradia performance |
Analyze trading performance |
tradia backtest |
Run a backtest simulation |
tradia portfolio |
Generate a portfolio report |
tradia public-update |
Generate a public accountability update |
tradia export |
Export data as markdown or JSON |
# Start local server
PORT=3070 npx tradia-server
# Use any endpoint
curl -X POST http://localhost:3070/v1/tradia/trade/propose \
-H 'Content-Type: application/json' \
-d '{
"symbol": "XAUUSD",
"market": "forex",
"accountBalance": 500,
"riskPercent": 0.5,
"entry": 2365.5,
"stopLoss": 2372,
"takeProfit": 2350
}'import { TradiaClient } from '@talocode/tradia'
const tradia = new TradiaClient({
apiKey: process.env.TALOCODE_API_KEY,
useCloud: true,
})All 14 endpoints available via Talocode Cloud API at api.talocode.site.
Tradia v0.1 is agentic trading intelligence, not live autonomous execution.
- No real trade execution — does not connect to any broker
- No financial advice — all outputs are educational analysis
- No guaranteed profits — past performance does not guarantee future results
- Human review required before action
Part of Talocode — open-source workflow layers for builders. Explore sibling projects:
| Project | What it is |
|---|---|
| ScreenLane | Screen-aware voice command layer |
| Tera | AI chat & assistant |
| Codra | Local coding agent |
| GateLane | MCP gateway & agent tool control plane |
| ContextLane | Context ingestion for persistent agents |
| MemoryLane | Persistent agent memory |
| SignalLane | X growth intelligence |
| ReplyLane | X reply opportunity intelligence |
| CrawlerLane | Crawler / SEO intelligence |
| WebDataLane | Web extraction to structured data |
| SearchLane | Search layer for agents |
| InvoiceLane | Invoicing tools |
| GeoLane | Geo intelligence |
| UgcLane | UGC workflows |
| OpenSourceLane | Open-source distribution tools |
| StackLane | Builder stack platform |
| Tradia | Trading intelligence (this repo) |
| Agent Browser | Browser automation for agents |
| Talocode | Org home & control plane |
| Skills | Shared agent skills |
| X Agent | X automation agent |
| LaunchPix | Launch tooling |
| ForgeCAD | CAD workflows |
| WorkLane | Work automation |
| ClipLoop | Clip / video loops |
MCP-compatible agents integrate via each product's MCP server where available (Model Context Protocol).
More: github.com/talocode · talocode.site · docs.talocode.site
MIT