{"uid":"cap_kLhQ5U9TvUJk2EvxCSBVI","slug":"mangrove-execution-evaluate-8a60e61f","name":"Mangrove Execution Evaluate","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/execution/evaluate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"persist":{"type":"boolean","default":false,"description":"Whether to persist results (default False for object-based)."},"strategy":{"type":"object","required":["asset","rules"],"properties":{"name":{"type":"string","description":"Strategy name."},"asset":{"type":"string","description":"Asset symbol (e.g., BTC)."},"rules":{"type":"object","description":"Entry/exit rules (JSON)."},"base_token":{"type":"string","description":"Canonical base token of the selected market."},"quote_token":{"type":"string","description":"Recorded market quote token."},"execution_state":{"type":"object","description":"Initial execution state (balances, trade counts)."},"execution_config":{"type":"object","description":"Execution configuration (risk management, position limits)."},"market_data_venue":{"type":"string","description":"Recorded market data venue."}},"description":"Strategy object to evaluate."},"open_positions":{"type":"array","items":{"type":"object"},"description":"Caller-owned open positions (stateless lane); authoritative set returned on the response."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_E8ypnHOPhunWZx_NUXiRg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates a trading strategy's entry/exit rules against current market conditions and open positions, returning execution signals without persisting state.","exampleAgentPrompt":"Evaluate my BTC momentum strategy with entry rule 'RSI < 30' and exit rule 'RSI > 70', using my current open positions of 0.5 BTC long, with a max position limit of 1 BTC and starting balance of 10000 USDC — don't persist the results.","exampleUseCases":[{"title":"Algo bot pre-trade signal check","prompt":"Before placing any trades, evaluate my ETH scalping strategy with these entry rules — buy when price crosses above 20-period MA — and exit rules — sell when price drops 2% below entry. I have one open ETH long position right now. Don't save the results, just tell me if I should act."},{"title":"Risk-aware position evaluation","prompt":"Run my BTC strategy evaluation with a max drawdown limit of 5% and no more than 3 open positions at once. My current execution state shows 2 open trades and a balance of 5000 USDC. Tell me if the strategy rules say to open another position."},{"title":"Backtesting rule logic without persistence","prompt":"I want to test my SOL trend-following strategy object — asset is SOL, entry rule is 'price above 50-day MA', exit is 'price below 10-day MA' — against my two current open positions without storing anything. What does the evaluation return?"}],"resultDescription":"Returns an evaluation result containing execution signals (enter, exit, hold), an authoritative set of open positions after applying the strategy rules, and any updated execution state metrics such as trade counts and balance changes.","failureModes":["Missing required 'asset' or 'rules' fields in strategy object returns 400 validation error","Invalid rule JSON structure causes parsing failure","Malformed open_positions array entries cause type errors","Payment not provided or insufficient USDC results in 402 Payment Required","Conflicting execution_state values may produce unexpected signals","Unknown asset symbol may return empty or null signals"],"whenToPreferThis":"Use this endpoint when you need to evaluate a structured trading strategy's rules against live or provided market conditions and open positions in a stateless (non-persisting) manner. Prefer this over full execution endpoints when you want signal computation without committing trades or saving state, or when testing rule logic programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:36:33.225Z","isFirstParty":false,"canonicalSlug":"mangrove-execution-evaluate-8a60e61f"}