# Mangrove Execution Evaluate

> Mangrove Execution Evaluate is a paid API for AI agents from api.mangrovedeveloper.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-04).

Evaluates a trading strategy's entry/exit rules against current market conditions and open positions, returning execution signals without persisting state.

## Facts

- Endpoint: POST https://api.mangrovedeveloper.ai/api/v1/execution/evaluate?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-04
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mangrove-execution-evaluate-8a60e61f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kLhQ5U9TvUJk2EvxCSBVI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mangrove-execution-evaluate-8a60e61f -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Developer references for Mangrove Agent, API contracts, MCP and AI integrations.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mangrove-execution-evaluate-8a60e61f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mangrovedeveloper.ai](https://www.zero.xyz/host/api.mangrovedeveloper.ai/llms.txt)