Server definition
- Hash
- sha256:616eb40aa65060d3e38dad011b09146e1d85473fc05551b3c1a7f783a3fb010f
- What it is
- What a remote MCP server returned when asked what it offers: 84 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Run the Strategy Engine route in one call. Use it FIRST whenever someone asks to build or make a strategy and names no signals -- 'build me a strategy', 'build me a BTC strategy on 1h', 'make me something for ETH'. Give the asset, and the candle size only when they named one. The server reads the 180-day regime, searches the engine's completed runs once with the agreed floors (more than 10 trades, Sharpe at least 1, IRR at least 10%, beats benchmarks) in that regime, keeps the runs whose entry the regime admits, picks one at random, saves it from its own run and backtests it on recent data ending today, over a window its candle size sets: 5m 1 month, 15m 2 months, 30m 3 months, 1h 4 months, 4h 12 months, 1d 12 months (a month is 30 days). Returns as soon as the backtest is submitted; when running, show the saved strategy and invite the person to check results shortly using get_backtest with the returned backtest_id. Do not submit another backtest. Do not pass filters, a regime or dates: they are fixed. When nothing fits it answers with outcome no_match and saves and spends nothing. A fresh build selects its market automatically; do not ask for a venue or quote. It does not search the marketplace.\n\n[Access: pay 0.10 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"candle_size": {
"description": "Duration of one candle, e.g. 1h or 1d.",
"type": "string"
}
},
"required": [
"asset"
],
"type": "object"
},
"name": "build_strategy_for_regime",
"outputSchema": null
},
{
"description": "Classify one stretch of market: a date range, or a catalog window by file name. Explicit date ranges require daily (1d) candles; catalog windows retain their stored interval. Returns its direction band, volatility band, trend character and the three features behind them, using the same labels the sweep catalog carries. Use it for a period the person names, or to see what a window a sweep selected contains. For an asset's current conditions use get_market_regime instead. Volatility reads `unscored` when no fitted band covers the stretch's length; the bands come back with it. For an exact crypto market, supply quote_token and market_data_venue together. A date range covers crypto and the stocks, ETFs, commodities and bonds in Oracle's regime catalog: SPY, QQQ, DIA, IWM, AAPL, AMD, AMZN, COST, GOOGL, HD, JNJ, JPM, META, MSFT, NFLX, NVDA, PG, TSLA, UNH, WMT, XOM, GLD, SLV, USO, GOLD (gold futures), CRUDE (crude oil futures) and TLT. Without explicit source arguments, those tickers are read from their exchange-session daily series, even where a crypto token shares one (DIA and META are the ETF and the stock here); any other ticker is read as crypto, so a stock not named here cannot be read. Explicit market or provider arguments select the crypto history path. `venue` says which feed was read. A listed ticker needs at least 15 sessions with a close, about three weeks; anything shorter is refused as too little history.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"candle_size": {
"default": "1d",
"description": "Duration of one candle, e.g. 1h or 1d.",
"type": "string"
},
"end_date": {
"description": "ISO end of the window.",
"type": "string"
},
"market_data_venue": {
"description": "Exact venue of the requested market.",
"type": "string"
},
"provider": {
"description": "Optional upstream override; omitted uses the existing server default.",
"type": "string"
},
"quote_token": {
"description": "Quote currency of the requested market.",
"type": "string"
},
"start_date": {
"description": "ISO start of the window, e.g. 2026-01-01.",
"type": "string"
},
"window_file": {
"description": "A catalog window's file name, classified as it stands. Supply this or the asset with both dates, not both.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "classify_market_segment",
"outputSchema": null
},
{
"description": "Create the search, once the person has agreed to its size. The engine builds every candidate strategy itself out of the pool you give it -- the whole signal library unless narrowed by class or by naming signals -- and draws the parameters too. USE size_sweep FIRST and say the run count it reports: this call creates a draft and validates it, and a person who has not heard a total has not agreed to one. Still free; only launch_sweep spends. If valid comes back false, errors says why in Oracle's words, nothing was kept, and the fix is another attempt. Nothing runs until launch_sweep.",
"inputSchema": {
"properties": {
"assets": {
"description": "Asset symbols, e.g. [\"BTC\", \"ETH\"].",
"items": {
"type": "string"
},
"type": "array"
},
"candidate_shape": {
"description": "How many parts a drawn strategy gets, any of n_entry_triggers, min_entry_filters, max_entry_filters, min_exit_triggers, max_exit_triggers, min_exit_filters, max_exit_filters. Omitted, the platform default shape.",
"type": "object"
},
"candle_sizes": {
"description": "Candle sizes, e.g. [\"1h\"]. Omitted, every size Oracle holds for those assets, which multiplies the windows.",
"items": {
"type": "string"
},
"type": "array"
},
"categories": {
"description": "Draw only from these signal classes, e.g. [\"momentum\"]. The classes are averaging, flow, momentum, oscillator, pattern and volatility. Omitted, the whole library.",
"items": {
"type": "string"
},
"type": "array"
},
"draws_per_dataset": {
"default": 100,
"description": "How many candidate strategies to draw PER WINDOW. The runs that execute are this multiplied by the number of windows.",
"type": "integer"
},
"entry_filters": {
"description": "Draw entry filters only from these. Omitted, every filter.",
"items": {
"type": "string"
},
"type": "array"
},
"entry_triggers": {
"description": "Draw the entry trigger only from these signals, named as the knowledge graph registers them. Omitted, every trigger.",
"items": {
"type": "string"
},
"type": "array"
},
"execution_base": {
"description": "Risk settings every run shares, from the execution config schema. Omitted, platform canon.",
"type": "object"
},
"execution_sweeps": {
"description": "Execution parameters to search too, each {param: {min, max, n}}. Every one of these multiplies the run count.",
"type": "object"
},
"exit_filters": {
"description": "Draw exit filters only from these.",
"items": {
"type": "string"
},
"type": "array"
},
"exit_triggers": {
"description": "Draw an exit trigger only from these. Omitted, no exit signal is drawn at all and runs exit on the risk settings.",
"items": {
"type": "string"
},
"type": "array"
},
"include_gapped": {
"default": false,
"description": "Include windows missing bars. Off by default, because a metric over a half-covered window is not comparable to one over a whole window.",
"type": "boolean"
},
"max_total_runs": {
"description": "A ceiling on the executed runs, applied by Oracle.",
"type": "integer"
},
"param_samples": {
"default": 3,
"description": "How many values each signal parameter contributes. The space is their product, so this is the dial that decides whether the search explores parameters at all; at 1 every candidate runs at a single setting.",
"type": "integer"
},
"pre_filter_threshold": {
"description": "Skip a drawn candidate the SIEVE model predicts will not trade at all, above this confidence. A will-it-trade gate and nothing about whether it will make money. Omitted, no skipping.",
"type": "number"
},
"regimes": {
"description": "Market conditions to keep: current, bear, neutral, bull. current means data within the last 30 days, which is recency and not direction. Omitted, every condition.",
"items": {
"type": "string"
},
"type": "array"
},
"signal_groups": {
"description": "Keep kinds of signal apart. A candidate draws ALL of its signals from ONE group, so two signals in different groups never appear on the same strategy. Runs are split across the groups.",
"items": {
"additionalProperties": false,
"properties": {
"categories": {
"description": "Signal classes whose members belong to it.",
"items": {
"type": "string"
},
"type": "array"
},
"exclude": {
"description": "Signal names removed from it.",
"items": {
"type": "string"
},
"type": "array"
},
"filters": {
"additionalProperties": false,
"description": "Select which group members may serve as filters. Role selections only narrow the parent membership; they cannot reassign a signal's role.",
"properties": {
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"exclude": {
"items": {
"type": "string"
},
"type": "array"
},
"include": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"include": {
"description": "Signal names forced in even when their class is not listed.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"description": "What to call the group.",
"type": "string"
},
"triggers": {
"additionalProperties": false,
"description": "Select which group members may serve as triggers.",
"properties": {
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"exclude": {
"items": {
"type": "string"
},
"type": "array"
},
"include": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"weight": {
"description": "Its share of the strategies drawn. Omitted on every group is an even split.",
"type": "number"
}
},
"required": [],
"type": "object"
},
"type": "array"
},
"sweep_name": {
"description": "What to call it.",
"type": "string"
},
"windows": {
"description": "Specific window files to include whatever else is chosen.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sweep_name"
],
"type": "object"
},
"name": "create_sweep",
"outputSchema": null
},
{
"description": "Delete a strategy by its id. Strategies are NEVER hard-deleted: the service soft-archives the row, so the strategy and its history stay recoverable via unarchive. Use only when the person explicitly asks to delete or remove a strategy, and say plainly that it has been archived rather than implying it is gone.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [
"strategy_id"
],
"type": "object"
},
"name": "delete_strategy",
"outputSchema": null
},
{
"description": "Discover Mangrove managed tools without executing them. Free, public read. Use detail=areas for the functional area index; summary (default) returns only names and descriptions; schema returns full live tool definitions. Select any areas and/or tool names; combined selectors form a union.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"areas": {
"description": "Functional area names returned by detail=areas.",
"items": {
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"minItems": 1,
"type": "array"
},
"detail": {
"default": "summary",
"description": "Output detail. The areas index takes no selectors.",
"enum": [
"areas",
"summary",
"schema"
],
"type": "string"
},
"names": {
"description": "One or any number of exact advertised tool names.",
"items": {
"minLength": 1,
"pattern": "\\S",
"type": "string"
},
"minItems": 1,
"type": "array"
}
},
"type": "object"
},
"name": "discover_tools",
"outputSchema": null
},
{
"description": "Evaluate chart data and optional signal triggers over a specific range.\n\n[Access: pay 0.05 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"definitions": {
"EvaluateMultipleSeriesSignal": {
"properties": {
"name": {
"description": "Signal type/name",
"type": "string"
},
"params": {
"default": {},
"description": "Signal parameters; omitted values use registered defaults",
"type": "object"
},
"timeframe": {
"description": "Timeframe for this signal (5m, 15m, 30m, 1h, 4h, 1D)",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"properties": {
"chart_timeframe": {
"default": "1h",
"description": "Live chart timeframe; dataset mode uses its bundled timeframe",
"type": "string"
},
"dataset_key": {
"description": "Bundled dataset key; replaces symbol and date range",
"type": "string"
},
"end_date": {
"description": "Live-mode chart end timestamp; with start_date, or omit both for the latest 500 bars",
"type": "string"
},
"include_chart": {
"default": false,
"description": "Also return chart bars (latest 2,000 at most) and trigger_indices",
"type": "boolean"
},
"market_data_venue": {
"description": "Live-data exchange; supply with quote_token",
"type": "string"
},
"provider": {
"description": "Explicit external history provider",
"type": "string"
},
"quote_token": {
"description": "Live-data quote; supply with market_data_venue",
"type": "string"
},
"signals": {
"default": [],
"description": "Up to 20 registered signals to evaluate",
"items": {
"$ref": "#/definitions/EvaluateMultipleSeriesSignal"
},
"type": "array"
},
"start_date": {
"description": "Live-mode chart start timestamp; with end_date, or omit both for the latest 500 bars",
"type": "string"
},
"symbol": {
"description": "Live-mode asset symbol; required unless dataset_key is provided",
"type": "string"
}
},
"type": "object"
},
"name": "evaluate_multiple_signals_series",
"outputSchema": null
},
{
"description": "Evaluate a signal against provided market data and parameters.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"definitions": {
"MarketDataBar": {
"properties": {},
"type": "object"
}
},
"properties": {
"market_data": {
"items": {
"$ref": "#/definitions/MarketDataBar"
},
"type": "array"
},
"parameters": {
"default": {},
"type": "object"
},
"signal_name": {
"description": "Signal name",
"type": "string"
}
},
"required": [
"market_data",
"signal_name"
],
"type": "object"
},
"name": "evaluate_signal",
"outputSchema": null
},
{
"description": "Evaluate a saved strategy against current live market data to check if entry or exit signals are firing right now. Returns the current asset price and any order intents the signals would produce. It places no orders and opens no positions, but each call records the evaluation: it updates the strategy's last_evaluated_at and evaluation_count and adds an agent_evaluations audit row. Use it when the user asks whether a strategy should be entering or exiting at this moment, or wants the live signal state for a specific strategy. Over x402, a wallet that proves its identity (Sign-In-With-X) gets 30 evaluations free per UTC day, then 0.05 USDC each; an API key is covered by its plan.\n\n[Access: pay 0.05 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [
"strategy_id"
],
"type": "object"
},
"name": "evaluate_strategy",
"outputSchema": null
},
{
"description": "Runs from one sweep, or from every sweep this person has, filtered and sorted by the engine. LEAVE experiment_id OUT to search them all, which is how a person asking whether they have already found something like this gets an answer without spending a new search on a question that already has one. A SWEEP HAS NO WINNER: which run matters depends entirely on what was being asked, so you choose sort_by for the question in front of you -- return, risk-adjusted return, drawdown, trade count -- and say which one you sorted by whenever you report an order. Never call the top row 'the best strategy'; it is the top row by the measure you picked. Filter before you sort: a run with a handful of trades has metrics that mean nothing, so min_trades is usually the first thing to set. Every numeric filter has BOTH bounds, so a band is one question: a delta against the benchmark between 3 and 8 is min and max together, not a page fetched and thinned by hand. Readable while the sweep is still running. At most 50 runs per call (default 20); pass offset to read on.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"atr_period": {
"description": "Only runs that used this ATR period. Needs experiment_id.",
"type": "integer"
},
"beats_benchmarks": {
"default": false,
"description": "Only runs that beat all three benchmarks over the same",
"type": "boolean"
},
"beats_crypto_benchmarks": {
"default": false,
"description": "Only runs that beat the crypto benchmarks rather than only their own asset.",
"type": "boolean"
},
"candle_size": {
"description": "Duration of one candle, e.g. 1h or 1d.",
"type": "string"
},
"cooldown_bars": {
"description": "Only runs that used this cooldown. Needs experiment_id.",
"type": "integer"
},
"covering": {
"description": "Only runs over windows covering this single date, as YYYY-MM-DD. A different question from a span.",
"type": "string"
},
"covering_from": {
"description": "Only runs whose window OVERLAPS this date onwards. A run is relevant to 2024 if any of it happened in 2024.",
"type": "string"
},
"covering_to": {
"description": "Only runs whose window overlaps up to this date.",
"type": "string"
},
"experiment_id": {
"description": "The sweep, as create_sweep returned it.",
"type": "string"
},
"generation": {
"description": "Only runs from this engine generation, so runs made under different engine behaviour are not compared as though alike.",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum results.",
"type": "integer"
},
"market_direction": {
"description": "Only runs from windows of this market character, e.g. bear or mega_bull. Several are one comma-separated string, e.g. \"bull,super_bull\", and a run matching any of them counts. What a run did in one kind of market says little about another.",
"type": "string"
},
"max_delta_vs_asset": {
"description": "Only runs beating their own asset by at most this much.",
"type": "number"
},
"max_delta_vs_benchmark": {
"description": "Only runs beating their benchmark by at most this much, so \"between 3 and 8\" is one question rather than a page fetched and thrown away.",
"type": "number"
},
"max_irr": {
"description": "Only runs at or below this annualised IRR.",
"type": "number"
},
"max_return": {
"description": "Only runs at or below this total return.",
"type": "number"
},
"max_risk_per_trade": {
"description": "Only runs that risked this fraction per trade. Needs experiment_id.",
"type": "number"
},
"max_sharpe": {
"description": "Only runs at or below this Sharpe ratio.",
"type": "number"
},
"max_trades": {
"description": "Only runs at or below this trade count. Pairs with min_trades to ask for a band rather than a floor.",
"type": "integer"
},
"max_win_rate": {
"description": "Only runs at or below this win rate.",
"type": "number"
},
"min_delta_vs_asset": {
"description": "Only runs beating buy-and-hold on their own asset by at least this much.",
"type": "number"
},
"min_delta_vs_benchmark": {
"description": "Only runs that beat their benchmark by at least this much. A return in a rising market is not skill.",
"type": "number"
},
"min_irr": {
"description": "Only runs at or above this annualised IRR.",
"type": "number"
},
"min_return": {
"description": "Only runs at or above this total return.",
"type": "number"
},
"min_sharpe": {
"description": "Only runs at or above this Sharpe ratio.",
"type": "number"
},
"min_trades": {
"default": 0,
"description": "Drop runs with fewer trades than this. Metrics from a handful of trades are noise.",
"type": "integer"
},
"min_win_rate": {
"description": "Only runs at or above this win rate.",
"type": "number"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"order": {
"default": "desc",
"description": "desc for best-first on that metric, asc for worst-first.",
"type": "string"
},
"regime_composite": {
"description": "Only runs from windows with this full regime label, e.g. mega_bull_high_clean, when the three parts together matter; several comma-separated, any of them counts. Across different regime filters every one must hold.",
"type": "string"
},
"regime_direction": {
"description": "The direction band from get_market_regime, e.g. bear. The signal searches filter by it and find_sweep_runs marks each row's regime_fit with it; save_strategy and update_strategy read the current band themselves, so their check runs without it.",
"type": "string"
},
"reward_factor": {
"description": "Only runs that used this reward-to-risk setting. Execution filters need experiment_id; the cross-sweep surface does not serve them.",
"type": "number"
},
"run_index": {
"description": "Which run, as find_sweep_runs reported it.",
"type": "integer"
},
"run_status": {
"description": "Only runs with this outcome, e.g. no_trades for the ones that never opened a position.",
"type": "string"
},
"sort_by": {
"description": "The metric to order by, e.g. sharpe_ratio, sortino_ratio, irr_annualized, total_return, max_drawdown, total_trades. Required, because the choice IS the question being asked.",
"type": "string"
},
"trend": {
"description": "Only runs from windows of this trend character, e.g. clean or choppy; several comma-separated, any of them counts.",
"type": "string"
},
"trigger_name": {
"description": "Only runs whose entry trigger is this signal.",
"type": "string"
},
"volatility": {
"description": "Only runs from windows of this volatility band, e.g. low; several comma-separated, any of them counts.",
"type": "string"
}
},
"required": [
"sort_by"
],
"type": "object"
},
"name": "find_sweep_runs",
"outputSchema": null
},
{
"description": "Full metadata and risk profile for one crypto asset on the Mangrove platform: approval status, risk score breakdown, regulatory status and identifiers. Use it when the user asks about a specific asset's approval or risk detail rather than a live price.\n\n[Access: pay 0.001 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_asset",
"outputSchema": null
},
{
"description": "Fetch a backtest that already ran, by id, with the execution config it used. Use it instead of run_backtest whenever the user refers to a previous result, or to compare two runs -- re-running costs them a unit of their allowance and a stored run is the record of what actually happened.\n\n[Access: pay 0.001 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"backtest_id": {
"description": "The run's UUID, as run_backtest returned it.",
"type": "string"
}
},
"required": [
"backtest_id"
],
"type": "object"
},
"name": "get_backtest",
"outputSchema": null
},
{
"description": "The individual trades a backtest made -- entry and exit prices and times, profit or loss, and why each one closed. Use it when the user asks what a backtest actually traded; get_backtest has the summary metrics. THESE ARE SIMULATED TRADES from a backtest, not real ones -- list_trades has those. A long run is paged: at most 100 trades per call (default 25); pass offset to read on.\n\n[Access: pay 0.001 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"backtest_id": {
"description": "The run's UUID, as run_backtest returned it.",
"type": "string"
},
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
}
},
"required": [
"backtest_id"
],
"type": "object"
},
"name": "get_backtest_trades",
"outputSchema": null
},
{
"description": "Buy-and-hold return for an asset between two dates, as a percentage. Use it whenever you state what a strategy returned: a return with nothing to compare it against does not answer whether the strategy was worth running. run_backtest already includes this for its own window, so call this for a different asset or a different period. A YYYY-MM-DD end date covers that whole UTC day, as run_backtest reads it; an end date of today stops at the end of yesterday, the last complete day; an exact end timestamp is passed through without adding a day.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"base_token": {
"description": "Canonical base token; supply with quote_token and market_data_venue.",
"type": "string"
},
"end_date": {
"description": "ISO end of the window.",
"type": "string"
},
"market_data_venue": {
"description": "Exact venue of the requested market.",
"type": "string"
},
"quote_token": {
"description": "Quote currency of the requested market.",
"type": "string"
},
"start_date": {
"description": "ISO start of the window, e.g. 2026-01-01.",
"type": "string"
}
},
"required": [
"asset",
"end_date",
"start_date"
],
"type": "object"
},
"name": "get_benchmark",
"outputSchema": null
},
{
"description": "Total Value Locked for a whole blockchain such as Ethereum, Base or Solana. Returns USD TVL and the top protocols on that chain. Use it when the user asks about a chain's overall DeFi footprint.\n\n[Access: pay 0.01 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chain": {
"description": "Chain name or slug, e.g. ethereum or base.",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "get_chain_tvl",
"outputSchema": null
},
{
"description": "Crypto spot ETF net flows per day (BTC, ETH, SOL, HYPE) over the last lookback_days (default 30, up to 3650), newest first, with per-asset totals for the whole window. Persistent net inflows are a bullish tape signal; heavy outflows bearish. Pass symbol to narrow it to one asset. Days are paged: limit 1-100 (default 25), offset 0-10000; the totals always cover every day in the window. Use it when the user asks about ETF flows, institutional demand or spot ETF activity.\n\n[Access: pay 0.01 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"lookback_days": {
"default": 30,
"description": "Number of days of history to request.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_etf_flows",
"outputSchema": null
},
{
"description": "Every execution-config parameter a strategy can carry: the platform default, what it does, the effect of raising or lowering it, its legal bounds, and whether it is a strategy-character knob, an account guardrail, gated behind another flag, or retained but unused. Call it before discussing or overriding any risk parameter, so you describe the knob that exists rather than one you remember.\n\n[Access: pay 0.001 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "get_execution_config_schema",
"outputSchema": null
},
{
"description": "Global crypto market snapshot -- total market cap, BTC dominance, total 24h volume and the 24h change. Use it when the user asks about overall market conditions or wants a macro view rather than a per-asset reading.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "get_global_market",
"outputSchema": null
},
{
"description": "Influence score for a single X/Twitter account: a 0-100 score and follower count. Use it when the user asks about a specific influencer or KOL, or wants to know how much weight an account carries in crypto conversation. It is a per-account snapshot, not a topic aggregate.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"username": {
"description": "X/Twitter handle, with or without the leading @.",
"type": "string"
}
},
"required": [
"username"
],
"type": "object"
},
"name": "get_influence_score",
"outputSchema": null
},
{
"description": "Per-pool supply and borrow rates across DeFi lending protocols such as Aave, Compound and Morpho, largest pool (TVL) first. Pass symbol (the pool asset, e.g. USDC), protocol (e.g. aave-v3), chain and/or min_tvl_usd to narrow it. Results are one page: limit 1-100 (default 25), offset 0-10000; pass next_offset to get the next page. Useful for rate-spread screens and stablecoin yield analysis. Use it when the user asks about lending rates, borrow costs or DeFi yield.\n\n[Access: pay 0.01 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chain": {
"description": "Chain name or slug, e.g. ethereum or base.",
"type": "string"
},
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"min_tvl_usd": {
"description": "Leave out pools with less than this total value locked, in USD.",
"type": "number"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"protocol": {
"description": "Protocol or token name, DefiLlama slug or CoinGecko id, case-insensitive exact match.",
"type": "string"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_lending_rates",
"outputSchema": null
},
{
"description": "Latest trade price for a selected market, plus aggregate market cap and 24h volume. Pass quote_token and market_data_venue together to honor a requested exchange. When omitted, selects a supported market and returns its quote and venue. Report the returned venue and quote; disclose price_as_of and price_stale. Use it when the user asks what an asset is doing now, or when a live price is needed to ground a recommendation. It is a spot reading from an external API and is rate limited, so call it once per asset and reuse the answer.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"market_data_venue": {
"description": "Exact venue of the requested market.",
"type": "string"
},
"provider": {
"description": "Optional upstream override; omitted uses the existing server default.",
"type": "string"
},
"quote_token": {
"description": "Quote currency of the requested market.",
"type": "string"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_market_data",
"outputSchema": null
},
{
"description": "Classify an asset's regime using a lookback of 1-365 days of daily closes (default 180, the window strategy builds use): the return and a bull/neutral/bear band over 90, 180 and, for a 365-day lookback, 365 days, plus annualised volatility as a percentage, a bucket, and a z-score against the asset's own baseline; and the whole lookback in the sweep catalog's labels (direction, low/medium/high volatility for its asset class and length, and a clean/mixed/choppy trend). Use it before recommending a strategy style, because a mean-reversion design and a trend-following design suit opposite regimes. Covers crypto and the stocks, ETFs, commodities and bonds in Oracle's regime catalog: SPY, QQQ, DIA, IWM, AAPL, AMD, AMZN, COST, GOOGL, HD, JNJ, JPM, META, MSFT, NFLX, NVDA, PG, TSLA, UNH, WMT, XOM, GLD, SLV, USO, GOLD (gold futures), CRUDE (crude oil futures) and TLT. Without explicit source arguments, those tickers are read from their exchange-session daily series, even where a crypto token shares one (DIA and META are the ETF and the stock here); any other ticker is read as crypto, so a stock not named here cannot be read. Explicit market or provider arguments select the crypto history path. `venue` says which feed was read. A listed ticker needs at least 15 sessions with a close, about three weeks; anything shorter is refused as too little history. For a listed ticker the lookback is calendar days, so 365 reads about 250 sessions. For an exact crypto market, supply quote_token and market_data_venue together.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"lookback_days": {
"default": 180,
"description": "Number of days of history to request.",
"type": "integer"
},
"market_data_venue": {
"description": "Exact venue of the requested market.",
"type": "string"
},
"provider": {
"description": "Optional upstream override; omitted uses the existing server default.",
"type": "string"
},
"quote_token": {
"description": "Quote currency of the requested market.",
"type": "string"
}
},
"required": [
"asset"
],
"type": "object"
},
"name": "get_market_regime",
"outputSchema": null
},
{
"description": "Daily OHLCV (open, high, low, close, volume) history for one crypto asset over the requested lookback (1-3650 days, default 30). More than 1,000 daily bars come back as weekly bars instead (interval says which; daily_bars says how many days were rolled up). Use it when the user asks for price history, chart data, or wants to reason about past price movement rather than the current spot. Supply quote_token and market_data_venue together to select an exact market, or provider for an external source; omit these overrides to select a Mangrove market.\n\n[Access: pay 0.01 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"lookback_days": {
"default": 30,
"description": "Number of days of history to request.",
"type": "integer"
},
"market_data_venue": {
"description": "Exact venue of the requested market.",
"type": "string"
},
"provider": {
"description": "Optional upstream override; omitted uses the existing server default.",
"type": "string"
},
"quote_token": {
"description": "Quote currency of the requested market.",
"type": "string"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_ohlcv",
"outputSchema": null
},
{
"description": "Per-bar on-chain metric time series for a token. One request returns a bar-indexed series with any combination of SmartMoneyNetflow, SmartMoneyHoldings, ExchangeNetflow, WhaleNetInflow and HolderConcentration. Interval is 1h, 4h, 1d or 1w; top_n is how many top holders HolderConcentration sums; the only provider is nansen. Native ETH is read as WETH, and the token must be deployed on the chain asked for. The window defaults to the last 10 days and is at most 366 days; a window that would exceed 1,000 bars is read at the next coarser interval instead (1h, 4h, 1d, 1w), and interval says which was used. Prefer this over firing many point queries when the user wants a historical or trailing-window view.\n\n[Access: pay 0.05 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chain": {
"default": "ethereum",
"description": "Chain name or slug, e.g. ethereum or base.",
"type": "string"
},
"date_from": {
"description": "ISO date string for the start of the window.",
"type": "string"
},
"date_to": {
"description": "ISO date string for the end of the window.",
"type": "string"
},
"interval": {
"default": "1h",
"description": "Candle size, e.g. 15m, 1h, 4h, 1d.",
"type": "string"
},
"metrics": {
"description": "Metric names to include in the series.",
"items": {
"type": "string"
},
"type": "array"
},
"provider": {
"description": "Optional upstream override; omitted uses the existing server default.",
"type": "string"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"top_n": {
"default": 10,
"description": "Return only the first this many.",
"type": "integer"
}
},
"required": [
"metrics",
"symbol"
],
"type": "object"
},
"name": "get_onchain_series",
"outputSchema": null
},
{
"description": "Perpetual funding rates by venue and market (Binance, OKX), largest open interest in USD first. Positive funding means longs are paying to hold; negative means shorts are. Pass symbol (the base asset, e.g. BTC) and/or venue to narrow it. Results are one page: limit 1-100 (default 25), offset 0-10000; pass next_offset to get the next page. Use it when the user asks about perp funding, crowded positioning or leverage bias.\n\n[Access: pay 0.01 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"venue": {
"description": "Exchange the perp trades on, e.g. Binance or OKX, case-insensitive.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_perp_funding_rates",
"outputSchema": null
},
{
"description": "Return one page of OHLCV bars from a playground dataset, newest page first.",
"inputSchema": {
"properties": {
"dataset_key": {
"type": "string"
},
"end_date": {
"description": "ISO end of the window.",
"type": "string"
},
"limit": {
"default": 500,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"start_date": {
"description": "ISO start of the window, e.g. 2026-01-01.",
"type": "string"
}
},
"required": [
"dataset_key"
],
"type": "object"
},
"name": "get_playground_data",
"outputSchema": null
},
{
"description": "Total Value Locked for a single DeFi protocol such as Aave, Uniswap or Curve. Returns USD TVL and a per-chain breakdown. Use it when the user asks how much capital is locked in a specific protocol.\n\n[Access: pay 0.01 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"protocol_name": {
"description": "Protocol slug or display name, e.g. aave or uniswap.",
"type": "string"
}
},
"required": [
"protocol_name"
],
"type": "object"
},
"name": "get_protocol_tvl",
"outputSchema": null
},
{
"description": "Get complete metadata for an exact registered signal name.",
"inputSchema": {
"properties": {
"signal_name": {
"description": "Signal name",
"type": "string"
}
},
"required": [
"signal_name"
],
"type": "object"
},
"name": "get_signal",
"outputSchema": null
},
{
"description": "Recent DEX trades from smart-money wallets across chains. Returns a paginated list of executed trades with token, side, size and wallet metadata. Use it when the user asks what smart money is trading on DEXs, or wants a raw feed of smart-money swap activity.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chains": {
"description": "Optional list of chains to include.",
"items": {
"type": "string"
},
"type": "array"
},
"filters": {
"description": "Optional filter object passed through to the upstream provider.",
"type": "object"
},
"order_by": {
"description": "Optional ordering list passed through to the upstream provider.",
"items": {
"type": "object"
},
"type": "array"
},
"page": {
"default": 1,
"description": "Page number for pagination.",
"type": "integer"
},
"per_page": {
"default": 25,
"description": "Page size for pagination.",
"type": "integer"
}
},
"required": [],
"type": "object"
},
"name": "get_smart_money_dex_trades",
"outputSchema": null
},
{
"description": "One-token flow intelligence snapshot: returns net USD flows and wallet counts for smart traders, whales, exchanges, fresh wallets and public figures together in ONE response. Use for a trailing-window category summary, including the past 24 hours (timeframe=1d). Do not fetch a separate token-flows page for each category to construct this summary. Timeframe is 5m, 1h, 6h, 12h, 1d or 7d. For explicit start/end dates or paginated flow records use get_token_flows. Native ETH is read as WETH; the token must exist on the requested chain.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chain": {
"default": "ethereum",
"description": "Chain name or slug, e.g. ethereum or base.",
"type": "string"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"timeframe": {
"default": "1d",
"description": "Aggregation window, e.g. 24h, 7d.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_smart_money_flows",
"outputSchema": null
},
{
"description": "Historical snapshots of what smart-money wallets held on specific dates. Returns per-wallet-category holdings with USD values. Use it when the user wants to see how smart-money positioning has changed over time, or wants historical on-chain portfolio data for a date range.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chains": {
"description": "Optional list of chains to include.",
"items": {
"type": "string"
},
"type": "array"
},
"date_from": {
"description": "ISO date string for the start of the window.",
"type": "string"
},
"date_to": {
"description": "ISO date string for the end of the window.",
"type": "string"
},
"filters": {
"description": "Optional filter object passed through to the upstream provider.",
"type": "object"
},
"order_by": {
"description": "Optional ordering list passed through to the upstream provider.",
"items": {
"type": "object"
},
"type": "array"
},
"page": {
"default": 1,
"description": "Page number for pagination.",
"type": "integer"
},
"per_page": {
"default": 25,
"description": "Page size for pagination.",
"type": "integer"
}
},
"required": [],
"type": "object"
},
"name": "get_smart_money_historical_holdings",
"outputSchema": null
},
{
"description": "Current smart-money holdings: what funds and smart traders are holding right now, sorted by USD value. Use it when the user asks what smart money currently owns or has positions in.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chains": {
"description": "Optional list of chains to include.",
"items": {
"type": "string"
},
"type": "array"
},
"include_labels": {
"description": "Smart-money wallet labels; omitted uses Fund and Smart Trader.",
"items": {
"type": "string"
},
"type": "array"
},
"limit": {
"default": 15,
"description": "Maximum results.",
"type": "integer"
},
"min_value_usd": {
"default": 1000000,
"description": "Minimum USD value to include.",
"type": "number"
}
},
"required": [],
"type": "object"
},
"name": "get_smart_money_holdings",
"outputSchema": null
},
{
"description": "Aggregated smart-money netflows across all tokens market-wide: which tokens funds and smart traders are accumulating or distributing. Use it when the user asks what smart money is buying or selling, or wants to see market-wide on-chain trends.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chains": {
"description": "Optional list of chains to include.",
"items": {
"type": "string"
},
"type": "array"
},
"include_labels": {
"description": "Smart-money wallet labels; omitted uses Fund and Smart Trader.",
"items": {
"type": "string"
},
"type": "array"
},
"limit": {
"default": 15,
"description": "Maximum results.",
"type": "integer"
},
"timeframe": {
"default": "24h",
"description": "Aggregation window, e.g. 24h, 7d.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_smart_money_netflows",
"outputSchema": null
},
{
"description": "Perpetual futures trades from smart-money wallets on Hyperliquid. Shows leveraged directional bets by sophisticated traders. Use it when the user asks about smart-money perp positions, what high-conviction traders are doing with leverage, or wants to see Hyperliquid smart-money activity.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"filters": {
"description": "Optional filter object passed through to the upstream provider.",
"type": "object"
},
"order_by": {
"description": "Optional ordering list passed through to the upstream provider.",
"items": {
"type": "object"
},
"type": "array"
},
"page": {
"default": 1,
"description": "Page number for pagination.",
"type": "integer"
},
"per_page": {
"default": 25,
"description": "Page size for pagination.",
"type": "integer"
}
},
"required": [],
"type": "object"
},
"name": "get_smart_money_perp_trades",
"outputSchema": null
},
{
"description": "On-chain sentiment read for a token derived from smart-money wallet net flows. Returns a sentiment label (bullish, bearish or neutral) and net USD flow direction. Use it when the user asks what smart-money sentiment is for an asset, or wants a quick bullish or bearish read from on-chain flow data. For X or Twitter social sentiment use get_social_sentiment instead.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chain": {
"default": "ethereum",
"description": "Chain name or slug, e.g. ethereum or base.",
"type": "string"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_smart_money_sentiment",
"outputSchema": null
},
{
"description": "Recent X/Twitter posts about a crypto asset or topic: post text, id and time, at most 10 posts, plus how many posts the search matched. Use it when the user wants to see what is actually being said, or wants raw posts rather than an aggregated sentiment score.\n\n[Access: pay 1.00 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"hours_back": {
"default": 24,
"description": "Lookback window in hours.",
"type": "integer"
},
"limit": {
"default": 20,
"description": "Maximum results.",
"type": "integer"
},
"topic": {
"description": "Asset symbol, project name or free-form topic.",
"type": "string"
}
},
"required": [
"topic"
],
"type": "object"
},
"name": "get_social_mentions",
"outputSchema": null
},
{
"description": "Keyword-polarity sentiment for a crypto cashtag on X/Twitter. It fetches recent posts for $TOPIC and counts how many contain a positive and how many a negative keyword; the 0-100 score is the positive share of those polar posts. Returns the score, a bullish (70 or more), neutral or bearish (30 or less) label, and the number of posts read. When no post carried a sentiment keyword the score is null and the label is insufficient_signal: report that, not a neutral reading. Always state how many posts the reading was built from. Use it when the user asks about market mood or social sentiment for a token. The call is metered, so ask once per topic and reuse.\n\n[Access: pay 1.00 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"hours_back": {
"default": 24,
"description": "Lookback window in hours.",
"type": "integer"
},
"topic": {
"description": "Asset symbol, project name or free-form topic.",
"type": "string"
}
},
"required": [
"topic"
],
"type": "object"
},
"name": "get_social_sentiment",
"outputSchema": null
},
{
"description": "Global stablecoin metrics -- total supply, per-chain breakdown and the top stablecoins by market cap. Use it when the user asks about stablecoin supply, USDC or USDT dominance, or overall market liquidity.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "get_stablecoin_metrics",
"outputSchema": null
},
{
"description": "Read a strategy definition saved in MangroveAI, including its entry and exit signals and execution settings. Use an ID returned by list_strategies; IDs from other stores are not interchangeable.",
"inputSchema": {
"properties": {
"name": {
"description": "Its name, if the id is unknown.",
"type": "string"
},
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_strategy",
"outputSchema": null
},
{
"description": "Where one sweep has got to: its status and how many of its runs have finished. This is how you answer 'is it done yet' -- read it when the person asks, not on a loop, because the engine works for minutes or hours and a second look a moment later says the same thing. Results can be read while it is still running; the rows that exist are real.",
"inputSchema": {
"properties": {
"experiment_id": {
"description": "The sweep, as create_sweep returned it.",
"type": "string"
}
},
"required": [
"experiment_id"
],
"type": "object"
},
"name": "get_sweep",
"outputSchema": null
},
{
"description": "The sweep limits this person's plan actually enforces: the most backtests one sweep may run, the most history it may read, and how many sweeps may be in flight at once. Read these rather than guessing, and say the size in plan terms when a search is over one. Zero means no limit is enforced for this caller and -1 means unlimited; neither is a number to report as a cap.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "get_sweep_limits",
"outputSchema": null
},
{
"description": "One run rebuilt as the strategy it was, entry and exit rules with the parameter values the engine drew. This is the way OUT of a sweep: a row worth acting on becomes a saved strategy and then a real backtest over a window the person chose. Reach for it once a row is interesting, not for every row in a ranking.",
"inputSchema": {
"properties": {
"config_hash": {
"description": "The row's config_hash, as find_sweep_runs reported it. Pass it whenever you have it: a relaunched sweep can give one run_index to several runs, and without it such an index is refused, not guessed.",
"type": "string"
},
"experiment_id": {
"description": "The sweep, as create_sweep returned it.",
"type": "string"
},
"run_index": {
"description": "Which run, as find_sweep_runs reported it.",
"type": "integer"
}
},
"required": [
"experiment_id",
"run_index"
],
"type": "object"
},
"name": "get_sweep_run",
"outputSchema": null
},
{
"description": "The exchanges that list one specific token, with per-venue metadata. Use it when the user asks where a token trades or which venues carry it, rather than for a price on any one of them.\n\n[Access: pay 0.001 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_symbol_exchanges",
"outputSchema": null
},
{
"description": "DEX trades for a specific token across all participants in a date window. Returns raw swap events with wallet, size and pool metadata; useful for post-hoc flow analysis on a single token. Native ETH is read as WETH, and the token must be deployed on the chain asked for.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chain": {
"default": "ethereum",
"description": "Chain name or slug, e.g. ethereum or base.",
"type": "string"
},
"date_from": {
"description": "ISO date string for the start of the window.",
"type": "string"
},
"date_to": {
"description": "ISO date string for the end of the window.",
"type": "string"
},
"filters": {
"description": "Optional filter object passed through to the upstream provider.",
"type": "object"
},
"order_by": {
"description": "Optional ordering list passed through to the upstream provider.",
"items": {
"type": "object"
},
"type": "array"
},
"page": {
"default": 1,
"description": "Page number for pagination.",
"type": "integer"
},
"per_page": {
"default": 25,
"description": "Page size for pagination.",
"type": "integer"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_token_dex_trades",
"outputSchema": null
},
{
"description": "Paginated historical flow records for one non-stablecoin token between explicit start and end dates, optionally filtered by one wallet label. Use for date-range records or pagination. For a trailing-window summary of net USD flows AND wallet counts across categories, use get_smart_money_flows, which returns the categories together in one call. Not available for stablecoins. Native ETH is read as WETH; the token must exist on the requested chain.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chain": {
"default": "ethereum",
"description": "Chain name or slug, e.g. ethereum or base.",
"type": "string"
},
"date_from": {
"description": "ISO date string for the start of the window.",
"type": "string"
},
"date_to": {
"description": "ISO date string for the end of the window.",
"type": "string"
},
"filters": {
"description": "Optional filter object passed through to the upstream provider.",
"type": "object"
},
"label": {
"description": "Wallet category: smart_money, exchange, whale, public_figure, or top_100_holders.",
"type": "string"
},
"order_by": {
"description": "Optional ordering list passed through to the upstream provider.",
"items": {
"type": "object"
},
"type": "array"
},
"page": {
"default": 1,
"description": "Page number for pagination.",
"type": "integer"
},
"per_page": {
"default": 25,
"description": "Page size for pagination.",
"type": "integer"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_token_flows",
"outputSchema": null
},
{
"description": "On-chain token holder distribution for a token: total on-chain holder count, top-10 concentration percentage and a concentration score. Nansen aggregates across chains, so pass the symbol only and do not pass a chain argument. Use it when the user asks how many wallets hold a token, about holder count, holder concentration, whale ownership or distribution risk.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_token_holders",
"outputSchema": null
},
{
"description": "Upcoming token unlocks and supply metrics -- which tokens release supply in the next days_ahead days, when, and how much (cliff amounts and USD value). Heavy near-term unlocks are a supply-shock signal. Pass symbol (the token ticker, case-insensitive) or protocol (also for tokens without a ticker) to ask about specific tokens; a matched token is returned even when its next unlock is outside the window. Results are one page of tokens: limit 1-100 (default 25), offset 0-10000; pass next_offset from a response to get the next page. Use it when the user asks about unlocks, vesting or supply overhang.\n\n[Access: pay 0.01 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"days_ahead": {
"default": 30,
"description": "Window length in days from now. Without symbol or protocol, only tokens with a scheduled unlock in this window are returned.",
"maximum": 365,
"minimum": 1,
"type": "integer"
},
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"protocol": {
"description": "Protocol or token name, DefiLlama slug or CoinGecko id, case-insensitive exact match.",
"type": "string"
},
"rank_by": {
"default": "next_unlock",
"description": "next_unlock (soonest first) or cliff_value_usd (largest USD value of cliff unlocks in the window first).",
"enum": [
"next_unlock",
"cliff_value_usd"
],
"type": "string"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_token_unlocks",
"outputSchema": null
},
{
"description": "Read closed trades from MangroveAI for one strategy belonging to the authenticated user and organization. Uses the same MangroveAI record as list_trades; these are execution records, not backtest fills.",
"inputSchema": {
"properties": {
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [
"strategy_id"
],
"type": "object"
},
"name": "get_trades_for_strategy",
"outputSchema": null
},
{
"description": "DeFi protocol treasury holdings -- how much a protocol holds in its own treasury, split into its own token, stablecoins, majors and others, largest treasury first. Pass protocol (name, slug or CoinGecko id; the '(treasury)' suffix is optional) or symbol to look one up. Results are one page: limit 1-100 (default 25), offset 0-10000; pass next_offset to get the next page. Use it when the user asks about protocol treasuries, DAO holdings or protocol-owned liquidity.\n\n[Access: pay 0.01 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"protocol": {
"description": "Protocol or token name, DefiLlama slug or CoinGecko id, case-insensitive exact match.",
"type": "string"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_treasuries",
"outputSchema": null
},
{
"description": "The crypto assets trending right now by 24h search volume. Use it when the user asks what is popular, what the market is paying attention to, or wants a discovery view rather than a specific asset lookup.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "get_trending",
"outputSchema": null
},
{
"description": "How many X posts mentioned a crypto asset's cashtag, per hour or per day, over the last 1 to 31 days. This is the XPostCount series the x_attention signals (x_post_count_spike, x_attention_elevated, x_attention_price_divergence) read. Counts exclude reposts and promoted posts; x_query=en_original also drops replies and keeps English only. The series ends at the last settled bucket (closed at least five minutes ago). Use it to show a token's attention trend, to explain why an X signal fired, or to pick a z_threshold. Counts are post volume, not sentiment. Repeat reads are served from cache.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"days_back": {
"default": 7,
"description": "Window in days ending now, 1 to 31.",
"type": "integer"
},
"granularity": {
"default": "hour",
"description": "hour or day.",
"type": "string"
},
"symbol": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"x_query": {
"default": "all",
"description": "all (default) or en_original (no replies, English only).",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_x_post_counts",
"outputSchema": null
},
{
"description": "Read a requested KB guide or a known source section by slug. Use directly when the user requests the document itself; no preliminary graph call is required. For a general explanation use query_knowledge op=ask, not a document-reading sequence. If a needed slug is unknown, locate it with kb_search or kb_list_documents. Use view=overview for a guide summary; view=section with a returned section_anchor for a specific passage. Content defaults to 6000 characters; offset and next_offset count characters within the selected body. Continue only when the requested material is missing, not merely because has_more is true. full=True is for explicit full-document requests. A document excerpt is educational material; executable signal identities and parameters come from the runtime registry.",
"inputSchema": {
"properties": {
"full": {
"default": false,
"description": "Explicit full content download; cannot combine with offset or max_chars.",
"type": "boolean"
},
"max_chars": {
"description": "Page size, default 6000, capped at 12000 and the response budget.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"section_anchor": {
"description": "Exact anchor from overview or search, required only for section view.",
"type": "string"
},
"slug": {
"description": "The document slug.",
"type": "string"
},
"view": {
"default": "content",
"description": "Use overview for a brief summary and headings; section for a specific topic; content for document pages.",
"enum": [
"overview",
"section",
"content"
],
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "kb_get_document",
"outputSchema": null
},
{
"description": "Read the Signals Quick Reference guide when the user asks for that guide or its documented entries. This is the document-reading shortcut for kb_get_document slug=10-signals-quick-reference, not an additional validation step. Use view=overview for its outline or view=section with a known anchor for a passage. Content defaults to 6000 characters; offset and next_offset count characters within the selected body. Continue only for requested missing text. Reserve full=True for explicit downloads. For conceptual signal combinations use query_knowledge op=ask. For executable signal names and parameters needed to construct a strategy use the runtime catalogue, not this educational guide.",
"inputSchema": {
"properties": {
"full": {
"default": false,
"description": "Explicit full content download; cannot combine with offset or max_chars.",
"type": "boolean"
},
"max_chars": {
"description": "Page size, default 6000, capped at 12000 and the response budget.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"section_anchor": {
"description": "Exact anchor from overview or search, required only for section view.",
"type": "string"
},
"view": {
"default": "content",
"description": "Use overview for a brief summary and headings; section for a specific topic; content for document pages.",
"enum": [
"overview",
"section",
"content"
],
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "kb_get_signal_quick_reference",
"outputSchema": null
},
{
"description": "Return the KB glossary entry for an explicitly requested glossary definition or exact glossary term. No preliminary graph call is required for a glossary request. For a general question such as what RSI means, why it behaves that way, or which indicators complement it, start with query_knowledge op=ask. Exact lookup is case-insensitive and may return partial matches. Answer from the returned definition when sufficient; do not routinely follow it with graph or document searches.",
"inputSchema": {
"properties": {
"term": {
"description": "The term to look up, case-insensitive.",
"type": "string"
}
},
"required": [
"term"
],
"type": "object"
},
"name": "kb_glossary_get",
"outputSchema": null
},
{
"description": "Reads the Mangrove Knowledge Base package: every document's slug, title and summary. For a keyword search instead of browsing use kb_search. Use this when the user wants to browse the KB or you need a slug before calling kb_get_document.",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "kb_list_documents",
"outputSchema": null
},
{
"description": "Locate KB articles or source sections using short topic keywords. Use when the user asks to find written material, or an explanation is missing a specific fact that requires a source passage. For general definitions, explanations, comparisons and combination/caution questions, start with query_knowledge op=ask instead. This returns snippets and section anchors, not full articles. All query terms must match; do not send a full question or split it into speculative keyword searches. A tag restricts the category and disables synonym expansion. If the snippets or attached graph evidence answer the request, answer directly. Read one returned section with kb_get_document only if a required fact is still missing. Do not automatically search again or read every result.",
"inputSchema": {
"properties": {
"expand": {
"default": true,
"description": "Whether to expand synonyms; ignored when tags are set.",
"type": "boolean"
},
"limit": {
"description": "Maximum results.",
"type": "integer"
},
"q": {
"description": "The search text, in ordinary words.",
"type": "string"
},
"tag": {
"description": "Restrict to one tag category; disables synonym expansion.",
"type": "string"
},
"tags": {
"description": "Restrict to any of these tag categories; cannot combine with tag.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"q"
],
"type": "object"
},
"name": "kb_search",
"outputSchema": null
},
{
"description": "Start a validated sweep. THIS IS THE ONE CALL THAT SPENDS: it puts the engine to work on every run the search describes, for minutes or hours, and there is no undoing it -- pause_sweep stops further work but does not give back what already ran. So say the run count out loud and get the person's agreement before calling it; a number they never saw is not one they agreed to. It returns immediately with the sweep queued or preparing, NOT with results: the runs land over time and get_sweep says how far along it is. A status of queued means it starts when the account's current sweep finishes, which is the sweep beginning and not a refusal.\n\n[Access: pay 0.25 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"experiment_id": {
"description": "The sweep, as create_sweep returned it.",
"type": "string"
}
},
"required": [
"experiment_id"
],
"type": "object"
},
"name": "launch_sweep",
"outputSchema": null
},
{
"description": "List assets supported by platform ref-data, enriched with market data and risk scores. Approval is independent of risk assessment. Unassessed risk scores are null; do not interpret them as zero or infer regulatory approval. Returns available market metadata and risk scores.\n\n[Access: pay 0.001 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"top_n": {
"description": "Return only the first this many.",
"type": "integer"
}
},
"required": [],
"type": "object"
},
"name": "list_approved_assets",
"outputSchema": null
},
{
"description": "List available execution venue and quote-token choices for a backtest. Use when the user asks for alternatives. Missing market details are selected automatically in backend ranking order, retaining supplied dimensions. Do not ask for a market choice unless the user requests one. Availability here does not guarantee historical coverage; submission checks the chosen window.",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
}
},
"required": [
"asset"
],
"type": "object"
},
"name": "list_backtest_markets",
"outputSchema": null
},
{
"description": "The user's recent backtest runs, newest first, optionally just the ones for one strategy. Use it when they ask what they have run, or refer to an earlier result without giving an id -- then fetch the one you need with get_backtest. It is how you avoid re-running something that already has an answer. Results are newest first; pass strategy_id to see only one strategy's runs.\n\n[Access: pay 0.001 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"limit": {
"default": 10,
"description": "Maximum results.",
"type": "integer"
},
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "list_backtests",
"outputSchema": null
},
{
"description": "Read the MangroveAI agent evaluation decision log for a strategy belonging to the authenticated user and organization. No audit record means unknown activity, not proof it never evaluated. This does not read platform evaluation records.",
"inputSchema": {
"properties": {
"include_details": {
"default": false,
"description": "Also return each evaluation's market_snapshot, sdk_response and order_intents.",
"type": "boolean"
},
"limit": {
"default": 20,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [
"strategy_id"
],
"type": "object"
},
"name": "list_evaluations",
"outputSchema": null
},
{
"description": "Every exchange the Mangrove platform tracks, with per-exchange tier and 24h volume. Use it when the user asks what exchanges are supported or wants to browse the exchange universe rather than a single venue.\n\n[Access: pay 0.001 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "list_exchanges",
"outputSchema": null
},
{
"description": "Return metadata for all available playground CSV datasets.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_playground_datasets",
"outputSchema": null
},
{
"description": "Read positions recorded in MangroveAI for the authenticated user and organization. This does not read platform trading positions.",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"open_only": {
"default": true,
"description": "Leave out positions that have already been closed.",
"type": "boolean"
},
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "list_positions",
"outputSchema": null
},
{
"description": "The values a sweep's runs actually carry: which assets, which candle sizes, and which entry triggers the engine drew. Read this before filtering by one of them, because a value nothing carries comes back as an empty page that reads exactly like a search with nothing good in it.",
"inputSchema": {
"properties": {
"experiment_id": {
"description": "The sweep, as create_sweep returned it.",
"type": "string"
}
},
"required": [
"experiment_id"
],
"type": "object"
},
"name": "list_run_filters",
"outputSchema": null
},
{
"description": "Every signal's friendly name, display name and short description, keyed by code name.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_signal_labels",
"outputSchema": null
},
{
"description": "List available trading signals: names, types (TRIGGER or FILTER) and short descriptions. Use it to browse the catalogue, or narrow it by regime band, role or library category.",
"inputSchema": {
"properties": {
"category": {
"description": "Filter by category (momentum, trend, volume, volatility, patterns, onchain, social)",
"type": "string"
},
"limit": {
"default": 30,
"description": "Page size: default 30, maximum 30. Larger requests are capped; use next_offset to continue.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset",
"type": "integer"
},
"regime_direction": {
"description": "Filter to signals admissible for a regime band (mega_bull, super_bull, bull, neutral, bear, super_bear, mega_bear)",
"type": "string"
},
"role": {
"description": "Filter by the part a signal plays in a strategy (TRIGGER or FILTER)",
"type": "string"
}
},
"type": "object"
},
"name": "list_signals",
"outputSchema": null
},
{
"description": "List strategy definitions saved in MangroveAI for the authenticated user and organization. Use get_strategy with a returned strategy_id for entry/exit rules. This reads server definitions, not local agent execution records. An empty result means no matching saved definitions.",
"inputSchema": {
"properties": {
"limit": {
"default": 20,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
}
},
"required": [],
"type": "object"
},
"name": "list_strategies",
"outputSchema": null
},
{
"description": "What history a sweep could run over, as the choices to offer and how many windows each one would add. Oracle keeps MANY separate windows per asset -- different date spans of the same market, each labelled with the character of the market inside it -- and a sweep runs over every one that matches, which is what stops a result that only held in one period from looking general. CALL THIS BEFORE ANYTHING ELSE, and again after each answer: the counts are conditioned on what has been chosen already, so they say what picking an option would ADD. Offer only what comes back. An option the catalog cannot cover is not returned at all, and an asset Oracle holds no data for cannot be swept however well known it is. Windows with missing bars are left out unless asked for.",
"inputSchema": {
"properties": {
"assets": {
"description": "Asset symbols, e.g. [\"BTC\", \"ETH\"].",
"items": {
"type": "string"
},
"type": "array"
},
"candle_sizes": {
"description": "Candle sizes, e.g. [\"1h\"]. Omitted, every size Oracle holds for those assets, which multiplies the windows.",
"items": {
"type": "string"
},
"type": "array"
},
"include_gapped": {
"default": false,
"description": "Include windows missing bars. Off by default, because a metric over a half-covered window is not comparable to one over a whole window.",
"type": "boolean"
},
"regimes": {
"description": "Market conditions to keep: current, bear, neutral, bull. current means data within the last 30 days, which is recency and not direction. Omitted, every condition.",
"items": {
"type": "string"
},
"type": "array"
},
"windows": {
"description": "Specific window files to include whatever else is chosen.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"name": "list_sweep_markets",
"outputSchema": null
},
{
"description": "The sweeps this account can see, newest first. Call it whenever the person refers to a search rather than asking for a new one -- 'how did that one go', 'what have I run' -- so you read an existing sweep instead of paying to repeat it. Live progress is not in this list; get_sweep has it for the one that matters. Returns at most 100 sweeps per call (default 20).",
"inputSchema": {
"properties": {
"limit": {
"default": 20,
"description": "Maximum results.",
"type": "integer"
}
},
"required": [],
"type": "object"
},
"name": "list_sweeps",
"outputSchema": null
},
{
"description": "Read trade history recorded in MangroveAI for the authenticated user and organization. This does not read platform trades.",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset in the result units documented by the tool; zero starts the first page.",
"type": "integer"
},
"outcome": {
"description": "Only \"win\" or only \"loss\".",
"type": "string"
},
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "list_trades",
"outputSchema": null
},
{
"description": "Load one of your skills: the full instructions for doing something, which the turn only announced by name. Do it BEFORE working in a skill's area rather than after -- the announcement says what a skill is for, and the skill itself says how, including which calls to make and what not to do. Pass a section name to load only part of it. A skill may also carry FILES it tells you to read -- a lookup table, a mapping -- and `resources` names them; pass one as `resource` to be given it. Asking for a skill, a section or a resource that does not exist returns the ones that do.",
"inputSchema": {
"properties": {
"resource": {
"description": "One file the skill carries, by name, as `resources` lists them.",
"type": "string"
},
"section": {
"description": "One section of it, by heading. Omit for the whole skill.",
"type": "string"
},
"skill": {
"description": "Which skill, by the name the turn announced.",
"type": "string"
}
},
"required": [
"skill"
],
"type": "object"
},
"name": "load_skill",
"outputSchema": null
},
{
"description": "Match a trading description to ranked signals.\n\n[Access: pay 0.01 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"description": {
"description": "Natural language description of the desired signal/rule",
"type": "string"
},
"regime_direction": {
"description": "Market regime band",
"type": "string"
},
"role": {
"description": "Signal role",
"enum": [
"TRIGGER",
"FILTER"
],
"example": "TRIGGER",
"type": "string"
},
"similarity_threshold": {
"default": 0.3,
"description": "Minimum similarity score to include",
"type": "number"
},
"top_k": {
"default": 5,
"description": "Number of matches to return",
"type": "integer"
},
"user_intent": {
"description": "Optional intent dict (e.g., from intent extractor)",
"type": "object"
}
},
"required": [
"description"
],
"type": "object"
},
"name": "match_signals",
"outputSchema": null
},
{
"description": "Stop a running sweep from doing any more work, keeping every result it has already written. Use it when the person has seen enough, or when a search turned out far larger than they wanted. It does not undo what already ran, and the results stay readable afterwards -- so it is a way to stop spending, not a way to take it back. Say how many runs finished, which is what they keep. A sweep that was only QUEUED had not started, so stopping it returns it to validated rather than paused and it can be launched again later.",
"inputSchema": {
"properties": {
"experiment_id": {
"description": "The sweep, as create_sweep returned it.",
"type": "string"
}
},
"required": [
"experiment_id"
],
"type": "object"
},
"name": "pause_sweep",
"outputSchema": null
},
{
"description": "Explain trading concepts, definitions, relationships, comparisons and when signals work or fail using Michael's knowledge graph. This is the first tool for a general knowledge question, including which indicators complement RSI and when to avoid combining them. Start with op=ask, the complete question in q, hops=1 and limit=5. Keep related clauses together; do not run a search for each clause. Read the summaries and edge reasons before deciding on another call. Answer once the requested explanation and cautions are supported. A follow-up must address a specific missing fact: get an already-returned node for its details, or read one relevant KB section. Do not gather extra context, enumerate neighbors, check the signal catalogue or measure signals merely to expand a conceptual answer. If evidence remains insufficient, say what is unknown instead of repeatedly rephrasing searches. This guidance does not replace validation required for an actual strategy or a requested graph exploration. Explicit glossary, document and browsing requests go directly to the corresponding KB tool without a preliminary graph call. Runtime signal selection belongs to the signal catalogue; measured firing rates and durations belong to query_signal_behavior; current market regime belongs to get_market_regime. These are separate user intents, not mandatory steps for an explanation. Mangrove product policy belongs to query_product_facts. Reuse evidence and node IDs already returned in this conversation. Ops: stats (the counts and the complete vocabulary every filter accepts -- call it when you do not already know the filter values), find (search BY WORDS, optionally by kind/role/status/requires/param -- param finds every signal taking a parameter of that name), ask (search BY MEANING -- give it the question in ordinary words; use this when you would otherwise answer from memory, e.g. 'how far should the stop go', 'what works in a sideways market'; hops is capped at 3), get (one node in full: formula, inputs, params, outputs, warmup), neighbors (one hop: what reads this, or what this depends on; filter by relation, relation_category, primitive or why), walk (the whole neighbourhood out to a radius, as nodes plus edges -- for 'everything around X' rather than one hop at a time), outputs (search the VALUES: which are bounded, which are in given units, what produces an output called X), path (the one shortest route between two nodes), paths (every simple route between two nodes -- use when the shortest route is not the explanatory one), ancestors (the classes a node belongs to, transitively), descendants (everything under a class, transitively), under (everything contained in a node by subject, whatever primitive it is -- e.g. a whole knowledge-base chapter). NEVER GUESS a node id or name for get/neighbors/outputs/path/walk/paths/ancestors/descendants/under: call find (or ask) only if you do not already have an ID from a tool result -- ids look like 'procedure:signal-rsi-bullish-divergence', not 'rsi_divergence'. A get that misses returns candidates; fetch one only if it is relevant to a fact still needed for the answer. Signal rows carry signal_type from the catalog: TRIGGER is an occurrence, FILTER is a condition that can remain true across bars. A boolean output does not make a signal a TRIGGER; read its signal_type rather than infer its role from its name or output. Class and role are different questions: kind='momentum' is what a computation measures, role='trigger' is the part it plays.",
"inputSchema": {
"properties": {
"bounded": {
"description": "outputs: only values with a fixed range.",
"type": "boolean"
},
"direction": {
"default": "both",
"description": "neighbors: in = what reads this, out = what this depends on.",
"enum": [
"in",
"out",
"both"
],
"type": "string"
},
"hops": {
"default": 1,
"description": "ask: how far to walk from each match. 0 restricts it to retrieval. Capped at 3; a higher value raises ValueError naming the cap.",
"type": "integer"
},
"kind": {
"description": "The class: what a computation measures.",
"type": "string"
},
"limit": {
"default": 25,
"description": "Maximum results.",
"type": "integer"
},
"max_depth": {
"description": "path, paths: how long a route may be. path defaults to 6; paths defaults to 4 and is capped at 4 -- past that almost every extra route is a detour through a hub rather than an explanation.",
"type": "integer"
},
"max_nodes": {
"default": 50,
"description": "walk: stop expanding once this many nodes are collected.",
"type": "integer"
},
"op": {
"description": "Which question you are asking.",
"enum": [
"stats",
"find",
"ask",
"get",
"neighbors",
"outputs",
"path",
"walk",
"paths",
"ancestors",
"descendants",
"under"
],
"type": "string"
},
"param": {
"description": "find: a parameter name -- every signal that takes it.",
"type": "string"
},
"primitive": {
"description": "neighbors: keep only neighbours of this node primitive, e.g. Procedure or Concept.",
"type": "string"
},
"q": {
"description": "The search text, in ordinary words.",
"type": "string"
},
"radius": {
"default": 1,
"description": "walk: how many hops out the neighbourhood reaches. Capped at 3; for anything wider call neighbors or path instead of a bigger radius.",
"type": "integer"
},
"relation": {
"description": "neighbors: follow only this one relation.",
"type": "string"
},
"relation_category": {
"description": "neighbors: follow only edges of this whole relation category (structural, descriptive, associative, meta) -- see stats for the list.",
"type": "string"
},
"relations": {
"description": "path, paths, ask: follow only these relations.",
"items": {
"type": "string"
},
"type": "array"
},
"requires": {
"description": "An input column it needs.",
"type": "string"
},
"role": {
"description": "The part a signal plays in a strategy.",
"type": "string"
},
"seeds": {
"default": 3,
"description": "ask: how many top matches to expand from before re-ranking.",
"type": "integer"
},
"sibling_hops": {
"default": false,
"description": "paths: include routes that pass through a shared parent (both nodes are, say, Signal) rather than a direct connection. Off by default -- those routes are usually not the explanation.",
"type": "boolean"
},
"status": {
"description": "Whether the thing is current or withdrawn.",
"type": "string"
},
"to": {
"description": "path, paths: the destination node.",
"type": "string"
},
"units": {
"description": "The unit an output is measured in.",
"type": "string"
},
"why": {
"description": "neighbors, walk, ask: keep only edges whose own stated reason matches these words -- the same relation can carry different claims.",
"type": "string"
}
},
"required": [
"op"
],
"type": "object"
},
"name": "query_knowledge",
"outputSchema": null
},
{
"description": "Query measured signal behaviour: describe, pick, find or gap_probability.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"category": {
"description": "find: restrict to one family, e.g. oscillator, volatility, momentum",
"type": "string"
},
"limit": {
"default": 10,
"description": "Maximum results, 1-100",
"type": "integer"
},
"lookup": {
"description": "describe: one signal -- parameter meanings, measured span, what its default measures. pick: settings of one signal that hit target_rate. find: which signals reach a rate band. gap_probability: share of a signal's gaps inside a range of bar lengths, per configuration.",
"enum": [
"describe",
"pick",
"find",
"gap_probability"
],
"example": "describe",
"type": "string"
},
"max_gap_bars": {
"description": "pick/find, TRIGGER only: median gap at most this many bars",
"type": "number"
},
"max_gap_range_bars": {
"description": "gap_probability: high end of the gap range, inclusive (required)",
"type": "number"
},
"max_rate": {
"description": "find: high end of the band, same units (required)",
"type": "number"
},
"max_run_bars": {
"description": "pick/find, FILTER only: mean run at most this many bars",
"type": "number"
},
"min_gap_bars": {
"description": "pick/find, TRIGGER only: median gap at least this many bars",
"type": "number"
},
"min_gap_range_bars": {
"description": "gap_probability: low end of the gap range, inclusive (required)",
"type": "number"
},
"min_rate": {
"description": "find: low end of the band, same units (required)",
"type": "number"
},
"min_run_bars": {
"description": "pick/find, FILTER only: mean run at least this many bars",
"type": "number"
},
"signal": {
"description": "Signal name, e.g. rsi_oversold. Required by describe, pick, gap_probability",
"type": "string"
},
"signal_type": {
"default": "FILTER",
"description": "FILTER (an ongoing state) or TRIGGER (a one-bar event); measured separately",
"enum": [
"FILTER",
"TRIGGER"
],
"example": "FILTER",
"type": "string"
},
"target_rate": {
"description": "pick: rate to aim for -- FILTER selectivity 0-1, TRIGGER firings per 1,000 bars. Omit to list the span",
"type": "number"
}
},
"required": [
"lookup"
],
"type": "object"
},
"name": "query_signal_behavior",
"outputSchema": null
},
{
"description": "Start a backtest of one saved strategy over a window of history. Takes a strategy_id -- it reads the stored strategy's own rules, asset, timeframe and risk parameters. The recorded market is the default; pass quote_token and/or market_data_venue when the person chooses another quote or execution venue. An omitted choice keeps its recorded value. Check and report the selected market; never silently substitute a feed. IT RETURNS A SUBMISSION, NOT A RESULT: a real backtest takes minutes, so this hands back the run's id and the config it will use, and the metrics arrive on their own once the engine finishes. Tell the person it is running; do not call this again for the same question, and do not wait. It consumes a unit of the user's monthly backtest allowance at submission -- so it CHECKS THE STRATEGY FIRST, and a refusal costs nothing: a problem (verify_strategy's problems) always refuses, and a signal parameter still at its library default refuses until you either save chosen values or pass acknowledge_defaults=true to stand by the defaults deliberately. One (strategy, window) is ONE measurement: submitting the same strategy over the same dates again is refused and the existing run named -- read that with get_backtest instead. Both start_date and end_date are required: name the days, so the same question asked next week gives the same answer. Every message carries the current time, so work them out from that. A YYYY-MM-DD end date covers that whole UTC day; an end date of today stops at the end of yesterday, the last complete day; a later date is refused. get_benchmark reads the same dates the same way. When the person names no window, its length is set by the candle size: 5m 1 month, 15m 2 months, 30m 3 months, 1h 4 months, 4h 12 months, 1d 12 months (a month is 30 days). Pass end_date = today and start_date = today minus 30 days per month (1h: today minus 120 days); today is not complete, so the window covers exactly that many days, through the end of yesterday.\n\n[Access: pay 0.10 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"acknowledge_defaults": {
"default": false,
"description": "Pass True to submit even though signal parameters are at their library defaults -- an explicit statement that the defaults were considered and stood by, never a way to skip considering them.",
"type": "boolean"
},
"end_date": {
"description": "ISO end of the window.",
"type": "string"
},
"engine_generation": {
"description": "Only set when the person specifies an engine generation; omitted uses latest.",
"type": "integer"
},
"market_data_venue": {
"description": "Exact venue of the requested market.",
"type": "string"
},
"quote_token": {
"description": "Quote currency of the requested market.",
"type": "string"
},
"start_date": {
"description": "ISO start of the window, e.g. 2026-01-01.",
"type": "string"
},
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [
"end_date",
"start_date",
"strategy_id"
],
"type": "object"
},
"name": "run_backtest",
"outputSchema": null
},
{
"description": "To promote a sweep pick, pass source_experiment_id and source_run_index; the service loads its authorized configuration and checks coverage before saving. Its recorded venue and quote token are defaults: pass market_data_venue and/or quote_token only when the person chooses a different market. Otherwise compose and save a trading strategy from signals in the library. Give it a strategy_name, an asset, and the entry and exit signals you chose -- each one {name, params?, timeframe?}, with params defaulting from the library when omitted. DO NOT pass a signal's role: TRIGGER and FILTER are read from the library, and an entry must resolve to exactly one TRIGGER plus any number of FILTERs. Find real signal names with query_knowledge first; never invent one. The server checks the entry against the current market regime itself -- a strategy composed against the wrong regime is refused, and telling the person why is a better answer than saving it anyway. Pass constraints for supported execution settings requested by the person or justified by the composition workflow after reading the execution-config contract. Preserve explicit user choices; explain agent-selected adjustments as recommendations, not as values the person requested. Supplied values are kept exactly, while omitted values use server defaults or the selected source run. Saving the same strategy twice returns the first one rather than making a duplicate, and says so in created. What you save is a DRAFT: not tradeable until a backtest of it meets the platform's threshold spec, and it leaves draft on its own when one does.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"constraints": {
"additionalProperties": true,
"description": "Supported execution overrides requested by the person or justified by the composition workflow after reading the execution-config contract. Preserve explicit user choices and explain agent-selected adjustments. Each supplied value is kept exactly as given rather than nudged.",
"properties": {
"atr_cap_multiplier": {
"description": "SUPERSEDED by volatility_tolerance. Bounded the weighted blend at this multiple of the SHORT ATR.",
"x-mangrove-authoring-schema": {
"description": "SUPERSEDED by volatility_tolerance. Bounded the weighted blend at this multiple of the SHORT ATR.",
"minimum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy this is what made the weight pair inert past a long weight of roughly 6-12% (#1052).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
}
},
"atr_long_weight": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the daily ATR in the weighted-blend stop model, and always 1 - atr_short_weight rather than independent.",
"x-mangrove-authoring-schema": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the daily ATR in the weighted-blend stop model, and always 1 - atr_short_weight rather than independent.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. Derived, never independently effective.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
}
},
"atr_period": {
"description": "ATR lookback in bars (default 14) used to measure volatility for stop sizing.",
"x-mangrove-authoring-schema": {
"default": 14,
"description": "ATR lookback in bars (default 14) used to measure volatility for stop sizing.",
"maximum": 1000,
"minimum": 5,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher smooths the volatility estimate (steadier, slower-reacting stops). Lower reacts faster to recent volatility (choppier stops).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"atr_short_weight": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the signal-timeframe ATR in the weighted-blend stop model. Readable on a strategy created under that model; refused on any write.",
"x-mangrove-authoring-schema": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the signal-timeframe ATR in the weighted-blend stop model. Readable on a strategy created under that model; refused on any write.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy, higher favours the signal timeframe's own volatility -- though the cap made settings past a few percent of long weight indistinguishable (#1052).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
}
},
"atr_volatility_factor": {
"description": "SUPERSEDED by volatility_tolerance. Multiplied the blended ATR to give the stop distance. The dial's two endpoint factors carry this instead, one at each end of the width.",
"x-mangrove-authoring-schema": {
"description": "SUPERSEDED by volatility_tolerance. Multiplied the blended ATR to give the stop distance. The dial's two endpoint factors carry this instead, one at each end of the width.",
"exclusiveMinimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy, higher widens the stop and shrinks the position for the same risk.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
}
},
"circuit_breaker": {
"description": "Parameters for cooldown_model 'trades': pause on consecutive net losses or accumulated loss amount, pause on marked drawdown from the peak (including unrealized changes), resume new alpha positions at a reduced size, and stop after consecutive pauses. Canon defaults are 36 primary bars for a loss pause, 72 for a drawdown pause, and three strikes for a permanent halt. Pause counts are clamped to 24 hours through 14 days by default. max_drawdown_halt_limit separately stops entries on realized loss of cumulative gross deposits. Existing exits remain active during holds.",
"x-mangrove-authoring-schema": {
"additionalProperties": false,
"default": {
"consecutive_loss_limit": 2,
"drawdown_pause_bars": 72,
"loss_amount_pct": 0.06,
"max_consecutive_pauses": 3,
"pause_bars": 36,
"pause_max_days": 14,
"pause_min_hours": 24,
"resume_size_fraction": 0.5,
"resume_trades": 3
},
"description": "Parameters for cooldown_model 'trades': pause on consecutive net losses or accumulated loss amount, pause on marked drawdown from the peak (including unrealized changes), resume new alpha positions at a reduced size, and stop after consecutive pauses. Canon defaults are 36 primary bars for a loss pause, 72 for a drawdown pause, and three strikes for a permanent halt. Pause counts are clamped to 24 hours through 14 days by default. max_drawdown_halt_limit separately stops entries on realized loss of cumulative gross deposits. Existing exits remain active during holds.",
"properties": {
"consecutive_loss_limit": {
"default": 2,
"description": "Consecutive losing closes on an asset that start a pause. A winning close resets the count.",
"maximum": 100,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Lower pauses sooner after a losing run; higher tolerates longer runs.",
"x-mangrove-status": "tunable"
},
"drawdown_pause_bars": {
"default": 72,
"description": "Primary-timeframe bars denying entries after a drawdown pause (canon default 72). At drawdown-pause expiry the peak re-baselines to current account value. An alpha resume window opens only once no pause remains and no permanent halt is latched. The count is raised to cover pause_min_hours and lowered to fit pause_max_days (24 hours through 14 days by default).",
"maximum": 8760,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Longer holds the pause longer before trading can resume.",
"x-mangrove-status": "tunable"
},
"loss_amount_pct": {
"default": 0.06,
"description": "Accumulated net losses as a fraction of the closed-equity reset baseline that start a loss pause. A winning close clears the accumulation and resets the baseline. An asset loss pause clears it at the start and re-baselines at expiry; a global drawdown pause does not itself reset it.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number",
"x-mangrove-effect": "Lower pauses after smaller cumulative losses; higher tolerates larger ones.",
"x-mangrove-status": "tunable"
},
"max_consecutive_pauses": {
"default": 3,
"description": "Strikes that stop the strategy until a manual restart. A strike is one pause started, of any kind (consecutive losses, loss amount, drawdown, a resume window that lost money). Strikes reset to 0 only on a new equity high: a close that leaves closed equity above the high-water mark the strategy had when the first strike of the run was recorded. A winning close below that mark does not reset them, and a deposit or withdrawal does not count as a high.",
"maximum": 100,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Lower stops the strategy sooner; higher tolerates more repeated pauses.",
"x-mangrove-status": "tunable"
},
"pause_bars": {
"default": 36,
"description": "Primary-timeframe bars denying entries after a loss pause (canon default 36). The count is raised to cover pause_min_hours and lowered to fit pause_max_days on that timeframe (24 hours through 14 days by default).",
"maximum": 8760,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Longer sits out more of a bad regime; shorter resumes sooner.",
"x-mangrove-status": "tunable"
},
"pause_max_days": {
"default": 14,
"description": "A pause lasts at most this many days on every timeframe: the bar count is lowered to fit it.",
"exclusiveMinimum": 0,
"maximum": 365,
"type": "number",
"x-mangrove-effect": "Lower ends every pause sooner on long timeframes; higher leaves the bar count to decide.",
"x-mangrove-status": "tunable"
},
"pause_min_hours": {
"default": 24,
"description": "A pause lasts at least this many hours on every timeframe: the bar count of pause_bars or drawdown_pause_bars is raised to cover it.",
"exclusiveMinimum": 0,
"maximum": 336,
"type": "number",
"x-mangrove-effect": "Higher makes every pause at least that long on short timeframes; lower leaves the bar count to decide.",
"x-mangrove-status": "tunable"
},
"resume_size_fraction": {
"default": 0.5,
"description": "Fraction of normal size for new alpha positions while a resume window is open (canon default 0.5). Eligible confirmed position closes count toward resume_trades; a negative net result starts another loss pause and strike, while zero or a profit restores full alpha size. Core orders keep their normal allocation quantities after pause expiry: they are not positions and do not consume resume-trade counts. 1.0 disables the alpha size reduction.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number",
"x-mangrove-effect": "Lower risks less while the strategy proves itself again after a pause; higher resumes closer to full size.",
"x-mangrove-status": "tunable"
},
"resume_trades": {
"default": 3,
"description": "Eligible confirmed position closes booked in a resume window (canon default three). When the window completes, a negative net realized result starts a new loss pause and strike; zero or a profit restores full alpha size. A pause cancels the active window; a new one opens only once no pause remains and no permanent halt is latched. Core orders do not count as position closes.",
"maximum": 50,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Higher judges the resumed strategy over more trades before full size returns; lower decides sooner.",
"x-mangrove-status": "tunable"
}
},
"type": [
"object",
"null"
],
"x-mangrove-effect": "Tighter limits pause and stop sooner; looser limits keep trading through losing runs.",
"x-mangrove-status": "guardrail"
}
},
"cooldown_model": {
"description": "Loss-streak breaker model. 'bars' counts losing closes inside rolling windows of the primary timeframe (cooldown_config). 'trades' counts consecutive losing closes and realized loss amount, pauses for circuit_breaker bars of the primary timeframe (at least pause_min_hours and at most pause_max_days), and stops after repeated pauses (circuit_breaker). An absent model adopts the canonical 'trades' defaults; explicit 'bars' retains the legacy model.",
"x-mangrove-authoring-schema": {
"default": "trades",
"description": "Loss-streak breaker model. 'bars' counts losing closes inside rolling windows of the primary timeframe (cooldown_config). 'trades' counts consecutive losing closes and realized loss amount, pauses for circuit_breaker bars of the primary timeframe (at least pause_min_hours and at most pause_max_days), and stops after repeated pauses (circuit_breaker). An absent model adopts the canonical 'trades' defaults; explicit 'bars' retains the legacy model.",
"enum": [
"bars",
"trades",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "'trades' trips on trade count and loss size regardless of how far apart trades are spaced; 'bars' trips only when losses land inside the window. cooldown_config, cooldown_bars, daily_momentum_limit and weekly_momentum_limit are read only under 'bars': they are left out of a resolved config under 'trades', and a config that carries them under 'trades' has them dropped.",
"x-mangrove-status": "guardrail"
}
},
"enable_volatility_adjustment": {
"description": "Toggles volatility-based position scaling (default false).",
"x-mangrove-authoring-schema": {
"default": false,
"description": "Toggles volatility-based position scaling (default false).",
"type": [
"boolean",
"null"
],
"x-mangrove-effect": "When true, positions are scaled down by target_volatility / (atr/entry) if ATR%% exceeds target; only reduces size, never increases.",
"x-mangrove-status": "gated"
}
},
"exit_on_loss_after_bars": {
"description": "Exit a losing position after this many bars.",
"x-mangrove-authoring-schema": {
"default": 1000,
"description": "Exit a losing position after this many bars.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower cuts losers sooner; higher gives them more time to recover.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"exit_on_profit_after_bars": {
"description": "Exit a winning position after this many bars.",
"x-mangrove-authoring-schema": {
"default": 1000,
"description": "Exit a winning position after this many bars.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower banks winners sooner; higher lets them run.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"initial_balance": {
"description": "Starting balance for the backtest/simulation (default $10,000).",
"x-mangrove-authoring-schema": {
"default": 10000,
"description": "Starting balance for the backtest/simulation (default $10,000).",
"maximum": 1000000000,
"minimum": 25,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Scales absolute dollar figures; not a strategy-character knob.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_drawdown_halt_limit": {
"description": "Permanent capital-floor entry halt (0.20 = 20%). Closed, realized equity is compared with cumulative gross deposits (execution_state.cumulative_deposits), not a rolling peak or the signed net-funding balance; withdrawals do not reduce this reference. Legacy requests without cumulative_deposits use execution_config.initial_balance. The shared live/paper evaluator checks before each bar and latches execution_state.halt. New alpha entries and v3 core allocations are denied, while authoritative positions retain protective exits and exits_pending until physically flat. Engine-owned strategies become inactive only after that book is flat; caller-owned executors retain their exit monitor. An explicit manual restart is required to clear the latch. Backtests enforce the same floor when evaluate_bar receives enforce_capital_floor=True, managing open-position exits through the final bar. Applies to both cooldown models; null disables new floor trips, while an existing halt remains latched.",
"x-mangrove-authoring-schema": {
"default": 0.2,
"description": "Permanent capital-floor entry halt (0.20 = 20%). Closed, realized equity is compared with cumulative gross deposits (execution_state.cumulative_deposits), not a rolling peak or the signed net-funding balance; withdrawals do not reduce this reference. Legacy requests without cumulative_deposits use execution_config.initial_balance. The shared live/paper evaluator checks before each bar and latches execution_state.halt. New alpha entries and v3 core allocations are denied, while authoritative positions retain protective exits and exits_pending until physically flat. Engine-owned strategies become inactive only after that book is flat; caller-owned executors retain their exit monitor. An explicit manual restart is required to clear the latch. Backtests enforce the same floor when evaluate_bar receives enforce_capital_floor=True, managing open-position exits through the final bar. Applies to both cooldown models; null disables new floor trips, while an existing halt remains latched.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Lower protects more of gross deposited capital before a permanent entry halt; higher tolerates a deeper realized loss. This does not resize positions or stop protective exit evaluation. Do not add a separate floor where the shared evaluator enforces it.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_drawdown_limit": {
"description": "Peak-relative entry pause (0.20 = 20%). The canonical 'trades' model measures marked equity against its high-water mark. A breach starts one drawdown pause and strike; circuit_breaker.drawdown_pause_bars defaults to 72 primary bars, clamped to pause_min_hours and pause_max_days (24 hours and 14 days by default). At drawdown-pause expiry the peak re-baselines; a reduced-size alpha resume window opens only once no pause remains and no permanent halt is latched. Explicit 'bars' retains the legacy closed-equity measurement and per-timeframe long cooldown. Both models deny new entries while allowing existing positions to exit; automatic v3 core allocations honor the hold too. null disables new drawdown trips.",
"x-mangrove-authoring-schema": {
"default": 0.2,
"description": "Peak-relative entry pause (0.20 = 20%). The canonical 'trades' model measures marked equity against its high-water mark. A breach starts one drawdown pause and strike; circuit_breaker.drawdown_pause_bars defaults to 72 primary bars, clamped to pause_min_hours and pause_max_days (24 hours and 14 days by default). At drawdown-pause expiry the peak re-baselines; a reduced-size alpha resume window opens only once no pause remains and no permanent halt is latched. Explicit 'bars' retains the legacy closed-equity measurement and per-timeframe long cooldown. Both models deny new entries while allowing existing positions to exit; automatic v3 core allocations honor the hold too. null disables new drawdown trips.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Lower pauses entries after a smaller drawdown; higher tolerates a deeper drawdown. The shared entry breaker enforces this in single/bulk live and paper evaluation, v3 core allocation and backtests built with risk_manager_from_execution_config. Alpha resume sizing is a separate control; do not add a second drawdown stop.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_hold_bars": {
"description": "Maximum bars to hold any position before a forced exit.",
"x-mangrove-authoring-schema": {
"default": 1000,
"description": "Maximum bars to hold any position before a forced exit.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher lets trades run longer; lower forces earlier time-based exits.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"max_hold_time_hours": {
"description": "Maximum position hold time in hours (null = no limit).",
"x-mangrove-authoring-schema": {
"default": null,
"description": "Maximum position hold time in hours (null = no limit).",
"exclusiveMinimum": 1,
"maximum": 8760,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower forces earlier time-based exits; null/higher lets trades run indefinitely on time.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"max_open_positions": {
"description": "Maximum concurrent open positions.",
"x-mangrove-authoring-schema": {
"default": 10,
"description": "Maximum concurrent open positions.",
"maximum": 1000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher allows more simultaneous exposure (more diversification but more aggregate risk); lower is more selective with less aggregate exposure.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"max_risk_per_trade": {
"description": "Fraction of account equity risked per trade (0.01 = 1%). Position size is derived from this and the stop distance.",
"x-mangrove-authoring-schema": {
"default": 0.01,
"description": "Fraction of account equity risked per trade (0.01 = 1%). Position size is derived from this and the stop distance.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher risks more per trade: bigger positions, larger gains AND larger drawdowns. Lower is more conservative: smaller positions, smaller swings.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"max_trade_amount": {
"description": "Absolute cap on dollar size per trade.",
"x-mangrove-authoring-schema": {
"default": 10000000,
"description": "Absolute cap on dollar size per trade.",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Size guardrail; rarely binding.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_trades_per_day": {
"description": "Daily trade cap.",
"x-mangrove-authoring-schema": {
"default": 50,
"description": "Daily trade cap.",
"maximum": 1440,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher permits more churn; lower throttles activity.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_units_per_trade": {
"description": "Absolute cap on units per trade.",
"x-mangrove-authoring-schema": {
"default": 1000000,
"description": "Absolute cap on units per trade.",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Size guardrail; rarely binding.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"min_asset_balance": {
"description": "position_size_calc 'v3' only. Minimum asset balance, in asset units, the strategy holds outside open trades.",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Minimum asset balance, in asset units, the strategy holds outside open trades.",
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more of the asset out of reach of sell trades and core sells, and takes more cash to reach; lower frees more of the asset for trading.",
"x-mangrove-status": "guardrail"
}
},
"min_balance_days": {
"description": "position_size_calc 'v3' only. Number of equal daily orders used to bring a side up to its minimum balance.",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Number of equal daily orders used to bring a side up to its minimum balance.",
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher spreads the minimum-balance orders over more days at smaller size; lower reaches the minimum sooner with larger orders.",
"x-mangrove-status": "guardrail"
}
},
"min_balance_threshold": {
"description": "Cash reserve fraction held back from new entries (0.1 = 10%). v1 reserves this fraction of cash; v2 reserves this fraction of account value (cash + open positions at market). An entry may only use cash above the reserve; when no cash is deployable the entry is denied (insufficient_cash / insufficient_cash_v2_account_reserve). It never halts the strategy and never closes positions.",
"x-mangrove-authoring-schema": {
"default": 0.1,
"description": "Cash reserve fraction held back from new entries (0.1 = 10%). v1 reserves this fraction of cash; v2 reserves this fraction of account value (cash + open positions at market). An entry may only use cash above the reserve; when no cash is deployable the entry is denied (insufficient_cash / insufficient_cash_v2_account_reserve). It never halts the strategy and never closes positions.",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more cash idle and makes entries smaller or rarer as the account shrinks; lower lets entries use more of the balance. Not a drawdown stop; see max_drawdown_limit and max_drawdown_halt_limit.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"min_cash_balance": {
"description": "position_size_calc 'v3' only. Minimum cash balance the strategy holds after the worst-case loss of every open trade.",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Minimum cash balance the strategy holds after the worst-case loss of every open trade.",
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more cash out of reach of buy trades and core buys, so entries are smaller or rarer; lower frees more cash for trading.",
"x-mangrove-status": "guardrail"
}
},
"min_stop_distance_pct": {
"description": "Hard floor on stop distance as a fraction of entry price (crypto minimum), applied after ATR sizing.",
"x-mangrove-authoring-schema": {
"default": 0.005,
"description": "Hard floor on stop distance as a fraction of entry price (crypto minimum), applied after ATR sizing.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher enforces a wider minimum stop; lower allows tighter stops down to the floor.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"min_trade_amount": {
"description": "Minimum trade size in dollars; smaller intended trades are skipped.",
"x-mangrove-authoring-schema": {
"default": 25,
"description": "Minimum trade size in dollars; smaller intended trades are skipped.",
"maximum": 1000000,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher skips more small signals; lower allows smaller trades.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"position_size_calc": {
"description": "Sizing-engine version ('v1', 'v2' or 'v3'). Pinned at creation and immutable. 'v3' holds an asset balance and a cash balance, sizes against equity net of open risk, and requires the position_size_calc 'v3' parameters.",
"x-mangrove-authoring-schema": {
"default": "v2",
"description": "Sizing-engine version ('v1', 'v2' or 'v3'). Pinned at creation and immutable. 'v3' holds an asset balance and a cash balance, sizes against equity net of open risk, and requires the position_size_calc 'v3' parameters.",
"enum": [
"v1",
"v2",
"v3",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "Not a magnitude knob; selects the sizing algorithm. Do not change on an existing strategy.",
"x-mangrove-status": "guardrail"
}
},
"profit_threshold_pct": {
"description": "Profit threshold (5%% default) above which a position counts as 'winning' for the time-based exit logic.",
"x-mangrove-authoring-schema": {
"default": 0.05,
"description": "Profit threshold (5%% default) above which a position counts as 'winning' for the time-based exit logic.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher requires a larger gain before a position is treated as winning; lower treats smaller gains as wins.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"rebalance_band": {
"description": "position_size_calc 'v3' only. Absolute deviation of the asset weight from target_asset_weight that triggers a rebalance order (0.05 = 5 points).",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Absolute deviation of the asset weight from target_asset_weight that triggers a rebalance order (0.05 = 5 points).",
"exclusiveMaximum": 1,
"exclusiveMinimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher lets the split drift further before a rebalance order, so fewer core orders; lower holds the split closer to target with more core orders and more fees.",
"x-mangrove-status": "tunable"
}
},
"reward_factor": {
"description": "Risk/reward target. Take-profit distance = reward_factor * stop_distance.",
"x-mangrove-authoring-schema": {
"default": 2,
"description": "Risk/reward target. Take-profit distance = reward_factor * stop_distance.",
"exclusiveMinimum": 0,
"maximum": 100,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher sets a wider profit target: lower win rate but bigger wins. Lower sets a tighter target: higher win rate but smaller wins.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"stop_gap_allowance": {
"description": "position_size_calc 'v3' only. Fraction of the stop price a stop fill is assumed to miss by when computing the worst-case loss of a trade (0.01 = 1%).",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Fraction of the stop price a stop fill is assumed to miss by when computing the worst-case loss of a trade (0.01 = 1%).",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher counts more risk per open trade, leaving less available cash and smaller positions; lower counts less.",
"x-mangrove-status": "guardrail"
}
},
"stop_model": {
"description": "Which stop model the strategy uses: 'atr_width_dial' (one parameter, volatility_tolerance, positioned on the ATR width) or 'weighted_atr' (superseded: a weighted blend of two ATRs, capped). Pinned at creation and immutable.",
"x-mangrove-authoring-schema": {
"default": "atr_width_dial",
"description": "Which stop model the strategy uses: 'atr_width_dial' (one parameter, volatility_tolerance, positioned on the ATR width) or 'weighted_atr' (superseded: a weighted blend of two ATRs, capped). Pinned at creation and immutable.",
"enum": [
"atr_width_dial",
"weighted_atr",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "Not a magnitude knob; selects the stop algorithm. Do not change on an existing strategy -- it would move every stop the strategy takes.",
"x-mangrove-status": "guardrail"
}
},
"taker_fee_rate": {
"description": "position_size_calc 'v3' only. Venue fee per fill as a fraction of notional, charged in cash (0.004 = 0.4%).",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Venue fee per fill as a fraction of notional, charged in cash (0.004 = 0.4%).",
"exclusiveMaximum": 0.1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher counts more cost per fill, raising the risk of each trade and lowering available cash. Models the venue; not a strategy-character knob.",
"x-mangrove-status": "guardrail"
}
},
"target_asset_weight": {
"description": "position_size_calc 'v3' only. Target share of core value held in the asset (0.8 = 80% asset, 20% cash; 0 = all cash).",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Target share of core value held in the asset (0.8 = 80% asset, 20% cash; 0 = all cash).",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher holds more of the asset and less cash; lower holds more cash. The daily core order moves the split back to this value once it drifts past rebalance_band. At 0 with no asset held, no core order is placed and only buy trades can pass.",
"x-mangrove-status": "tunable"
}
},
"target_volatility": {
"description": "Target volatility (0.10 = 10%). ONLY active when enable_volatility_adjustment is true (default false). When active, scales position size down if ATR%% of entry exceeds the target (never up).",
"x-mangrove-authoring-schema": {
"default": 0.1,
"description": "Target volatility (0.10 = 10%). ONLY active when enable_volatility_adjustment is true (default false). When active, scales position size down if ATR%% of entry exceeds the target (never up).",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "With the gate off (the default), changing this has no effect. With it on, lower scales positions down more aggressively in high volatility.",
"x-mangrove-gate-field": "enable_volatility_adjustment",
"x-mangrove-gate-required": true,
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "gated"
}
},
"volatility_mode": {
"description": "Unused (retained for backward compatibility). Volatility is derived from ATR.",
"x-mangrove-authoring-schema": {
"default": "stddev",
"description": "Unused (retained for backward compatibility). Volatility is derived from ATR.",
"enum": [
"stddev",
"atr",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "No runtime effect. Do not tune.",
"x-mangrove-status": "unused"
}
},
"volatility_tolerance": {
"description": "Where on the ATR width the stop is taken, as the ATR_long-vs-ATR_short contribution ratio: 0 is all short end (0.5x the signal timeframe's ATR), 1 is all long end (2x the daily ATR). Interpolated geometrically, so the value is exactly the long end's share of log(stop) and each 0.1 is the same multiplicative step. Replaces atr_short_weight, atr_long_weight and atr_cap_multiplier.",
"x-mangrove-authoring-schema": {
"default": 0.5,
"description": "Where on the ATR width the stop is taken, as the ATR_long-vs-ATR_short contribution ratio: 0 is all short end (0.5x the signal timeframe's ATR), 1 is all long end (2x the daily ATR). Interpolated geometrically, so the value is exactly the long end's share of log(stop) and each 0.1 is the same multiplicative step. Replaces atr_short_weight, atr_long_weight and atr_cap_multiplier.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher widens the stop, and because position size is the risk budget divided by the stop distance, exposure shrinks in exact inverse proportion at the SAME risk. Low means many units with little room to be wrong and frequent stop-outs; high means few units that are hard to shake out but need a much larger move to reach the same reward. Both risk max_risk_per_trade.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"volatility_window": {
"description": "Unused (retained for backward compatibility). ATR windowing is controlled by atr_period.",
"x-mangrove-authoring-schema": {
"default": 24,
"description": "Unused (retained for backward compatibility). ATR windowing is controlled by atr_period.",
"maximum": 1000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "No runtime effect. Do not tune.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "unused"
}
}
},
"type": "object",
"x-mangrove-authoring-schema": {
"$id": "urn:mangrove:execution-config:1",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": true,
"description": "Canonical authoring representation derived from server metadata and defaults. Top-level optional keys may be omitted or null. The existing HTTP validator separately coerces top-level numeric strings, enforces their declared bounds and permits unknown/legacy fields; it does not enforce this whole nested schema. Runtime strategy/version/timeframe checks remain authoritative. Cooldown durations may be omitted by legacy configs and then fall back to their corresponding windows.",
"properties": {
"atr_cap_multiplier": {
"description": "SUPERSEDED by volatility_tolerance. Bounded the weighted blend at this multiple of the SHORT ATR.",
"minimum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy this is what made the weight pair inert past a long weight of roughly 6-12% (#1052).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
},
"atr_long_weight": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the daily ATR in the weighted-blend stop model, and always 1 - atr_short_weight rather than independent.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. Derived, never independently effective.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
},
"atr_period": {
"default": 14,
"description": "ATR lookback in bars (default 14) used to measure volatility for stop sizing.",
"maximum": 1000,
"minimum": 5,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher smooths the volatility estimate (steadier, slower-reacting stops). Lower reacts faster to recent volatility (choppier stops).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"atr_short_weight": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the signal-timeframe ATR in the weighted-blend stop model. Readable on a strategy created under that model; refused on any write.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy, higher favours the signal timeframe's own volatility -- though the cap made settings past a few percent of long weight indistinguishable (#1052).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
},
"atr_volatility_factor": {
"description": "SUPERSEDED by volatility_tolerance. Multiplied the blended ATR to give the stop distance. The dial's two endpoint factors carry this instead, one at each end of the width.",
"exclusiveMinimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy, higher widens the stop and shrinks the position for the same risk.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
},
"circuit_breaker": {
"additionalProperties": false,
"default": {
"consecutive_loss_limit": 2,
"drawdown_pause_bars": 72,
"loss_amount_pct": 0.06,
"max_consecutive_pauses": 3,
"pause_bars": 36,
"pause_max_days": 14,
"pause_min_hours": 24,
"resume_size_fraction": 0.5,
"resume_trades": 3
},
"description": "Parameters for cooldown_model 'trades': pause on consecutive net losses or accumulated loss amount, pause on marked drawdown from the peak (including unrealized changes), resume new alpha positions at a reduced size, and stop after consecutive pauses. Canon defaults are 36 primary bars for a loss pause, 72 for a drawdown pause, and three strikes for a permanent halt. Pause counts are clamped to 24 hours through 14 days by default. max_drawdown_halt_limit separately stops entries on realized loss of cumulative gross deposits. Existing exits remain active during holds.",
"properties": {
"consecutive_loss_limit": {
"default": 2,
"description": "Consecutive losing closes on an asset that start a pause. A winning close resets the count.",
"maximum": 100,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Lower pauses sooner after a losing run; higher tolerates longer runs.",
"x-mangrove-status": "tunable"
},
"drawdown_pause_bars": {
"default": 72,
"description": "Primary-timeframe bars denying entries after a drawdown pause (canon default 72). At drawdown-pause expiry the peak re-baselines to current account value. An alpha resume window opens only once no pause remains and no permanent halt is latched. The count is raised to cover pause_min_hours and lowered to fit pause_max_days (24 hours through 14 days by default).",
"maximum": 8760,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Longer holds the pause longer before trading can resume.",
"x-mangrove-status": "tunable"
},
"loss_amount_pct": {
"default": 0.06,
"description": "Accumulated net losses as a fraction of the closed-equity reset baseline that start a loss pause. A winning close clears the accumulation and resets the baseline. An asset loss pause clears it at the start and re-baselines at expiry; a global drawdown pause does not itself reset it.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number",
"x-mangrove-effect": "Lower pauses after smaller cumulative losses; higher tolerates larger ones.",
"x-mangrove-status": "tunable"
},
"max_consecutive_pauses": {
"default": 3,
"description": "Strikes that stop the strategy until a manual restart. A strike is one pause started, of any kind (consecutive losses, loss amount, drawdown, a resume window that lost money). Strikes reset to 0 only on a new equity high: a close that leaves closed equity above the high-water mark the strategy had when the first strike of the run was recorded. A winning close below that mark does not reset them, and a deposit or withdrawal does not count as a high.",
"maximum": 100,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Lower stops the strategy sooner; higher tolerates more repeated pauses.",
"x-mangrove-status": "tunable"
},
"pause_bars": {
"default": 36,
"description": "Primary-timeframe bars denying entries after a loss pause (canon default 36). The count is raised to cover pause_min_hours and lowered to fit pause_max_days on that timeframe (24 hours through 14 days by default).",
"maximum": 8760,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Longer sits out more of a bad regime; shorter resumes sooner.",
"x-mangrove-status": "tunable"
},
"pause_max_days": {
"default": 14,
"description": "A pause lasts at most this many days on every timeframe: the bar count is lowered to fit it.",
"exclusiveMinimum": 0,
"maximum": 365,
"type": "number",
"x-mangrove-effect": "Lower ends every pause sooner on long timeframes; higher leaves the bar count to decide.",
"x-mangrove-status": "tunable"
},
"pause_min_hours": {
"default": 24,
"description": "A pause lasts at least this many hours on every timeframe: the bar count of pause_bars or drawdown_pause_bars is raised to cover it.",
"exclusiveMinimum": 0,
"maximum": 336,
"type": "number",
"x-mangrove-effect": "Higher makes every pause at least that long on short timeframes; lower leaves the bar count to decide.",
"x-mangrove-status": "tunable"
},
"resume_size_fraction": {
"default": 0.5,
"description": "Fraction of normal size for new alpha positions while a resume window is open (canon default 0.5). Eligible confirmed position closes count toward resume_trades; a negative net result starts another loss pause and strike, while zero or a profit restores full alpha size. Core orders keep their normal allocation quantities after pause expiry: they are not positions and do not consume resume-trade counts. 1.0 disables the alpha size reduction.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number",
"x-mangrove-effect": "Lower risks less while the strategy proves itself again after a pause; higher resumes closer to full size.",
"x-mangrove-status": "tunable"
},
"resume_trades": {
"default": 3,
"description": "Eligible confirmed position closes booked in a resume window (canon default three). When the window completes, a negative net realized result starts a new loss pause and strike; zero or a profit restores full alpha size. A pause cancels the active window; a new one opens only once no pause remains and no permanent halt is latched. Core orders do not count as position closes.",
"maximum": 50,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Higher judges the resumed strategy over more trades before full size returns; lower decides sooner.",
"x-mangrove-status": "tunable"
}
},
"type": [
"object",
"null"
],
"x-mangrove-effect": "Tighter limits pause and stop sooner; looser limits keep trading through losing runs.",
"x-mangrove-status": "guardrail"
},
"cooldown_model": {
"default": "trades",
"description": "Loss-streak breaker model. 'bars' counts losing closes inside rolling windows of the primary timeframe (cooldown_config). 'trades' counts consecutive losing closes and realized loss amount, pauses for circuit_breaker bars of the primary timeframe (at least pause_min_hours and at most pause_max_days), and stops after repeated pauses (circuit_breaker). An absent model adopts the canonical 'trades' defaults; explicit 'bars' retains the legacy model.",
"enum": [
"bars",
"trades",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "'trades' trips on trade count and loss size regardless of how far apart trades are spaced; 'bars' trips only when losses land inside the window. cooldown_config, cooldown_bars, daily_momentum_limit and weekly_momentum_limit are read only under 'bars': they are left out of a resolved config under 'trades', and a config that carries them under 'trades' has them dropped.",
"x-mangrove-status": "guardrail"
},
"enable_volatility_adjustment": {
"default": false,
"description": "Toggles volatility-based position scaling (default false).",
"type": [
"boolean",
"null"
],
"x-mangrove-effect": "When true, positions are scaled down by target_volatility / (atr/entry) if ATR%% exceeds target; only reduces size, never increases.",
"x-mangrove-status": "gated"
},
"exit_on_loss_after_bars": {
"default": 1000,
"description": "Exit a losing position after this many bars.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower cuts losers sooner; higher gives them more time to recover.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"exit_on_profit_after_bars": {
"default": 1000,
"description": "Exit a winning position after this many bars.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower banks winners sooner; higher lets them run.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"initial_balance": {
"default": 10000,
"description": "Starting balance for the backtest/simulation (default $10,000).",
"maximum": 1000000000,
"minimum": 25,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Scales absolute dollar figures; not a strategy-character knob.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_drawdown_halt_limit": {
"default": 0.2,
"description": "Permanent capital-floor entry halt (0.20 = 20%). Closed, realized equity is compared with cumulative gross deposits (execution_state.cumulative_deposits), not a rolling peak or the signed net-funding balance; withdrawals do not reduce this reference. Legacy requests without cumulative_deposits use execution_config.initial_balance. The shared live/paper evaluator checks before each bar and latches execution_state.halt. New alpha entries and v3 core allocations are denied, while authoritative positions retain protective exits and exits_pending until physically flat. Engine-owned strategies become inactive only after that book is flat; caller-owned executors retain their exit monitor. An explicit manual restart is required to clear the latch. Backtests enforce the same floor when evaluate_bar receives enforce_capital_floor=True, managing open-position exits through the final bar. Applies to both cooldown models; null disables new floor trips, while an existing halt remains latched.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Lower protects more of gross deposited capital before a permanent entry halt; higher tolerates a deeper realized loss. This does not resize positions or stop protective exit evaluation. Do not add a separate floor where the shared evaluator enforces it.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_drawdown_limit": {
"default": 0.2,
"description": "Peak-relative entry pause (0.20 = 20%). The canonical 'trades' model measures marked equity against its high-water mark. A breach starts one drawdown pause and strike; circuit_breaker.drawdown_pause_bars defaults to 72 primary bars, clamped to pause_min_hours and pause_max_days (24 hours and 14 days by default). At drawdown-pause expiry the peak re-baselines; a reduced-size alpha resume window opens only once no pause remains and no permanent halt is latched. Explicit 'bars' retains the legacy closed-equity measurement and per-timeframe long cooldown. Both models deny new entries while allowing existing positions to exit; automatic v3 core allocations honor the hold too. null disables new drawdown trips.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Lower pauses entries after a smaller drawdown; higher tolerates a deeper drawdown. The shared entry breaker enforces this in single/bulk live and paper evaluation, v3 core allocation and backtests built with risk_manager_from_execution_config. Alpha resume sizing is a separate control; do not add a second drawdown stop.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_hold_bars": {
"default": 1000,
"description": "Maximum bars to hold any position before a forced exit.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher lets trades run longer; lower forces earlier time-based exits.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"max_hold_time_hours": {
"default": null,
"description": "Maximum position hold time in hours (null = no limit).",
"exclusiveMinimum": 1,
"maximum": 8760,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower forces earlier time-based exits; null/higher lets trades run indefinitely on time.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"max_open_positions": {
"default": 10,
"description": "Maximum concurrent open positions.",
"maximum": 1000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher allows more simultaneous exposure (more diversification but more aggregate risk); lower is more selective with less aggregate exposure.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"max_risk_per_trade": {
"default": 0.01,
"description": "Fraction of account equity risked per trade (0.01 = 1%). Position size is derived from this and the stop distance.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher risks more per trade: bigger positions, larger gains AND larger drawdowns. Lower is more conservative: smaller positions, smaller swings.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"max_trade_amount": {
"default": 10000000,
"description": "Absolute cap on dollar size per trade.",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Size guardrail; rarely binding.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_trades_per_day": {
"default": 50,
"description": "Daily trade cap.",
"maximum": 1440,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher permits more churn; lower throttles activity.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_units_per_trade": {
"default": 1000000,
"description": "Absolute cap on units per trade.",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Size guardrail; rarely binding.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"min_asset_balance": {
"description": "position_size_calc 'v3' only. Minimum asset balance, in asset units, the strategy holds outside open trades.",
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more of the asset out of reach of sell trades and core sells, and takes more cash to reach; lower frees more of the asset for trading.",
"x-mangrove-status": "guardrail"
},
"min_balance_days": {
"description": "position_size_calc 'v3' only. Number of equal daily orders used to bring a side up to its minimum balance.",
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher spreads the minimum-balance orders over more days at smaller size; lower reaches the minimum sooner with larger orders.",
"x-mangrove-status": "guardrail"
},
"min_balance_threshold": {
"default": 0.1,
"description": "Cash reserve fraction held back from new entries (0.1 = 10%). v1 reserves this fraction of cash; v2 reserves this fraction of account value (cash + open positions at market). An entry may only use cash above the reserve; when no cash is deployable the entry is denied (insufficient_cash / insufficient_cash_v2_account_reserve). It never halts the strategy and never closes positions.",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more cash idle and makes entries smaller or rarer as the account shrinks; lower lets entries use more of the balance. Not a drawdown stop; see max_drawdown_limit and max_drawdown_halt_limit.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"min_cash_balance": {
"description": "position_size_calc 'v3' only. Minimum cash balance the strategy holds after the worst-case loss of every open trade.",
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more cash out of reach of buy trades and core buys, so entries are smaller or rarer; lower frees more cash for trading.",
"x-mangrove-status": "guardrail"
},
"min_stop_distance_pct": {
"default": 0.005,
"description": "Hard floor on stop distance as a fraction of entry price (crypto minimum), applied after ATR sizing.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher enforces a wider minimum stop; lower allows tighter stops down to the floor.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"min_trade_amount": {
"default": 25,
"description": "Minimum trade size in dollars; smaller intended trades are skipped.",
"maximum": 1000000,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher skips more small signals; lower allows smaller trades.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"position_size_calc": {
"default": "v2",
"description": "Sizing-engine version ('v1', 'v2' or 'v3'). Pinned at creation and immutable. 'v3' holds an asset balance and a cash balance, sizes against equity net of open risk, and requires the position_size_calc 'v3' parameters.",
"enum": [
"v1",
"v2",
"v3",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "Not a magnitude knob; selects the sizing algorithm. Do not change on an existing strategy.",
"x-mangrove-status": "guardrail"
},
"profit_threshold_pct": {
"default": 0.05,
"description": "Profit threshold (5%% default) above which a position counts as 'winning' for the time-based exit logic.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher requires a larger gain before a position is treated as winning; lower treats smaller gains as wins.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"rebalance_band": {
"description": "position_size_calc 'v3' only. Absolute deviation of the asset weight from target_asset_weight that triggers a rebalance order (0.05 = 5 points).",
"exclusiveMaximum": 1,
"exclusiveMinimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher lets the split drift further before a rebalance order, so fewer core orders; lower holds the split closer to target with more core orders and more fees.",
"x-mangrove-status": "tunable"
},
"reward_factor": {
"default": 2,
"description": "Risk/reward target. Take-profit distance = reward_factor * stop_distance.",
"exclusiveMinimum": 0,
"maximum": 100,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher sets a wider profit target: lower win rate but bigger wins. Lower sets a tighter target: higher win rate but smaller wins.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"stop_gap_allowance": {
"description": "position_size_calc 'v3' only. Fraction of the stop price a stop fill is assumed to miss by when computing the worst-case loss of a trade (0.01 = 1%).",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher counts more risk per open trade, leaving less available cash and smaller positions; lower counts less.",
"x-mangrove-status": "guardrail"
},
"stop_model": {
"default": "atr_width_dial",
"description": "Which stop model the strategy uses: 'atr_width_dial' (one parameter, volatility_tolerance, positioned on the ATR width) or 'weighted_atr' (superseded: a weighted blend of two ATRs, capped). Pinned at creation and immutable.",
"enum": [
"atr_width_dial",
"weighted_atr",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "Not a magnitude knob; selects the stop algorithm. Do not change on an existing strategy -- it would move every stop the strategy takes.",
"x-mangrove-status": "guardrail"
},
"taker_fee_rate": {
"description": "position_size_calc 'v3' only. Venue fee per fill as a fraction of notional, charged in cash (0.004 = 0.4%).",
"exclusiveMaximum": 0.1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher counts more cost per fill, raising the risk of each trade and lowering available cash. Models the venue; not a strategy-character knob.",
"x-mangrove-status": "guardrail"
},
"target_asset_weight": {
"description": "position_size_calc 'v3' only. Target share of core value held in the asset (0.8 = 80% asset, 20% cash; 0 = all cash).",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher holds more of the asset and less cash; lower holds more cash. The daily core order moves the split back to this value once it drifts past rebalance_band. At 0 with no asset held, no core order is placed and only buy trades can pass.",
"x-mangrove-status": "tunable"
},
"target_volatility": {
"default": 0.1,
"description": "Target volatility (0.10 = 10%). ONLY active when enable_volatility_adjustment is true (default false). When active, scales position size down if ATR%% of entry exceeds the target (never up).",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "With the gate off (the default), changing this has no effect. With it on, lower scales positions down more aggressively in high volatility.",
"x-mangrove-gate-field": "enable_volatility_adjustment",
"x-mangrove-gate-required": true,
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "gated"
},
"volatility_mode": {
"default": "stddev",
"description": "Unused (retained for backward compatibility). Volatility is derived from ATR.",
"enum": [
"stddev",
"atr",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "No runtime effect. Do not tune.",
"x-mangrove-status": "unused"
},
"volatility_tolerance": {
"default": 0.5,
"description": "Where on the ATR width the stop is taken, as the ATR_long-vs-ATR_short contribution ratio: 0 is all short end (0.5x the signal timeframe's ATR), 1 is all long end (2x the daily ATR). Interpolated geometrically, so the value is exactly the long end's share of log(stop) and each 0.1 is the same multiplicative step. Replaces atr_short_weight, atr_long_weight and atr_cap_multiplier.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher widens the stop, and because position size is the risk budget divided by the stop distance, exposure shrinks in exact inverse proportion at the SAME risk. Low means many units with little room to be wrong and frequent stop-outs; high means few units that are hard to shake out but need a much larger move to reach the same reward. Both risk max_risk_per_trade.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"volatility_window": {
"default": 24,
"description": "Unused (retained for backward compatibility). ATR windowing is controlled by atr_period.",
"maximum": 1000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "No runtime effect. Do not tune.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "unused"
}
},
"title": "Execution configuration",
"type": "object",
"x-mangrove-boundary-validation": "top-level numeric bounds after legacy coercion; null means unset"
}
},
"entry_signals": {
"description": "The signals that open a position. Exactly one must be a TRIGGER in the knowledge graph; the rest are FILTERs.",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "The signal's name, exactly as the knowledge graph has it.",
"type": "string"
},
"params": {
"description": "Its parameters and the value chosen for each, keyed by parameter name -- the shape `query_knowledge op=get` shows them in. A parameter left out takes the signal's own default, which is a choice nobody made. A name the signal does not take, or a value outside its declared range, is refused.",
"type": "object"
},
"timeframe": {
"description": "The candle size this signal runs on.",
"enum": [
"5m",
"15m",
"30m",
"1h",
"4h",
"1D"
],
"type": "string"
}
},
"required": [
"name",
"timeframe"
],
"type": "object"
},
"type": "array"
},
"exit_signals": {
"description": "The signals that close one, same shape. A strategy may have none, and then it exits on risk rules alone.",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "The signal's name, exactly as the knowledge graph has it.",
"type": "string"
},
"params": {
"description": "Its parameters and the value chosen for each, keyed by parameter name -- the shape `query_knowledge op=get` shows them in. A parameter left out takes the signal's own default, which is a choice nobody made. A name the signal does not take, or a value outside its declared range, is refused.",
"type": "object"
},
"timeframe": {
"description": "The candle size this signal runs on.",
"enum": [
"5m",
"15m",
"30m",
"1h",
"4h",
"1D"
],
"type": "string"
}
},
"required": [
"name",
"timeframe"
],
"type": "object"
},
"type": "array"
},
"market_data_venue": {
"description": "Exact venue of the requested market.",
"type": "string"
},
"quote_token": {
"description": "Quote currency of the requested market.",
"type": "string"
},
"regime_direction": {
"description": "The direction band from get_market_regime, e.g. bear. The signal searches filter by it and find_sweep_runs marks each row's regime_fit with it; save_strategy and update_strategy read the current band themselves, so their check runs without it.",
"type": "string"
},
"regime_override": {
"default": false,
"description": "Save anyway when the regime check refuses. Only ever on the person's explicit say-so, after they have been told why.",
"type": "boolean"
},
"source_config_hash": {
"description": "The selected row's config_hash, as find_sweep_runs reported it. Pass it with the other two: a relaunched sweep can give one run_index to several runs, and without it such an index is refused.",
"type": "string"
},
"source_experiment_id": {
"description": "For a sweep pick, its experiment ID. Supply with source_run_index. The stored run supplies the exact signals and execution settings. With no market given, it saves on the run's market when ref-data lists it, otherwise on a market ref-data lists, the run's venue first.",
"type": "string"
},
"source_run_index": {
"description": "The selected sweep row, including zero.",
"type": "integer"
},
"strategy_name": {
"description": "What to call it, in plain words a person reads -- the entry trigger's friendly_name from the knowledge graph, then the asset and timeframe, e.g. \"Upside Range Breakout - BTC 1h\". Never a code name such as btc_strategy or bb_upper_breakout.",
"type": "string"
}
},
"required": [
"asset",
"strategy_name"
],
"type": "object"
},
"name": "save_strategy",
"outputSchema": null
},
{
"description": "Rank several candidate strategies by how likely each is to trade at all, before spending backtests on them. Give it one asset and up to 99 candidates, each {entry: [...], exit: [...]} with signals from the library -- the roles come from the library, so do not pass signal_type. IT PREDICTS WHETHER A STRATEGY WILL PLACE TRADES, AND NOTHING ABOUT WHETHER IT WILL MAKE MONEY: only a backtest answers that. Use it to choose which of many candidates to backtest first, never as a verdict on a single strategy -- a probability on its own says little, and the ranking is the answer. A HIGH score is real support for spending a backtest. A LOW score is weak evidence and is NOT a finding that the strategy will not trade: measured against runs that did trade, a 0.5 cutoff recovers under half of them. Never tell someone their strategy will not trade because this scored it low; back it and find out.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"asset": {
"description": "Asset symbol, e.g. BTC or ETH.",
"type": "string"
},
"candidates": {
"description": "Each {entry: [{name, params?, timeframe?}], exit: [...]}.",
"items": {
"type": "object"
},
"type": "array"
}
},
"required": [
"asset",
"candidates"
],
"type": "object"
},
"name": "screen_candidates",
"outputSchema": null
},
{
"description": "Screen the market for tokens that smart-money wallets are currently accumulating or distributing. Returns a ranked list of tokens with high smart-money activity across the specified chains. Use it when the user asks what smart money is currently buying, which tokens are being accumulated, or wants to discover high-conviction smart-money plays.\n\n[Access: pay 0.02 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"chains": {
"description": "Optional list of chains to include.",
"items": {
"type": "string"
},
"type": "array"
},
"limit": {
"default": 20,
"description": "Maximum results.",
"type": "integer"
},
"timeframe": {
"default": "24h",
"description": "Aggregation window, e.g. 24h, 7d.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "screen_smart_money",
"outputSchema": null
},
{
"description": "Search signal names, parameters or description keywords.",
"inputSchema": {
"properties": {
"category": {
"description": "Signal library module",
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum results",
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination offset",
"type": "integer"
},
"query": {
"description": "Search query string",
"type": "string"
},
"regime_direction": {
"description": "Market regime band",
"type": "string"
},
"role": {
"description": "Signal role",
"enum": [
"TRIGGER",
"FILTER"
],
"example": "TRIGGER",
"type": "string"
},
"search_type": {
"default": "keywords",
"description": "Type of search",
"enum": [
"name",
"params",
"keywords"
],
"example": "name",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_signals",
"outputSchema": null
},
{
"description": "How big a search would be, without creating anything. THIS IS THE NUMBER YOU SAY OUT LOUD, and it is almost never the number the person named: the draw count is PER WINDOW and Oracle keeps many windows per asset. Oracle counts it by walking exactly what the plan would walk, so nothing else can be trusted to work it out. Free, and repeatable -- call it after every change while the size is being settled, and only create the sweep once the person has agreed to a total. If it comes back capped, their plan scaled the search down and cap_applied says by how much.",
"inputSchema": {
"properties": {
"assets": {
"description": "Asset symbols, e.g. [\"BTC\", \"ETH\"].",
"items": {
"type": "string"
},
"type": "array"
},
"candidate_shape": {
"description": "How many parts a drawn strategy gets, any of n_entry_triggers, min_entry_filters, max_entry_filters, min_exit_triggers, max_exit_triggers, min_exit_filters, max_exit_filters. Omitted, the platform default shape.",
"type": "object"
},
"candle_sizes": {
"description": "Candle sizes, e.g. [\"1h\"]. Omitted, every size Oracle holds for those assets, which multiplies the windows.",
"items": {
"type": "string"
},
"type": "array"
},
"categories": {
"description": "Draw only from these signal classes, e.g. [\"momentum\"]. The classes are averaging, flow, momentum, oscillator, pattern and volatility. Omitted, the whole library.",
"items": {
"type": "string"
},
"type": "array"
},
"draws_per_dataset": {
"default": 100,
"description": "How many candidate strategies to draw PER WINDOW. The runs that execute are this multiplied by the number of windows.",
"type": "integer"
},
"entry_filters": {
"description": "Draw entry filters only from these. Omitted, every filter.",
"items": {
"type": "string"
},
"type": "array"
},
"entry_triggers": {
"description": "Draw the entry trigger only from these signals, named as the knowledge graph registers them. Omitted, every trigger.",
"items": {
"type": "string"
},
"type": "array"
},
"execution_base": {
"description": "Risk settings every run shares, from the execution config schema. Omitted, platform canon.",
"type": "object"
},
"execution_sweeps": {
"description": "Execution parameters to search too, each {param: {min, max, n}}. Every one of these multiplies the run count.",
"type": "object"
},
"exit_filters": {
"description": "Draw exit filters only from these.",
"items": {
"type": "string"
},
"type": "array"
},
"exit_triggers": {
"description": "Draw an exit trigger only from these. Omitted, no exit signal is drawn at all and runs exit on the risk settings.",
"items": {
"type": "string"
},
"type": "array"
},
"include_gapped": {
"default": false,
"description": "Include windows missing bars. Off by default, because a metric over a half-covered window is not comparable to one over a whole window.",
"type": "boolean"
},
"max_total_runs": {
"description": "A ceiling on the executed runs, applied by Oracle.",
"type": "integer"
},
"param_samples": {
"default": 3,
"description": "How many values each signal parameter contributes. The space is their product, so this is the dial that decides whether the search explores parameters at all; at 1 every candidate runs at a single setting.",
"type": "integer"
},
"pre_filter_threshold": {
"description": "Skip a drawn candidate the SIEVE model predicts will not trade at all, above this confidence. A will-it-trade gate and nothing about whether it will make money. Omitted, no skipping.",
"type": "number"
},
"regimes": {
"description": "Market conditions to keep: current, bear, neutral, bull. current means data within the last 30 days, which is recency and not direction. Omitted, every condition.",
"items": {
"type": "string"
},
"type": "array"
},
"signal_groups": {
"description": "Keep kinds of signal apart. A candidate draws ALL of its signals from ONE group, so two signals in different groups never appear on the same strategy. Runs are split across the groups.",
"items": {
"additionalProperties": false,
"properties": {
"categories": {
"description": "Signal classes whose members belong to it.",
"items": {
"type": "string"
},
"type": "array"
},
"exclude": {
"description": "Signal names removed from it.",
"items": {
"type": "string"
},
"type": "array"
},
"filters": {
"additionalProperties": false,
"description": "Select which group members may serve as filters. Role selections only narrow the parent membership; they cannot reassign a signal's role.",
"properties": {
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"exclude": {
"items": {
"type": "string"
},
"type": "array"
},
"include": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"include": {
"description": "Signal names forced in even when their class is not listed.",
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"description": "What to call the group.",
"type": "string"
},
"triggers": {
"additionalProperties": false,
"description": "Select which group members may serve as triggers.",
"properties": {
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"exclude": {
"items": {
"type": "string"
},
"type": "array"
},
"include": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"weight": {
"description": "Its share of the strategies drawn. Omitted on every group is an even split.",
"type": "number"
}
},
"required": [],
"type": "object"
},
"type": "array"
},
"windows": {
"description": "Specific window files to include whatever else is chosen.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [],
"type": "object"
},
"name": "size_sweep",
"outputSchema": null
},
{
"description": "Change a DRAFT strategy in place: its signals, their parameters, or a supported execution setting. Preserve explicit user choices; explain agent-selected adjustments and follow the composition workflow and execution-config contract. Pass the COMPLETE entry and exit signal lists when changing signals -- what you pass replaces what was stored, it is not merged, while constraints merge onto the stored execution config. Only a draft that has never been backtested can change: once a backtest has measured it, its rules are frozen so the results stay attached to the rules they ran, and a change means saving a NEW strategy with save_strategy. Use this to act on verify_strategy's warnings without creating a duplicate.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"constraints": {
"additionalProperties": true,
"description": "Supported execution overrides requested by the person or justified by the composition workflow after reading the execution-config contract. Preserve explicit user choices and explain agent-selected adjustments. Each supplied value is kept exactly as given rather than nudged.",
"properties": {
"atr_cap_multiplier": {
"description": "SUPERSEDED by volatility_tolerance. Bounded the weighted blend at this multiple of the SHORT ATR.",
"x-mangrove-authoring-schema": {
"description": "SUPERSEDED by volatility_tolerance. Bounded the weighted blend at this multiple of the SHORT ATR.",
"minimum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy this is what made the weight pair inert past a long weight of roughly 6-12% (#1052).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
}
},
"atr_long_weight": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the daily ATR in the weighted-blend stop model, and always 1 - atr_short_weight rather than independent.",
"x-mangrove-authoring-schema": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the daily ATR in the weighted-blend stop model, and always 1 - atr_short_weight rather than independent.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. Derived, never independently effective.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
}
},
"atr_period": {
"description": "ATR lookback in bars (default 14) used to measure volatility for stop sizing.",
"x-mangrove-authoring-schema": {
"default": 14,
"description": "ATR lookback in bars (default 14) used to measure volatility for stop sizing.",
"maximum": 1000,
"minimum": 5,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher smooths the volatility estimate (steadier, slower-reacting stops). Lower reacts faster to recent volatility (choppier stops).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"atr_short_weight": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the signal-timeframe ATR in the weighted-blend stop model. Readable on a strategy created under that model; refused on any write.",
"x-mangrove-authoring-schema": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the signal-timeframe ATR in the weighted-blend stop model. Readable on a strategy created under that model; refused on any write.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy, higher favours the signal timeframe's own volatility -- though the cap made settings past a few percent of long weight indistinguishable (#1052).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
}
},
"atr_volatility_factor": {
"description": "SUPERSEDED by volatility_tolerance. Multiplied the blended ATR to give the stop distance. The dial's two endpoint factors carry this instead, one at each end of the width.",
"x-mangrove-authoring-schema": {
"description": "SUPERSEDED by volatility_tolerance. Multiplied the blended ATR to give the stop distance. The dial's two endpoint factors carry this instead, one at each end of the width.",
"exclusiveMinimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy, higher widens the stop and shrinks the position for the same risk.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
}
},
"circuit_breaker": {
"description": "Parameters for cooldown_model 'trades': pause on consecutive net losses or accumulated loss amount, pause on marked drawdown from the peak (including unrealized changes), resume new alpha positions at a reduced size, and stop after consecutive pauses. Canon defaults are 36 primary bars for a loss pause, 72 for a drawdown pause, and three strikes for a permanent halt. Pause counts are clamped to 24 hours through 14 days by default. max_drawdown_halt_limit separately stops entries on realized loss of cumulative gross deposits. Existing exits remain active during holds.",
"x-mangrove-authoring-schema": {
"additionalProperties": false,
"default": {
"consecutive_loss_limit": 2,
"drawdown_pause_bars": 72,
"loss_amount_pct": 0.06,
"max_consecutive_pauses": 3,
"pause_bars": 36,
"pause_max_days": 14,
"pause_min_hours": 24,
"resume_size_fraction": 0.5,
"resume_trades": 3
},
"description": "Parameters for cooldown_model 'trades': pause on consecutive net losses or accumulated loss amount, pause on marked drawdown from the peak (including unrealized changes), resume new alpha positions at a reduced size, and stop after consecutive pauses. Canon defaults are 36 primary bars for a loss pause, 72 for a drawdown pause, and three strikes for a permanent halt. Pause counts are clamped to 24 hours through 14 days by default. max_drawdown_halt_limit separately stops entries on realized loss of cumulative gross deposits. Existing exits remain active during holds.",
"properties": {
"consecutive_loss_limit": {
"default": 2,
"description": "Consecutive losing closes on an asset that start a pause. A winning close resets the count.",
"maximum": 100,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Lower pauses sooner after a losing run; higher tolerates longer runs.",
"x-mangrove-status": "tunable"
},
"drawdown_pause_bars": {
"default": 72,
"description": "Primary-timeframe bars denying entries after a drawdown pause (canon default 72). At drawdown-pause expiry the peak re-baselines to current account value. An alpha resume window opens only once no pause remains and no permanent halt is latched. The count is raised to cover pause_min_hours and lowered to fit pause_max_days (24 hours through 14 days by default).",
"maximum": 8760,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Longer holds the pause longer before trading can resume.",
"x-mangrove-status": "tunable"
},
"loss_amount_pct": {
"default": 0.06,
"description": "Accumulated net losses as a fraction of the closed-equity reset baseline that start a loss pause. A winning close clears the accumulation and resets the baseline. An asset loss pause clears it at the start and re-baselines at expiry; a global drawdown pause does not itself reset it.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number",
"x-mangrove-effect": "Lower pauses after smaller cumulative losses; higher tolerates larger ones.",
"x-mangrove-status": "tunable"
},
"max_consecutive_pauses": {
"default": 3,
"description": "Strikes that stop the strategy until a manual restart. A strike is one pause started, of any kind (consecutive losses, loss amount, drawdown, a resume window that lost money). Strikes reset to 0 only on a new equity high: a close that leaves closed equity above the high-water mark the strategy had when the first strike of the run was recorded. A winning close below that mark does not reset them, and a deposit or withdrawal does not count as a high.",
"maximum": 100,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Lower stops the strategy sooner; higher tolerates more repeated pauses.",
"x-mangrove-status": "tunable"
},
"pause_bars": {
"default": 36,
"description": "Primary-timeframe bars denying entries after a loss pause (canon default 36). The count is raised to cover pause_min_hours and lowered to fit pause_max_days on that timeframe (24 hours through 14 days by default).",
"maximum": 8760,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Longer sits out more of a bad regime; shorter resumes sooner.",
"x-mangrove-status": "tunable"
},
"pause_max_days": {
"default": 14,
"description": "A pause lasts at most this many days on every timeframe: the bar count is lowered to fit it.",
"exclusiveMinimum": 0,
"maximum": 365,
"type": "number",
"x-mangrove-effect": "Lower ends every pause sooner on long timeframes; higher leaves the bar count to decide.",
"x-mangrove-status": "tunable"
},
"pause_min_hours": {
"default": 24,
"description": "A pause lasts at least this many hours on every timeframe: the bar count of pause_bars or drawdown_pause_bars is raised to cover it.",
"exclusiveMinimum": 0,
"maximum": 336,
"type": "number",
"x-mangrove-effect": "Higher makes every pause at least that long on short timeframes; lower leaves the bar count to decide.",
"x-mangrove-status": "tunable"
},
"resume_size_fraction": {
"default": 0.5,
"description": "Fraction of normal size for new alpha positions while a resume window is open (canon default 0.5). Eligible confirmed position closes count toward resume_trades; a negative net result starts another loss pause and strike, while zero or a profit restores full alpha size. Core orders keep their normal allocation quantities after pause expiry: they are not positions and do not consume resume-trade counts. 1.0 disables the alpha size reduction.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number",
"x-mangrove-effect": "Lower risks less while the strategy proves itself again after a pause; higher resumes closer to full size.",
"x-mangrove-status": "tunable"
},
"resume_trades": {
"default": 3,
"description": "Eligible confirmed position closes booked in a resume window (canon default three). When the window completes, a negative net realized result starts a new loss pause and strike; zero or a profit restores full alpha size. A pause cancels the active window; a new one opens only once no pause remains and no permanent halt is latched. Core orders do not count as position closes.",
"maximum": 50,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Higher judges the resumed strategy over more trades before full size returns; lower decides sooner.",
"x-mangrove-status": "tunable"
}
},
"type": [
"object",
"null"
],
"x-mangrove-effect": "Tighter limits pause and stop sooner; looser limits keep trading through losing runs.",
"x-mangrove-status": "guardrail"
}
},
"cooldown_model": {
"description": "Loss-streak breaker model. 'bars' counts losing closes inside rolling windows of the primary timeframe (cooldown_config). 'trades' counts consecutive losing closes and realized loss amount, pauses for circuit_breaker bars of the primary timeframe (at least pause_min_hours and at most pause_max_days), and stops after repeated pauses (circuit_breaker). An absent model adopts the canonical 'trades' defaults; explicit 'bars' retains the legacy model.",
"x-mangrove-authoring-schema": {
"default": "trades",
"description": "Loss-streak breaker model. 'bars' counts losing closes inside rolling windows of the primary timeframe (cooldown_config). 'trades' counts consecutive losing closes and realized loss amount, pauses for circuit_breaker bars of the primary timeframe (at least pause_min_hours and at most pause_max_days), and stops after repeated pauses (circuit_breaker). An absent model adopts the canonical 'trades' defaults; explicit 'bars' retains the legacy model.",
"enum": [
"bars",
"trades",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "'trades' trips on trade count and loss size regardless of how far apart trades are spaced; 'bars' trips only when losses land inside the window. cooldown_config, cooldown_bars, daily_momentum_limit and weekly_momentum_limit are read only under 'bars': they are left out of a resolved config under 'trades', and a config that carries them under 'trades' has them dropped.",
"x-mangrove-status": "guardrail"
}
},
"enable_volatility_adjustment": {
"description": "Toggles volatility-based position scaling (default false).",
"x-mangrove-authoring-schema": {
"default": false,
"description": "Toggles volatility-based position scaling (default false).",
"type": [
"boolean",
"null"
],
"x-mangrove-effect": "When true, positions are scaled down by target_volatility / (atr/entry) if ATR%% exceeds target; only reduces size, never increases.",
"x-mangrove-status": "gated"
}
},
"exit_on_loss_after_bars": {
"description": "Exit a losing position after this many bars.",
"x-mangrove-authoring-schema": {
"default": 1000,
"description": "Exit a losing position after this many bars.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower cuts losers sooner; higher gives them more time to recover.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"exit_on_profit_after_bars": {
"description": "Exit a winning position after this many bars.",
"x-mangrove-authoring-schema": {
"default": 1000,
"description": "Exit a winning position after this many bars.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower banks winners sooner; higher lets them run.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"initial_balance": {
"description": "Starting balance for the backtest/simulation (default $10,000).",
"x-mangrove-authoring-schema": {
"default": 10000,
"description": "Starting balance for the backtest/simulation (default $10,000).",
"maximum": 1000000000,
"minimum": 25,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Scales absolute dollar figures; not a strategy-character knob.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_drawdown_halt_limit": {
"description": "Permanent capital-floor entry halt (0.20 = 20%). Closed, realized equity is compared with cumulative gross deposits (execution_state.cumulative_deposits), not a rolling peak or the signed net-funding balance; withdrawals do not reduce this reference. Legacy requests without cumulative_deposits use execution_config.initial_balance. The shared live/paper evaluator checks before each bar and latches execution_state.halt. New alpha entries and v3 core allocations are denied, while authoritative positions retain protective exits and exits_pending until physically flat. Engine-owned strategies become inactive only after that book is flat; caller-owned executors retain their exit monitor. An explicit manual restart is required to clear the latch. Backtests enforce the same floor when evaluate_bar receives enforce_capital_floor=True, managing open-position exits through the final bar. Applies to both cooldown models; null disables new floor trips, while an existing halt remains latched.",
"x-mangrove-authoring-schema": {
"default": 0.2,
"description": "Permanent capital-floor entry halt (0.20 = 20%). Closed, realized equity is compared with cumulative gross deposits (execution_state.cumulative_deposits), not a rolling peak or the signed net-funding balance; withdrawals do not reduce this reference. Legacy requests without cumulative_deposits use execution_config.initial_balance. The shared live/paper evaluator checks before each bar and latches execution_state.halt. New alpha entries and v3 core allocations are denied, while authoritative positions retain protective exits and exits_pending until physically flat. Engine-owned strategies become inactive only after that book is flat; caller-owned executors retain their exit monitor. An explicit manual restart is required to clear the latch. Backtests enforce the same floor when evaluate_bar receives enforce_capital_floor=True, managing open-position exits through the final bar. Applies to both cooldown models; null disables new floor trips, while an existing halt remains latched.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Lower protects more of gross deposited capital before a permanent entry halt; higher tolerates a deeper realized loss. This does not resize positions or stop protective exit evaluation. Do not add a separate floor where the shared evaluator enforces it.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_drawdown_limit": {
"description": "Peak-relative entry pause (0.20 = 20%). The canonical 'trades' model measures marked equity against its high-water mark. A breach starts one drawdown pause and strike; circuit_breaker.drawdown_pause_bars defaults to 72 primary bars, clamped to pause_min_hours and pause_max_days (24 hours and 14 days by default). At drawdown-pause expiry the peak re-baselines; a reduced-size alpha resume window opens only once no pause remains and no permanent halt is latched. Explicit 'bars' retains the legacy closed-equity measurement and per-timeframe long cooldown. Both models deny new entries while allowing existing positions to exit; automatic v3 core allocations honor the hold too. null disables new drawdown trips.",
"x-mangrove-authoring-schema": {
"default": 0.2,
"description": "Peak-relative entry pause (0.20 = 20%). The canonical 'trades' model measures marked equity against its high-water mark. A breach starts one drawdown pause and strike; circuit_breaker.drawdown_pause_bars defaults to 72 primary bars, clamped to pause_min_hours and pause_max_days (24 hours and 14 days by default). At drawdown-pause expiry the peak re-baselines; a reduced-size alpha resume window opens only once no pause remains and no permanent halt is latched. Explicit 'bars' retains the legacy closed-equity measurement and per-timeframe long cooldown. Both models deny new entries while allowing existing positions to exit; automatic v3 core allocations honor the hold too. null disables new drawdown trips.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Lower pauses entries after a smaller drawdown; higher tolerates a deeper drawdown. The shared entry breaker enforces this in single/bulk live and paper evaluation, v3 core allocation and backtests built with risk_manager_from_execution_config. Alpha resume sizing is a separate control; do not add a second drawdown stop.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_hold_bars": {
"description": "Maximum bars to hold any position before a forced exit.",
"x-mangrove-authoring-schema": {
"default": 1000,
"description": "Maximum bars to hold any position before a forced exit.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher lets trades run longer; lower forces earlier time-based exits.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"max_hold_time_hours": {
"description": "Maximum position hold time in hours (null = no limit).",
"x-mangrove-authoring-schema": {
"default": null,
"description": "Maximum position hold time in hours (null = no limit).",
"exclusiveMinimum": 1,
"maximum": 8760,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower forces earlier time-based exits; null/higher lets trades run indefinitely on time.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"max_open_positions": {
"description": "Maximum concurrent open positions.",
"x-mangrove-authoring-schema": {
"default": 10,
"description": "Maximum concurrent open positions.",
"maximum": 1000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher allows more simultaneous exposure (more diversification but more aggregate risk); lower is more selective with less aggregate exposure.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"max_risk_per_trade": {
"description": "Fraction of account equity risked per trade (0.01 = 1%). Position size is derived from this and the stop distance.",
"x-mangrove-authoring-schema": {
"default": 0.01,
"description": "Fraction of account equity risked per trade (0.01 = 1%). Position size is derived from this and the stop distance.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher risks more per trade: bigger positions, larger gains AND larger drawdowns. Lower is more conservative: smaller positions, smaller swings.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"max_trade_amount": {
"description": "Absolute cap on dollar size per trade.",
"x-mangrove-authoring-schema": {
"default": 10000000,
"description": "Absolute cap on dollar size per trade.",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Size guardrail; rarely binding.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_trades_per_day": {
"description": "Daily trade cap.",
"x-mangrove-authoring-schema": {
"default": 50,
"description": "Daily trade cap.",
"maximum": 1440,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher permits more churn; lower throttles activity.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"max_units_per_trade": {
"description": "Absolute cap on units per trade.",
"x-mangrove-authoring-schema": {
"default": 1000000,
"description": "Absolute cap on units per trade.",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Size guardrail; rarely binding.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"min_asset_balance": {
"description": "position_size_calc 'v3' only. Minimum asset balance, in asset units, the strategy holds outside open trades.",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Minimum asset balance, in asset units, the strategy holds outside open trades.",
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more of the asset out of reach of sell trades and core sells, and takes more cash to reach; lower frees more of the asset for trading.",
"x-mangrove-status": "guardrail"
}
},
"min_balance_days": {
"description": "position_size_calc 'v3' only. Number of equal daily orders used to bring a side up to its minimum balance.",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Number of equal daily orders used to bring a side up to its minimum balance.",
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher spreads the minimum-balance orders over more days at smaller size; lower reaches the minimum sooner with larger orders.",
"x-mangrove-status": "guardrail"
}
},
"min_balance_threshold": {
"description": "Cash reserve fraction held back from new entries (0.1 = 10%). v1 reserves this fraction of cash; v2 reserves this fraction of account value (cash + open positions at market). An entry may only use cash above the reserve; when no cash is deployable the entry is denied (insufficient_cash / insufficient_cash_v2_account_reserve). It never halts the strategy and never closes positions.",
"x-mangrove-authoring-schema": {
"default": 0.1,
"description": "Cash reserve fraction held back from new entries (0.1 = 10%). v1 reserves this fraction of cash; v2 reserves this fraction of account value (cash + open positions at market). An entry may only use cash above the reserve; when no cash is deployable the entry is denied (insufficient_cash / insufficient_cash_v2_account_reserve). It never halts the strategy and never closes positions.",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more cash idle and makes entries smaller or rarer as the account shrinks; lower lets entries use more of the balance. Not a drawdown stop; see max_drawdown_limit and max_drawdown_halt_limit.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"min_cash_balance": {
"description": "position_size_calc 'v3' only. Minimum cash balance the strategy holds after the worst-case loss of every open trade.",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Minimum cash balance the strategy holds after the worst-case loss of every open trade.",
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more cash out of reach of buy trades and core buys, so entries are smaller or rarer; lower frees more cash for trading.",
"x-mangrove-status": "guardrail"
}
},
"min_stop_distance_pct": {
"description": "Hard floor on stop distance as a fraction of entry price (crypto minimum), applied after ATR sizing.",
"x-mangrove-authoring-schema": {
"default": 0.005,
"description": "Hard floor on stop distance as a fraction of entry price (crypto minimum), applied after ATR sizing.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher enforces a wider minimum stop; lower allows tighter stops down to the floor.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"min_trade_amount": {
"description": "Minimum trade size in dollars; smaller intended trades are skipped.",
"x-mangrove-authoring-schema": {
"default": 25,
"description": "Minimum trade size in dollars; smaller intended trades are skipped.",
"maximum": 1000000,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher skips more small signals; lower allows smaller trades.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
}
},
"position_size_calc": {
"description": "Sizing-engine version ('v1', 'v2' or 'v3'). Pinned at creation and immutable. 'v3' holds an asset balance and a cash balance, sizes against equity net of open risk, and requires the position_size_calc 'v3' parameters.",
"x-mangrove-authoring-schema": {
"default": "v2",
"description": "Sizing-engine version ('v1', 'v2' or 'v3'). Pinned at creation and immutable. 'v3' holds an asset balance and a cash balance, sizes against equity net of open risk, and requires the position_size_calc 'v3' parameters.",
"enum": [
"v1",
"v2",
"v3",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "Not a magnitude knob; selects the sizing algorithm. Do not change on an existing strategy.",
"x-mangrove-status": "guardrail"
}
},
"profit_threshold_pct": {
"description": "Profit threshold (5%% default) above which a position counts as 'winning' for the time-based exit logic.",
"x-mangrove-authoring-schema": {
"default": 0.05,
"description": "Profit threshold (5%% default) above which a position counts as 'winning' for the time-based exit logic.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher requires a larger gain before a position is treated as winning; lower treats smaller gains as wins.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"rebalance_band": {
"description": "position_size_calc 'v3' only. Absolute deviation of the asset weight from target_asset_weight that triggers a rebalance order (0.05 = 5 points).",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Absolute deviation of the asset weight from target_asset_weight that triggers a rebalance order (0.05 = 5 points).",
"exclusiveMaximum": 1,
"exclusiveMinimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher lets the split drift further before a rebalance order, so fewer core orders; lower holds the split closer to target with more core orders and more fees.",
"x-mangrove-status": "tunable"
}
},
"reward_factor": {
"description": "Risk/reward target. Take-profit distance = reward_factor * stop_distance.",
"x-mangrove-authoring-schema": {
"default": 2,
"description": "Risk/reward target. Take-profit distance = reward_factor * stop_distance.",
"exclusiveMinimum": 0,
"maximum": 100,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher sets a wider profit target: lower win rate but bigger wins. Lower sets a tighter target: higher win rate but smaller wins.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"stop_gap_allowance": {
"description": "position_size_calc 'v3' only. Fraction of the stop price a stop fill is assumed to miss by when computing the worst-case loss of a trade (0.01 = 1%).",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Fraction of the stop price a stop fill is assumed to miss by when computing the worst-case loss of a trade (0.01 = 1%).",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher counts more risk per open trade, leaving less available cash and smaller positions; lower counts less.",
"x-mangrove-status": "guardrail"
}
},
"stop_model": {
"description": "Which stop model the strategy uses: 'atr_width_dial' (one parameter, volatility_tolerance, positioned on the ATR width) or 'weighted_atr' (superseded: a weighted blend of two ATRs, capped). Pinned at creation and immutable.",
"x-mangrove-authoring-schema": {
"default": "atr_width_dial",
"description": "Which stop model the strategy uses: 'atr_width_dial' (one parameter, volatility_tolerance, positioned on the ATR width) or 'weighted_atr' (superseded: a weighted blend of two ATRs, capped). Pinned at creation and immutable.",
"enum": [
"atr_width_dial",
"weighted_atr",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "Not a magnitude knob; selects the stop algorithm. Do not change on an existing strategy -- it would move every stop the strategy takes.",
"x-mangrove-status": "guardrail"
}
},
"taker_fee_rate": {
"description": "position_size_calc 'v3' only. Venue fee per fill as a fraction of notional, charged in cash (0.004 = 0.4%).",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Venue fee per fill as a fraction of notional, charged in cash (0.004 = 0.4%).",
"exclusiveMaximum": 0.1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher counts more cost per fill, raising the risk of each trade and lowering available cash. Models the venue; not a strategy-character knob.",
"x-mangrove-status": "guardrail"
}
},
"target_asset_weight": {
"description": "position_size_calc 'v3' only. Target share of core value held in the asset (0.8 = 80% asset, 20% cash; 0 = all cash).",
"x-mangrove-authoring-schema": {
"description": "position_size_calc 'v3' only. Target share of core value held in the asset (0.8 = 80% asset, 20% cash; 0 = all cash).",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher holds more of the asset and less cash; lower holds more cash. The daily core order moves the split back to this value once it drifts past rebalance_band. At 0 with no asset held, no core order is placed and only buy trades can pass.",
"x-mangrove-status": "tunable"
}
},
"target_volatility": {
"description": "Target volatility (0.10 = 10%). ONLY active when enable_volatility_adjustment is true (default false). When active, scales position size down if ATR%% of entry exceeds the target (never up).",
"x-mangrove-authoring-schema": {
"default": 0.1,
"description": "Target volatility (0.10 = 10%). ONLY active when enable_volatility_adjustment is true (default false). When active, scales position size down if ATR%% of entry exceeds the target (never up).",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "With the gate off (the default), changing this has no effect. With it on, lower scales positions down more aggressively in high volatility.",
"x-mangrove-gate-field": "enable_volatility_adjustment",
"x-mangrove-gate-required": true,
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "gated"
}
},
"volatility_mode": {
"description": "Unused (retained for backward compatibility). Volatility is derived from ATR.",
"x-mangrove-authoring-schema": {
"default": "stddev",
"description": "Unused (retained for backward compatibility). Volatility is derived from ATR.",
"enum": [
"stddev",
"atr",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "No runtime effect. Do not tune.",
"x-mangrove-status": "unused"
}
},
"volatility_tolerance": {
"description": "Where on the ATR width the stop is taken, as the ATR_long-vs-ATR_short contribution ratio: 0 is all short end (0.5x the signal timeframe's ATR), 1 is all long end (2x the daily ATR). Interpolated geometrically, so the value is exactly the long end's share of log(stop) and each 0.1 is the same multiplicative step. Replaces atr_short_weight, atr_long_weight and atr_cap_multiplier.",
"x-mangrove-authoring-schema": {
"default": 0.5,
"description": "Where on the ATR width the stop is taken, as the ATR_long-vs-ATR_short contribution ratio: 0 is all short end (0.5x the signal timeframe's ATR), 1 is all long end (2x the daily ATR). Interpolated geometrically, so the value is exactly the long end's share of log(stop) and each 0.1 is the same multiplicative step. Replaces atr_short_weight, atr_long_weight and atr_cap_multiplier.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher widens the stop, and because position size is the risk budget divided by the stop distance, exposure shrinks in exact inverse proportion at the SAME risk. Low means many units with little room to be wrong and frequent stop-outs; high means few units that are hard to shake out but need a much larger move to reach the same reward. Both risk max_risk_per_trade.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
}
},
"volatility_window": {
"description": "Unused (retained for backward compatibility). ATR windowing is controlled by atr_period.",
"x-mangrove-authoring-schema": {
"default": 24,
"description": "Unused (retained for backward compatibility). ATR windowing is controlled by atr_period.",
"maximum": 1000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "No runtime effect. Do not tune.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "unused"
}
}
},
"type": "object",
"x-mangrove-authoring-schema": {
"$id": "urn:mangrove:execution-config:1",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": true,
"description": "Canonical authoring representation derived from server metadata and defaults. Top-level optional keys may be omitted or null. The existing HTTP validator separately coerces top-level numeric strings, enforces their declared bounds and permits unknown/legacy fields; it does not enforce this whole nested schema. Runtime strategy/version/timeframe checks remain authoritative. Cooldown durations may be omitted by legacy configs and then fall back to their corresponding windows.",
"properties": {
"atr_cap_multiplier": {
"description": "SUPERSEDED by volatility_tolerance. Bounded the weighted blend at this multiple of the SHORT ATR.",
"minimum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy this is what made the weight pair inert past a long weight of roughly 6-12% (#1052).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
},
"atr_long_weight": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the daily ATR in the weighted-blend stop model, and always 1 - atr_short_weight rather than independent.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. Derived, never independently effective.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
},
"atr_period": {
"default": 14,
"description": "ATR lookback in bars (default 14) used to measure volatility for stop sizing.",
"maximum": 1000,
"minimum": 5,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher smooths the volatility estimate (steadier, slower-reacting stops). Lower reacts faster to recent volatility (choppier stops).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"atr_short_weight": {
"description": "SUPERSEDED by volatility_tolerance. Weight of the signal-timeframe ATR in the weighted-blend stop model. Readable on a strategy created under that model; refused on any write.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy, higher favours the signal timeframe's own volatility -- though the cap made settings past a few percent of long weight indistinguishable (#1052).",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
},
"atr_volatility_factor": {
"description": "SUPERSEDED by volatility_tolerance. Multiplied the blended ATR to give the stop distance. The dial's two endpoint factors carry this instead, one at each end of the width.",
"exclusiveMinimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "None on a strategy using atr_width_dial. On a weighted_atr strategy, higher widens the stop and shrinks the position for the same risk.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "superseded",
"x-mangrove-superseded-by": "volatility_tolerance"
},
"circuit_breaker": {
"additionalProperties": false,
"default": {
"consecutive_loss_limit": 2,
"drawdown_pause_bars": 72,
"loss_amount_pct": 0.06,
"max_consecutive_pauses": 3,
"pause_bars": 36,
"pause_max_days": 14,
"pause_min_hours": 24,
"resume_size_fraction": 0.5,
"resume_trades": 3
},
"description": "Parameters for cooldown_model 'trades': pause on consecutive net losses or accumulated loss amount, pause on marked drawdown from the peak (including unrealized changes), resume new alpha positions at a reduced size, and stop after consecutive pauses. Canon defaults are 36 primary bars for a loss pause, 72 for a drawdown pause, and three strikes for a permanent halt. Pause counts are clamped to 24 hours through 14 days by default. max_drawdown_halt_limit separately stops entries on realized loss of cumulative gross deposits. Existing exits remain active during holds.",
"properties": {
"consecutive_loss_limit": {
"default": 2,
"description": "Consecutive losing closes on an asset that start a pause. A winning close resets the count.",
"maximum": 100,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Lower pauses sooner after a losing run; higher tolerates longer runs.",
"x-mangrove-status": "tunable"
},
"drawdown_pause_bars": {
"default": 72,
"description": "Primary-timeframe bars denying entries after a drawdown pause (canon default 72). At drawdown-pause expiry the peak re-baselines to current account value. An alpha resume window opens only once no pause remains and no permanent halt is latched. The count is raised to cover pause_min_hours and lowered to fit pause_max_days (24 hours through 14 days by default).",
"maximum": 8760,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Longer holds the pause longer before trading can resume.",
"x-mangrove-status": "tunable"
},
"loss_amount_pct": {
"default": 0.06,
"description": "Accumulated net losses as a fraction of the closed-equity reset baseline that start a loss pause. A winning close clears the accumulation and resets the baseline. An asset loss pause clears it at the start and re-baselines at expiry; a global drawdown pause does not itself reset it.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number",
"x-mangrove-effect": "Lower pauses after smaller cumulative losses; higher tolerates larger ones.",
"x-mangrove-status": "tunable"
},
"max_consecutive_pauses": {
"default": 3,
"description": "Strikes that stop the strategy until a manual restart. A strike is one pause started, of any kind (consecutive losses, loss amount, drawdown, a resume window that lost money). Strikes reset to 0 only on a new equity high: a close that leaves closed equity above the high-water mark the strategy had when the first strike of the run was recorded. A winning close below that mark does not reset them, and a deposit or withdrawal does not count as a high.",
"maximum": 100,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Lower stops the strategy sooner; higher tolerates more repeated pauses.",
"x-mangrove-status": "tunable"
},
"pause_bars": {
"default": 36,
"description": "Primary-timeframe bars denying entries after a loss pause (canon default 36). The count is raised to cover pause_min_hours and lowered to fit pause_max_days on that timeframe (24 hours through 14 days by default).",
"maximum": 8760,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Longer sits out more of a bad regime; shorter resumes sooner.",
"x-mangrove-status": "tunable"
},
"pause_max_days": {
"default": 14,
"description": "A pause lasts at most this many days on every timeframe: the bar count is lowered to fit it.",
"exclusiveMinimum": 0,
"maximum": 365,
"type": "number",
"x-mangrove-effect": "Lower ends every pause sooner on long timeframes; higher leaves the bar count to decide.",
"x-mangrove-status": "tunable"
},
"pause_min_hours": {
"default": 24,
"description": "A pause lasts at least this many hours on every timeframe: the bar count of pause_bars or drawdown_pause_bars is raised to cover it.",
"exclusiveMinimum": 0,
"maximum": 336,
"type": "number",
"x-mangrove-effect": "Higher makes every pause at least that long on short timeframes; lower leaves the bar count to decide.",
"x-mangrove-status": "tunable"
},
"resume_size_fraction": {
"default": 0.5,
"description": "Fraction of normal size for new alpha positions while a resume window is open (canon default 0.5). Eligible confirmed position closes count toward resume_trades; a negative net result starts another loss pause and strike, while zero or a profit restores full alpha size. Core orders keep their normal allocation quantities after pause expiry: they are not positions and do not consume resume-trade counts. 1.0 disables the alpha size reduction.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": "number",
"x-mangrove-effect": "Lower risks less while the strategy proves itself again after a pause; higher resumes closer to full size.",
"x-mangrove-status": "tunable"
},
"resume_trades": {
"default": 3,
"description": "Eligible confirmed position closes booked in a resume window (canon default three). When the window completes, a negative net realized result starts a new loss pause and strike; zero or a profit restores full alpha size. A pause cancels the active window; a new one opens only once no pause remains and no permanent halt is latched. Core orders do not count as position closes.",
"maximum": 50,
"minimum": 1,
"type": "integer",
"x-mangrove-effect": "Higher judges the resumed strategy over more trades before full size returns; lower decides sooner.",
"x-mangrove-status": "tunable"
}
},
"type": [
"object",
"null"
],
"x-mangrove-effect": "Tighter limits pause and stop sooner; looser limits keep trading through losing runs.",
"x-mangrove-status": "guardrail"
},
"cooldown_model": {
"default": "trades",
"description": "Loss-streak breaker model. 'bars' counts losing closes inside rolling windows of the primary timeframe (cooldown_config). 'trades' counts consecutive losing closes and realized loss amount, pauses for circuit_breaker bars of the primary timeframe (at least pause_min_hours and at most pause_max_days), and stops after repeated pauses (circuit_breaker). An absent model adopts the canonical 'trades' defaults; explicit 'bars' retains the legacy model.",
"enum": [
"bars",
"trades",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "'trades' trips on trade count and loss size regardless of how far apart trades are spaced; 'bars' trips only when losses land inside the window. cooldown_config, cooldown_bars, daily_momentum_limit and weekly_momentum_limit are read only under 'bars': they are left out of a resolved config under 'trades', and a config that carries them under 'trades' has them dropped.",
"x-mangrove-status": "guardrail"
},
"enable_volatility_adjustment": {
"default": false,
"description": "Toggles volatility-based position scaling (default false).",
"type": [
"boolean",
"null"
],
"x-mangrove-effect": "When true, positions are scaled down by target_volatility / (atr/entry) if ATR%% exceeds target; only reduces size, never increases.",
"x-mangrove-status": "gated"
},
"exit_on_loss_after_bars": {
"default": 1000,
"description": "Exit a losing position after this many bars.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower cuts losers sooner; higher gives them more time to recover.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"exit_on_profit_after_bars": {
"default": 1000,
"description": "Exit a winning position after this many bars.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower banks winners sooner; higher lets them run.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"initial_balance": {
"default": 10000,
"description": "Starting balance for the backtest/simulation (default $10,000).",
"maximum": 1000000000,
"minimum": 25,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Scales absolute dollar figures; not a strategy-character knob.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_drawdown_halt_limit": {
"default": 0.2,
"description": "Permanent capital-floor entry halt (0.20 = 20%). Closed, realized equity is compared with cumulative gross deposits (execution_state.cumulative_deposits), not a rolling peak or the signed net-funding balance; withdrawals do not reduce this reference. Legacy requests without cumulative_deposits use execution_config.initial_balance. The shared live/paper evaluator checks before each bar and latches execution_state.halt. New alpha entries and v3 core allocations are denied, while authoritative positions retain protective exits and exits_pending until physically flat. Engine-owned strategies become inactive only after that book is flat; caller-owned executors retain their exit monitor. An explicit manual restart is required to clear the latch. Backtests enforce the same floor when evaluate_bar receives enforce_capital_floor=True, managing open-position exits through the final bar. Applies to both cooldown models; null disables new floor trips, while an existing halt remains latched.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Lower protects more of gross deposited capital before a permanent entry halt; higher tolerates a deeper realized loss. This does not resize positions or stop protective exit evaluation. Do not add a separate floor where the shared evaluator enforces it.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_drawdown_limit": {
"default": 0.2,
"description": "Peak-relative entry pause (0.20 = 20%). The canonical 'trades' model measures marked equity against its high-water mark. A breach starts one drawdown pause and strike; circuit_breaker.drawdown_pause_bars defaults to 72 primary bars, clamped to pause_min_hours and pause_max_days (24 hours and 14 days by default). At drawdown-pause expiry the peak re-baselines; a reduced-size alpha resume window opens only once no pause remains and no permanent halt is latched. Explicit 'bars' retains the legacy closed-equity measurement and per-timeframe long cooldown. Both models deny new entries while allowing existing positions to exit; automatic v3 core allocations honor the hold too. null disables new drawdown trips.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Lower pauses entries after a smaller drawdown; higher tolerates a deeper drawdown. The shared entry breaker enforces this in single/bulk live and paper evaluation, v3 core allocation and backtests built with risk_manager_from_execution_config. Alpha resume sizing is a separate control; do not add a second drawdown stop.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_hold_bars": {
"default": 1000,
"description": "Maximum bars to hold any position before a forced exit.",
"maximum": 10000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher lets trades run longer; lower forces earlier time-based exits.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"max_hold_time_hours": {
"default": null,
"description": "Maximum position hold time in hours (null = no limit).",
"exclusiveMinimum": 1,
"maximum": 8760,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Lower forces earlier time-based exits; null/higher lets trades run indefinitely on time.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"max_open_positions": {
"default": 10,
"description": "Maximum concurrent open positions.",
"maximum": 1000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher allows more simultaneous exposure (more diversification but more aggregate risk); lower is more selective with less aggregate exposure.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"max_risk_per_trade": {
"default": 0.01,
"description": "Fraction of account equity risked per trade (0.01 = 1%). Position size is derived from this and the stop distance.",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher risks more per trade: bigger positions, larger gains AND larger drawdowns. Lower is more conservative: smaller positions, smaller swings.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"max_trade_amount": {
"default": 10000000,
"description": "Absolute cap on dollar size per trade.",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Size guardrail; rarely binding.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_trades_per_day": {
"default": 50,
"description": "Daily trade cap.",
"maximum": 1440,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher permits more churn; lower throttles activity.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"max_units_per_trade": {
"default": 1000000,
"description": "Absolute cap on units per trade.",
"exclusiveMinimum": 0,
"maximum": 1000000000000,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Size guardrail; rarely binding.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"min_asset_balance": {
"description": "position_size_calc 'v3' only. Minimum asset balance, in asset units, the strategy holds outside open trades.",
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more of the asset out of reach of sell trades and core sells, and takes more cash to reach; lower frees more of the asset for trading.",
"x-mangrove-status": "guardrail"
},
"min_balance_days": {
"description": "position_size_calc 'v3' only. Number of equal daily orders used to bring a side up to its minimum balance.",
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "Higher spreads the minimum-balance orders over more days at smaller size; lower reaches the minimum sooner with larger orders.",
"x-mangrove-status": "guardrail"
},
"min_balance_threshold": {
"default": 0.1,
"description": "Cash reserve fraction held back from new entries (0.1 = 10%). v1 reserves this fraction of cash; v2 reserves this fraction of account value (cash + open positions at market). An entry may only use cash above the reserve; when no cash is deployable the entry is denied (insufficient_cash / insufficient_cash_v2_account_reserve). It never halts the strategy and never closes positions.",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more cash idle and makes entries smaller or rarer as the account shrinks; lower lets entries use more of the balance. Not a drawdown stop; see max_drawdown_limit and max_drawdown_halt_limit.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"min_cash_balance": {
"description": "position_size_calc 'v3' only. Minimum cash balance the strategy holds after the worst-case loss of every open trade.",
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher keeps more cash out of reach of buy trades and core buys, so entries are smaller or rarer; lower frees more cash for trading.",
"x-mangrove-status": "guardrail"
},
"min_stop_distance_pct": {
"default": 0.005,
"description": "Hard floor on stop distance as a fraction of entry price (crypto minimum), applied after ATR sizing.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher enforces a wider minimum stop; lower allows tighter stops down to the floor.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"min_trade_amount": {
"default": 25,
"description": "Minimum trade size in dollars; smaller intended trades are skipped.",
"maximum": 1000000,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher skips more small signals; lower allows smaller trades.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "guardrail"
},
"position_size_calc": {
"default": "v2",
"description": "Sizing-engine version ('v1', 'v2' or 'v3'). Pinned at creation and immutable. 'v3' holds an asset balance and a cash balance, sizes against equity net of open risk, and requires the position_size_calc 'v3' parameters.",
"enum": [
"v1",
"v2",
"v3",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "Not a magnitude knob; selects the sizing algorithm. Do not change on an existing strategy.",
"x-mangrove-status": "guardrail"
},
"profit_threshold_pct": {
"default": 0.05,
"description": "Profit threshold (5%% default) above which a position counts as 'winning' for the time-based exit logic.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher requires a larger gain before a position is treated as winning; lower treats smaller gains as wins.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"rebalance_band": {
"description": "position_size_calc 'v3' only. Absolute deviation of the asset weight from target_asset_weight that triggers a rebalance order (0.05 = 5 points).",
"exclusiveMaximum": 1,
"exclusiveMinimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher lets the split drift further before a rebalance order, so fewer core orders; lower holds the split closer to target with more core orders and more fees.",
"x-mangrove-status": "tunable"
},
"reward_factor": {
"default": 2,
"description": "Risk/reward target. Take-profit distance = reward_factor * stop_distance.",
"exclusiveMinimum": 0,
"maximum": 100,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher sets a wider profit target: lower win rate but bigger wins. Lower sets a tighter target: higher win rate but smaller wins.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"stop_gap_allowance": {
"description": "position_size_calc 'v3' only. Fraction of the stop price a stop fill is assumed to miss by when computing the worst-case loss of a trade (0.01 = 1%).",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher counts more risk per open trade, leaving less available cash and smaller positions; lower counts less.",
"x-mangrove-status": "guardrail"
},
"stop_model": {
"default": "atr_width_dial",
"description": "Which stop model the strategy uses: 'atr_width_dial' (one parameter, volatility_tolerance, positioned on the ATR width) or 'weighted_atr' (superseded: a weighted blend of two ATRs, capped). Pinned at creation and immutable.",
"enum": [
"atr_width_dial",
"weighted_atr",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "Not a magnitude knob; selects the stop algorithm. Do not change on an existing strategy -- it would move every stop the strategy takes.",
"x-mangrove-status": "guardrail"
},
"taker_fee_rate": {
"description": "position_size_calc 'v3' only. Venue fee per fill as a fraction of notional, charged in cash (0.004 = 0.4%).",
"exclusiveMaximum": 0.1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher counts more cost per fill, raising the risk of each trade and lowering available cash. Models the venue; not a strategy-character knob.",
"x-mangrove-status": "guardrail"
},
"target_asset_weight": {
"description": "position_size_calc 'v3' only. Target share of core value held in the asset (0.8 = 80% asset, 20% cash; 0 = all cash).",
"exclusiveMaximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher holds more of the asset and less cash; lower holds more cash. The daily core order moves the split back to this value once it drifts past rebalance_band. At 0 with no asset held, no core order is placed and only buy trades can pass.",
"x-mangrove-status": "tunable"
},
"target_volatility": {
"default": 0.1,
"description": "Target volatility (0.10 = 10%). ONLY active when enable_volatility_adjustment is true (default false). When active, scales position size down if ATR%% of entry exceeds the target (never up).",
"exclusiveMinimum": 0,
"maximum": 1,
"type": [
"number",
"null"
],
"x-mangrove-effect": "With the gate off (the default), changing this has no effect. With it on, lower scales positions down more aggressively in high volatility.",
"x-mangrove-gate-field": "enable_volatility_adjustment",
"x-mangrove-gate-required": true,
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "gated"
},
"volatility_mode": {
"default": "stddev",
"description": "Unused (retained for backward compatibility). Volatility is derived from ATR.",
"enum": [
"stddev",
"atr",
null
],
"type": [
"string",
"null"
],
"x-mangrove-effect": "No runtime effect. Do not tune.",
"x-mangrove-status": "unused"
},
"volatility_tolerance": {
"default": 0.5,
"description": "Where on the ATR width the stop is taken, as the ATR_long-vs-ATR_short contribution ratio: 0 is all short end (0.5x the signal timeframe's ATR), 1 is all long end (2x the daily ATR). Interpolated geometrically, so the value is exactly the long end's share of log(stop) and each 0.1 is the same multiplicative step. Replaces atr_short_weight, atr_long_weight and atr_cap_multiplier.",
"maximum": 1,
"minimum": 0,
"type": [
"number",
"null"
],
"x-mangrove-effect": "Higher widens the stop, and because position size is the risk budget divided by the stop distance, exposure shrinks in exact inverse proportion at the SAME risk. Low means many units with little room to be wrong and frequent stop-outs; high means few units that are hard to shake out but need a much larger move to reach the same reward. Both risk max_risk_per_trade.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "tunable"
},
"volatility_window": {
"default": 24,
"description": "Unused (retained for backward compatibility). ATR windowing is controlled by atr_period.",
"maximum": 1000,
"minimum": 1,
"type": [
"integer",
"null"
],
"x-mangrove-effect": "No runtime effect. Do not tune.",
"x-mangrove-input-coercion": "Top-level validate_execution_config accepts finite numeric strings; integer fields require whole values. Version-specific checks remain separate.",
"x-mangrove-status": "unused"
}
},
"title": "Execution configuration",
"type": "object",
"x-mangrove-boundary-validation": "top-level numeric bounds after legacy coercion; null means unset"
}
},
"entry_signals": {
"description": "The signals that open a position. Exactly one must be a TRIGGER in the knowledge graph; the rest are FILTERs.",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "The signal's name, exactly as the knowledge graph has it.",
"type": "string"
},
"params": {
"description": "Its parameters and the value chosen for each, keyed by parameter name -- the shape `query_knowledge op=get` shows them in. A parameter left out takes the signal's own default, which is a choice nobody made. A name the signal does not take, or a value outside its declared range, is refused.",
"type": "object"
},
"timeframe": {
"description": "The candle size this signal runs on.",
"enum": [
"5m",
"15m",
"30m",
"1h",
"4h",
"1D"
],
"type": "string"
}
},
"required": [
"name",
"timeframe"
],
"type": "object"
},
"type": "array"
},
"exit_signals": {
"description": "The signals that close one, same shape. A strategy may have none, and then it exits on risk rules alone.",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "The signal's name, exactly as the knowledge graph has it.",
"type": "string"
},
"params": {
"description": "Its parameters and the value chosen for each, keyed by parameter name -- the shape `query_knowledge op=get` shows them in. A parameter left out takes the signal's own default, which is a choice nobody made. A name the signal does not take, or a value outside its declared range, is refused.",
"type": "object"
},
"timeframe": {
"description": "The candle size this signal runs on.",
"enum": [
"5m",
"15m",
"30m",
"1h",
"4h",
"1D"
],
"type": "string"
}
},
"required": [
"name",
"timeframe"
],
"type": "object"
},
"type": "array"
},
"regime_direction": {
"description": "The direction band from get_market_regime, e.g. bear. The signal searches filter by it and find_sweep_runs marks each row's regime_fit with it; save_strategy and update_strategy read the current band themselves, so their check runs without it.",
"type": "string"
},
"regime_override": {
"default": false,
"description": "Save anyway when the regime check refuses. Only ever on the person's explicit say-so, after they have been told why.",
"type": "boolean"
},
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
},
"strategy_name": {
"description": "What to call it, in plain words a person reads -- the entry trigger's friendly_name from the knowledge graph, then the asset and timeframe, e.g. \"Upside Range Breakout - BTC 1h\". Never a code name such as btc_strategy or bb_upper_breakout.",
"type": "string"
}
},
"required": [
"strategy_id"
],
"type": "object"
},
"name": "update_strategy",
"outputSchema": null
},
{
"description": "Validate parameters for a signal.\n\n[Access: pay 0.001 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"parameters": {
"default": {},
"type": "object"
},
"signal_name": {
"description": "Signal name",
"type": "string"
}
},
"required": [
"signal_name"
],
"type": "object"
},
"name": "validate_signal_params",
"outputSchema": null
},
{
"description": "Check a saved strategy against everything that has to be true for it to run: the signal names and their parameter keys, the roles composing, a timeframe on every signal, and a timeframe on the strategy. Call it after saving and BEFORE backtesting -- a backtest spends the person's allowance the moment it is submitted, whether or not it runs, and these are the faults that make it fail at setup with nothing measured. It reads what is STORED, so it answers for the strategy as it exists rather than as it was described. `warnings` are judgements it cannot make for you -- a parameter still at its library default -- and do not stop a run.\n\n[Access: pay 0.005 USDC via x402 (PAYMENT-SIGNATURE header) OR authenticate with an API key. An x402-capable client will auto-pay; API-key clients pay nothing per call.]",
"inputSchema": {
"properties": {
"strategy_id": {
"description": "The strategy's UUID.",
"type": "string"
}
},
"required": [
"strategy_id"
],
"type": "object"
},
"name": "verify_strategy",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:616eb40aa65060d3e38dad011b09146e1d85473fc05551b3c1a7f783a3fb010f | sha256sum