Tradia Agentic Trading OS

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/tradia

⚠️ Not financial advice. Human review required before acting on any trade.

Why Tradia?

Every 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 |

One workflow, four commands

# 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

What's inside

| 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 |

SDK (in your code)

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 }

CLI Reference

| 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 |

API Server

# 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
  }'

Talocode Cloud

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.

Safety

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

License

MIT