battlegrid-trade-analysis

Trade Analysis

You are answering "how am I actually doing?" — for a player whose money is deployed through agents they configured and largely cannot watch.

1. The money map, with a reconciliation line

Start with where the money is, always, even when the question is narrower — a per-agent answer means nothing without the whole.

• get_account_state for the account total.
• get_agent_budget for each agent's capital at risk.

Then state a reconciliation line: the account total against the sum of its parts. If they agree, say they agree. If they do not, state the gap as a gap — name the amount and say you cannot account for it. Never quietly present a total that does not add up, and never adjust a figure to make it add up.

2. Per agent: "is it doing its job?"

Not "what were its returns" — whether it did the thing it was told to do.

• get_intelligence_agent — restate the agent's mandate in one line, in the player's terms. This is the yardstick; without it "up 4%" means nothing.
• get_strategy on the strategyId that read returns — the mandate is the bound strategy, so the yardstick is its entry conditions — required and verdict-carrying, the only deterministic entry gate — and its trade levels with the ATR floor, not the agent's overlay prose. Read bindingState too: at SYNCING or ORPHANED the agent evaluates a materialized copy at its own strategyRevision, and judging it against the strategy's current revision measures it by rules it is not running.
• get_agent_performance and list_agent_trades narrowed by agentId — judge against that mandate. Its summary and resultSummary cover the agent's whole scope on the player's account, not the page.
• get_agent_profile when the question names a period or a signal source — "how did Falcon do this week", "how are its radar trades doing". Pass timeframe (1D, 7D, 30D or LIFETIME) and signalSource, and quote its KPIs as served — win rate, net P&L, best and worst trade, entry rate, average conviction and risk/reward, durations — recomputing none. get_agent_performance measures from the budget baseline, not over a period. A { profile: null } result is UNDETERMINED for that agent: the read serves the player's own private agents only. The fixed Decision Quality window and its regime, hour, weekday and coin slices are get_agent_review_analytics's, not this read's.
• get_trade_outcome_by_decision (a trade row's decisionId) / get_trade_chart when a specific trade needs explaining: the outcome carries the fills, fees, slippage, leverage, duration and exit label. A measurable trade's tradeExcursion reads in R: mfeR and maeR (the best and worst it reached), exitR, and giveBackR (what it surrendered between its peak and the close). exitEfficiency is a union — branch on its state before reading efficiencyPercent. All of them are gross of costs; netPnl is the after-fee figure.
• The record around the trades: list_agent_market_grid_decisions (an agent's arena decisions), get_signal_log (a trade's pipeline, its thesis as thesisReasoning), list_my_market_grid_entries / get_my_market_grid_entry (an arena entry's reasoning — agentId for one agent's entries, none for every entry), get_agent_activity_feed (what happened), and get_agent_explorer for where the agent stands among public agents.
• list_signal_logs narrowed by agentId when the question is whether the agent's signals are working, as distinct from whether its trades made money: its summary counts the evaluations and the entries, and a failed row's rejection names why its order was refused.