{"uid":"cap_s08Pu4ZwM4UAWODb0rfxQ","slug":"mangrove-developer-backtests-api-8b65d423","name":"Mangrove Developer Backtests API","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v2/backtests?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"seed":{"type":"integer"},"asset":{"type":"string"},"fee_pct":{"type":"number"},"end_date":{"type":"string"},"exchange":{"type":"string"},"interval":{"type":"string"},"data_file":{"type":"string"},"base_token":{"type":"string"},"generation":{"type":"integer"},"start_date":{"type":"string"},"data_source":{"type":"string"},"quote_token":{"type":"string"},"strategy_id":{"type":"string"},"slippage_pct":{"type":"number"},"cooldown_bars":{"type":"integer"},"strategy_json":{"type":"string"},"corpus_dataset":{"type":"string"},"initial_balance":{"type":"number"},"lookback_months":{"type":"integer"},"volatility_mode":{"type":"string"},"execution_config":{"type":"object"},"hourly_data_file":{"type":"string"},"max_trade_amount":{"type":"number"},"min_trade_amount":{"type":"number"},"market_data_venue":{"type":"string"},"target_volatility":{"type":"number"},"volatility_window":{"type":"integer"},"max_open_positions":{"type":"integer"},"max_risk_per_trade":{"type":"number"},"max_trades_per_day":{"type":"integer"},"max_units_per_trade":{"type":"number"},"daily_momentum_limit":{"type":"number"},"initial_asset_balance":{"type":"number"},"min_balance_threshold":{"type":"number"},"weekly_momentum_limit":{"type":"number"},"enable_volatility_adjustment":{"type":"boolean"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8KK1u-6gXTGuwFHOfgr8T","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a backtest simulation of a trading strategy against historical market data with configurable risk, volatility, and execution parameters.","exampleAgentPrompt":"Run a backtest on strategy ID 'momentum-v3' trading ETH/USDC on Coinbase from 2023-01-01 to 2023-12-31 using 1-hour intervals, with a 0.1% fee, 0.05% slippage, $10,000 initial balance, max 3 trades per day, and volatility adjustment enabled.","exampleUseCases":[{"title":"Momentum strategy annual performance review","prompt":"Backtest my momentum strategy (strategy ID 'mom-crossover-7') on BTC/USD on Binance for all of 2023, using 4-hour candles, $50,000 starting balance, 0.1% fee, 0.05% slippage, no more than 5 trades per day, and enable volatility adjustment — I want to see how it would have performed."},{"title":"Parameter sensitivity test for crypto algo","prompt":"Run a backtest on strategy JSON '{\"type\":\"mean-reversion\",\"lookback\":20}' for SOL/USDC on Kraken from 2024-01-01 to 2024-06-30, 1-hour intervals, $5,000 initial balance, 2% max risk per trade, 10 cooldown bars between trades, seed 42."},{"title":"Pre-launch risk validation for new trading bot","prompt":"Before I deploy my new trading bot, can you simulate strategy ID 'grid-dca-v2' on ETH/USDC on Coinbase for the last 6 months using daily intervals, $20,000 initial balance, 0.15% fee, 0.1% slippage, max 2 open positions, and tell me the risk metrics?"}],"resultDescription":"Returns backtest simulation results including trade-by-trade history, portfolio equity curve, aggregate performance metrics (total return, Sharpe ratio, max drawdown, win rate), and risk statistics computed over the specified historical period.","failureModes":["Invalid strategy_id or malformed strategy_json returns a 400 error","start_date after end_date causes a validation failure","Unsupported exchange or market data venue returns a 404 or 422","Insufficient historical data for the specified date range and interval","Missing required fields (asset, start_date, end_date) causes a 422 unprocessable entity","Payment failure or insufficient USDC balance returns a 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to simulate a trading strategy against real historical market data with fine-grained control over execution parameters (fees, slippage, risk limits, volatility modes). Prefer this over simpler analytics endpoints when you need comprehensive trade-level output, risk metrics, and support for advanced configuration like cooldown bars, momentum limits, and volatility adjustment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:36:34.064Z","isFirstParty":false,"canonicalSlug":"mangrove-developer-backtests-api-8b65d423"}