TradeMemory Protocol

Store a trade decision with full context into memory.

Call this after executing a trade to build your memory bank. Include market_context and reflection for better recall later.

Args: symbol: Trading instrument (e.g. "XAUUSD") direction: "long" or "short" entry_price: Entry price of the trade strategy_name: Name of the strategy used (e.g. "VolBreakout") market_context: Description of market conditions when trade was taken exit_price: Exit price (if trade is closed) pnl: Profit/loss in account currency (if trade is closed) reflection: What you learned from this trade trade_id: Optional custom ID. Auto-generated if omitted. timestamp: ISO format timestamp. Defaults to now (UTC).

Find past trades with similar market context.

Use this before making a trade to learn from past experience. Returns trades with their reflections and outcomes. Uses OWM scoring when episodic memories exist, falls back to keyword matching.

Args: symbol: Trading instrument to filter by (e.g. "XAUUSD") market_context: Current market conditions to match against strategy_name: Optional strategy filter limit: Max number of results (default 5)

Get aggregate performance stats per strategy.

Use this to evaluate which strategies are working and which need adjustment.

Args: strategy_name: Filter by strategy name. Returns all strategies if omitted. symbol: Filter by symbol. Returns all symbols if omitted.

Get the full context and reflection for a specific trade.

Use this to deep-dive into a particular trade's reasoning and lessons.

Args: trade_id: The trade ID to look up

Store a trade into OWM multi-layer memory with automatic updates.

Writes to episodic memory and automatically updates semantic (Bayesian), procedural (running averages), and affective (EWMA confidence/streaks). Also writes to trade_records for backward compatibility.

Args: symbol: Trading instrument (e.g. "XAUUSD") direction: "long" or "short" entry_price: Entry price of the trade exit_price: Exit price of the trade pnl: Profit/loss in account currency strategy_name: Strategy used (e.g. "VolBreakout") market_context: Description of market conditions pnl_r: P&L as R-multiple (risk units). Improves OWM scoring quality. context_regime: Market regime (trending_up/trending_down/ranging/volatile) context_atr_d1: ATR(14) on D1 in dollars confidence: Agent confidence level 0-1 (default 0.5) reflection: Lessons learned from this trade max_adverse_excursion: Maximum adverse excursion during the trade trade_id: Optional custom ID. Auto-generated if omitted. timestamp: ISO format timestamp. Defaults to now (UTC).

Recall memories using OWM outcome-weighted scoring.

Queries episodic and semantic memories, scores them by outcome quality, context similarity, recency, confidence, and affective modulation. Returns ranked memories with score breakdown.

Args: symbol: Trading instrument (e.g. "XAUUSD") market_context: Current market conditions to match against context_regime: Current market regime (trending_up/trending_down/ranging/volatile) context_atr_d1: Current ATR(14) on D1 in dollars strategy_name: Optional strategy filter memory_types: Types to query (default: ["episodic", "semantic"]) limit: Max results (default 10)

Get behavioral analysis from procedural memory.

Returns aggregate trading behavior stats: hold times, disposition ratio, lot sizing variance, and Kelly criterion comparison.

Args: strategy_name: Filter by strategy name. Returns all if omitted. symbol: Filter by symbol. Returns all if omitted.

Get the current agent affective state (confidence, risk, drawdown).

Returns confidence level, risk appetite, drawdown percentage, win/loss streaks, equity tracking, and a recommended action based on current drawdown severity.

Create a prospective trading plan that activates when conditions are met.

Stores a rule-based plan in prospective memory. The plan stays active until triggered, expired, or manually cancelled.

Args: trigger_type: Type of trigger (e.g. "market_condition", "drawdown", "time_based") trigger_condition: JSON string describing when to trigger (e.g. '{"regime": "ranging"}') planned_action: JSON string describing what to do (e.g. '{"type": "skip_trade"}') reasoning: Why this plan was created expiry_days: Days until plan expires (default 30) priority: Priority 0-1, higher = checked first (default 0.5)

Check active trading plans against current market context.

Queries all active prospective plans, expires any past their expiry date, and matches remaining plans against the provided context.

Args: context_regime: Current market regime (trending_up/trending_down/ranging/volatile) context_atr_d1: Current ATR(14) on D1 in dollars