{"components":{"schemas":{"AsyncBacktestStatus":{"description":"Response model for async backtest status polling and result retrieval.","properties":{"backtest_id":{"title":"Backtest Id","type":"string"},"base_token":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Base token of the feed, e.g. BTC. Supply with quote_token and market_data_venue.","examples":["BTC"],"title":"Base Token"},"cash_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cash Balance"},"corpus_dataset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corpus Dataset"},"daily_balances":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Daily Balances"},"daily_equity":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Daily Equity"},"data_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data Info"},"denial_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Denial Summary"},"equity_curve":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Equity Curve"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"execution_state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Execution State"},"execution_time_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Execution Time Seconds"},"generation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Generation"},"market_data_venue":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Venue whose order book the feed comes from, e.g. BINANCE. Supply with base_token and quote_token.","examples":["BINANCE"],"title":"Market Data Venue"},"metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metrics"},"open_positions":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Open Positions"},"quote_token":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Quote token of the feed, e.g. USDC. Supply with base_token and market_data_venue.","examples":["USDC"],"title":"Quote Token"},"status":{"title":"Status","type":"string"},"strategy_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Strategy Names"},"trade_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Trade Count"},"trade_history":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Trade History"}},"required":["backtest_id","status"],"title":"AsyncBacktestStatus","type":"object"},"AsyncBacktestSubmission":{"description":"Response model for async backtest submission (202 Accepted).","properties":{"backtest_id":{"title":"Backtest Id","type":"string"},"status":{"title":"Status","type":"string"}},"required":["backtest_id","status"],"title":"AsyncBacktestSubmission","type":"object"},"BacktestRequest":{"description":"Request model for backtesting endpoint.\n\nStrategy provided via strategy_json only. Signals are already registered\nin the system under domains/signals/ and looked up via RuleRegistry at runtime.","examples":[{"asset":"ETH","base_token":"ETH","cooldown_bars":24,"daily_momentum_limit":3.0,"enable_volatility_adjustment":false,"end_date":"2024-06-15","execution_config":{"atr_period":14,"volatility_tolerance":0.47},"initial_balance":10000.0,"interval":"1h","market_data_venue":"BINANCE","max_open_positions":5,"max_risk_per_trade":0.01,"max_trade_amount":10000.0,"max_trades_per_day":50,"max_units_per_trade":100.0,"min_balance_threshold":0.1,"min_trade_amount":25.0,"quote_token":"USDC","start_date":"2024-01-15","strategy_json":"{\"name\": \"ETH Strategy\", \"asset\": \"ETH\", \"entry\": [{\"name\": \"macd_bullish_cross\", \"timeframe\": \"1h\", \"signal_type\": \"TRIGGER\", \"params\": {\"window_fast\": 12, \"window_slow\": 26, \"window_sign\": 9}}, {\"name\": \"is_above_sma\", \"timeframe\": \"1h\", \"params\": {\"window\": 50}, \"signal_type\": \"FILTER\"}], \"exit\": []}","target_volatility":0.02,"volatility_mode":"stddev","volatility_window":24,"weekly_momentum_limit":3.0}],"properties":{"asset":{"default":"BTC-USDT","title":"Asset","type":"string"},"base_token":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base token of the feed, e.g. BTC. Supply with quote_token and market_data_venue.","examples":["BTC"],"title":"Base Token"},"close_positions_at_end":{"default":true,"title":"Close Positions At End","type":"boolean"},"cooldown_bars":{"title":"Cooldown Bars","type":"integer"},"corpus_dataset":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Corpus Dataset"},"daily_momentum_limit":{"title":"Daily Momentum Limit","type":"number"},"data_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Data Provider"},"enable_volatility_adjustment":{"title":"Enable Volatility Adjustment","type":"boolean"},"end_date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"End Date"},"enforce_capital_floor":{"default":false,"title":"Enforce Capital Floor","type":"boolean"},"exchange":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Exchange"},"execution_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Execution Config"},"fee_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Fee Pct"},"generation":{"default":10,"title":"Generation","type":"integer"},"initial_balance":{"title":"Initial Balance","type":"number"},"interval":{"default":"1h","title":"Interval","type":"string"},"lookback_months":{"default":12,"title":"Lookback Months","type":"integer"},"market_data_venue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Venue whose order book the feed comes from, e.g. BINANCE. Supply with base_token and quote_token.","examples":["BINANCE"],"title":"Market Data Venue"},"max_hold_time_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Max Hold Time Hours"},"max_open_positions":{"title":"Max Open Positions","type":"integer"},"max_risk_per_trade":{"title":"Max Risk Per Trade","type":"number"},"max_trade_amount":{"title":"Max Trade Amount","type":"number"},"max_trades_per_day":{"title":"Max Trades Per Day","type":"integer"},"max_units_per_trade":{"title":"Max Units Per Trade","type":"number"},"min_balance_threshold":{"title":"Min Balance Threshold","type":"number"},"min_stop_distance_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Min Stop Distance Pct"},"min_trade_amount":{"title":"Min Trade Amount","type":"number"},"mode":{"default":"full","title":"Mode","type":"string"},"open_positions":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"default":null,"title":"Open Positions"},"quote_token":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Quote token of the feed, e.g. USDC. Supply with base_token and market_data_venue.","examples":["USDC"],"title":"Quote Token"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Seed"},"slippage_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Slippage Pct"},"start_date":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Start Date"},"strategy_json":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Strategy Json"},"target_volatility":{"title":"Target Volatility","type":"number"},"venue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Venue"},"volatility_mode":{"title":"Volatility Mode","type":"string"},"volatility_window":{"title":"Volatility Window","type":"integer"},"weekly_momentum_limit":{"title":"Weekly Momentum Limit","type":"number"}},"required":["initial_balance","min_balance_threshold","min_trade_amount","max_open_positions","max_trades_per_day","max_risk_per_trade","max_units_per_trade","max_trade_amount","volatility_window","target_volatility","volatility_mode","enable_volatility_adjustment","cooldown_bars","daily_momentum_limit","weekly_momentum_limit"],"title":"BacktestRequest","type":"object"},"BacktestResult":{"description":"Result model for backtesting endpoint.","properties":{"base_token":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Base token of the feed, e.g. BTC. Supply with quote_token and market_data_venue.","examples":["BTC"],"title":"Base Token"},"cash_balance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cash Balance"},"corpus_dataset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corpus Dataset"},"daily_balances":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Daily Balances"},"daily_equity":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Daily Equity"},"data_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data Info"},"denied_signals":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Denied Signals"},"equity_curve":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Equity Curve"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"execution_state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Execution State"},"execution_time_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Execution Time Seconds"},"generation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Generation"},"market_data_venue":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Venue whose order book the feed comes from, e.g. BINANCE. Supply with base_token and quote_token.","examples":["BINANCE"],"title":"Market Data Venue"},"metrics":{"additionalProperties":true,"title":"Metrics","type":"object"},"open_positions":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Open Positions"},"quote_token":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Quote token of the feed, e.g. USDC. Supply with base_token and market_data_venue.","examples":["USDC"],"title":"Quote Token"},"strategy_names":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Strategy Names"},"success":{"title":"Success","type":"boolean"},"trade_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Trade Count"},"trade_history":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Trade History"}},"required":["success","metrics"],"title":"BacktestResult","type":"object"},"BacktestTradesResponse":{"description":"Response model for trade history retrieval.","properties":{"backtest_id":{"title":"Backtest Id","type":"string"},"success":{"title":"Success","type":"boolean"},"trade_count":{"title":"Trade Count","type":"integer"},"trades":{"items":{"additionalProperties":true,"type":"object"},"title":"Trades","type":"array"}},"required":["success","backtest_id","trade_count","trades"],"title":"BacktestTradesResponse","type":"object"},"BulkBacktestRequest":{"description":"Request model for bulk backtesting endpoint.\n\nEvaluates multiple strategies over a shared date range. Raw market data is\nreused only when source, market, timeframe and required history window\nmatch; every strategy receives fresh mutable loaders.","examples":[{"cooldown_bars":24,"daily_momentum_limit":3.0,"enable_volatility_adjustment":false,"end_date":"2024-12-31","execution_config":{"atr_period":14,"volatility_tolerance":0.47},"initial_balance":10000.0,"max_open_positions":5,"max_risk_per_trade":0.01,"max_trade_amount":10000.0,"max_trades_per_day":50,"max_units_per_trade":100.0,"min_balance_threshold":0.1,"min_trade_amount":25.0,"start_date":"2024-01-01","strategy_configs":[{"asset":"BTC","base_token":"BTC","entry":[{"name":"macd_bullish_cross","params":{"window_fast":12,"window_sign":9,"window_slow":26},"signal_type":"TRIGGER","timeframe":"1h"},{"name":"is_above_sma","params":{"window":50},"signal_type":"FILTER","timeframe":"1h"}],"exit":[{"name":"macd_bearish_cross","params":{"window_fast":12,"window_sign":9,"window_slow":26},"signal_type":"TRIGGER","timeframe":"1h"}],"market_data_venue":"BINANCE","name":"BTC MACD Strategy","quote_token":"USDC"}],"target_volatility":0.02,"volatility_mode":"stddev","volatility_window":24,"weekly_momentum_limit":3.0}],"properties":{"cooldown_bars":{"title":"Cooldown Bars","type":"integer"},"daily_momentum_limit":{"title":"Daily Momentum Limit","type":"number"},"data_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Data Provider"},"enable_volatility_adjustment":{"title":"Enable Volatility Adjustment","type":"boolean"},"end_date":{"format":"date-time","title":"End Date","type":"string"},"execution_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Execution Config"},"fee_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Fee Pct"},"generation":{"default":10,"title":"Generation","type":"integer"},"initial_balance":{"title":"Initial Balance","type":"number"},"max_hold_time_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Max Hold Time Hours"},"max_open_positions":{"title":"Max Open Positions","type":"integer"},"max_risk_per_trade":{"title":"Max Risk Per Trade","type":"number"},"max_trade_amount":{"title":"Max Trade Amount","type":"number"},"max_trades_per_day":{"title":"Max Trades Per Day","type":"integer"},"max_units_per_trade":{"title":"Max Units Per Trade","type":"number"},"min_balance_threshold":{"title":"Min Balance Threshold","type":"number"},"min_stop_distance_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Min Stop Distance Pct"},"min_trade_amount":{"title":"Min Trade Amount","type":"number"},"mode":{"default":"full","title":"Mode","type":"string"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Seed"},"slippage_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Slippage Pct"},"start_date":{"format":"date-time","title":"Start Date","type":"string"},"strategy_configs":{"anyOf":[{"items":{"$ref":"#/components/schemas/BulkStrategyConfig"},"type":"array"},{"type":"null"}],"default":null,"title":"Strategy Configs"},"strategy_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Strategy Ids"},"target_volatility":{"title":"Target Volatility","type":"number"},"venue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Venue"},"volatility_mode":{"title":"Volatility Mode","type":"string"},"volatility_window":{"title":"Volatility Window","type":"integer"},"weekly_momentum_limit":{"title":"Weekly Momentum Limit","type":"number"}},"required":["start_date","end_date","initial_balance","min_balance_threshold","min_trade_amount","max_open_positions","max_trades_per_day","max_risk_per_trade","max_units_per_trade","max_trade_amount","volatility_window","target_volatility","volatility_mode","enable_volatility_adjustment","cooldown_bars","daily_momentum_limit","weekly_momentum_limit"],"title":"BulkBacktestRequest","type":"object"},"BulkBacktestResult":{"description":"Result model for bulk backtesting endpoint.","properties":{"data_fetches":{"description":"Unique raw full-engine source/window reads in this batch; zero in quick mode. This does not count quick-evaluator reads or already preloaded engine frames.","title":"Data Fetches","type":"integer"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"results":{"items":{"$ref":"#/components/schemas/StrategyBacktestResult"},"title":"Results","type":"array"},"success":{"title":"Success","type":"boolean"},"total_execution_time_seconds":{"title":"Total Execution Time Seconds","type":"number"}},"required":["success","results","data_fetches","total_execution_time_seconds"],"title":"BulkBacktestResult","type":"object"},"BulkStrategyConfig":{"additionalProperties":true,"description":"One inline strategy of a bulk backtest: its rules, plus the market it runs on.","properties":{"base_token":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Base token of the feed, e.g. BTC. Supply with quote_token and market_data_venue.","examples":["BTC"],"title":"Base Token"},"market_data_venue":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Venue whose order book the feed comes from, e.g. BINANCE. Supply with base_token and quote_token.","examples":["BINANCE"],"title":"Market Data Venue"},"quote_token":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Quote token of the feed, e.g. USDC. Supply with base_token and market_data_venue.","examples":["USDC"],"title":"Quote Token"}},"title":"BulkStrategyConfig","type":"object"},"ConditionPreviewRequest":{"description":"One condition to resolve, for one strategy's asset and timeframe.","properties":{"asset":{"description":"Asset symbol, e.g. BTC","title":"Asset","type":"string"},"condition":{"additionalProperties":true,"description":"Labels to match: direction, volatility, trend. Each takes one value or a list of them. Axes are ANDed, values within an axis ORed. Empty matches every labelled window.","title":"Condition","type":"object"},"include_gapped":{"default":false,"description":"Include windows with missing bars. Off by default.","title":"Include Gapped","type":"boolean"},"n":{"default":10,"description":"How many windows to take","maximum":50.0,"minimum":1.0,"title":"N","type":"integer"},"timeframe":{"description":"Bar size the strategy runs at, e.g. 1h","title":"Timeframe","type":"string"}},"required":["asset","timeframe"],"title":"ConditionPreviewRequest","type":"object"},"ConditionSpec":{"description":"The market to look for, and how much of it to run.\n\n``axes`` is a conjunction over the labels a window already carries --\ndirection, volatility, trend -- resolved against the catalog by\n``services.window_selection``. Empty means every labelled window.","properties":{"axes":{"additionalProperties":true,"title":"Axes","type":"object"},"include_gapped":{"default":false,"title":"Include Gapped","type":"boolean"},"n":{"default":10,"title":"N","type":"integer"}},"title":"ConditionSpec","type":"object"},"CreateDatasetRequest":{"description":"One window of a market's series: whole UTC days, ``[start_date, end_date)``.","properties":{"asset":{"description":"Base symbol, e.g. BTC","title":"Asset","type":"string"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO date or datetime, UTC; exclusive. Defaults to, and never exceeds, the day the series is complete through.","title":"End Date"},"market_data_venue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Data Venue"},"quote_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Token"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The venue whose series the window is a span of: `binance` or `kraken`. Omitted: the first of `binance`, `kraken`, then any other venue, that holds a series for the asset and timeframe; when none does, the first whose history source is configured. A venue with no series for the market gets one, seeded from its history source; a market the source cannot serve is refused with 422.","title":"Source"},"start_date":{"description":"ISO date or datetime, UTC; taken as its day","title":"Start Date","type":"string"},"timeframe":{"description":"1m | 5m | 15m | 30m | 1h | 4h | 1d","title":"Timeframe","type":"string"}},"required":["asset","timeframe","start_date"],"title":"CreateDatasetRequest","type":"object"},"DatasetSelection":{"description":"A selected OHLCV data file for the experiment.","properties":{"asset":{"title":"Asset","type":"string"},"end_date":{"title":"End Date","type":"string"},"file":{"title":"File","type":"string"},"hash":{"default":"","title":"Hash","type":"string"},"quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote"},"rows":{"default":0,"title":"Rows","type":"integer"},"start_date":{"title":"Start Date","type":"string"},"timeframe":{"title":"Timeframe","type":"string"},"venue":{"title":"Venue","type":"string"}},"required":["asset","timeframe","file","start_date","end_date","venue"],"title":"DatasetSelection","type":"object"},"ExecConfigSweep":{"description":"Execution config with base values and optional sweep axes.\n\nEach axis dict: ``{\"param\", \"min\", \"max\", \"n\", \"mode\"?}``. ``n`` is a\nRUN-COUNT MULTIPLIER in every mode \u2014 a swept axis contributes n values\nand the plan crosses all axes (\u220fn variants per base run). ``mode``\n(\"grid\" | \"random\", optional) selects how the n values are generated,\nindependently of the experiment's signal ``search_mode``:\n\n- ``grid``: the n evenly-spaced linspace(min, max, n) points.\n- ``random``: n fresh independent Uniform(min, max) draws.\n\nWhen ``mode`` is absent the plan path's default applies (grid plans \u2192\n\"grid\", random plans \u2192 \"random\").","properties":{"base":{"additionalProperties":true,"title":"Base","type":"object"},"sweep_axes":{"items":{"additionalProperties":true,"type":"object"},"title":"Sweep Axes","type":"array"}},"title":"ExecConfigSweep","type":"object"},"ExperimentConfig":{"description":"Full experiment configuration -- the top-level object.\n\nTwo search modes:\n- grid: enumerate all signal combos x param combos x exec config variants\n- random: randomly sample N runs (signals, params, exec config all random)","properties":{"allow_dirty":{"default":false,"title":"Allow Dirty","type":"boolean"},"allow_oversized":{"default":false,"title":"Allow Oversized","type":"boolean"},"benchmark_returns":{"additionalProperties":{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"object"},"title":"Benchmark Returns","type":"object"},"cloud_run_execution_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cloud Run Execution Name"},"cloud_run_task_count":{"default":1,"title":"Cloud Run Task Count","type":"integer"},"code_version":{"default":"","title":"Code Version","type":"string"},"condition":{"anyOf":[{"$ref":"#/components/schemas/ConditionSpec"},{"type":"null"}]},"created_at":{"default":"","title":"Created At","type":"string"},"datasets":{"items":{"$ref":"#/components/schemas/DatasetSelection"},"title":"Datasets","type":"array"},"description":{"default":"","title":"Description","type":"string"},"entry_signals":{"$ref":"#/components/schemas/SignalSelection"},"execution_config":{"$ref":"#/components/schemas/ExecConfigSweep"},"exit_signals":{"$ref":"#/components/schemas/SignalSelection"},"experiment_id":{"default":"","title":"Experiment Id","type":"string"},"generation":{"default":10,"title":"Generation","type":"integer"},"grants":{"items":{"$ref":"#/components/schemas/ExperimentGrant"},"title":"Grants","type":"array"},"grid_signals":{"$ref":"#/components/schemas/GridSignalConfig"},"kind":{"default":"single","enum":["single","pair","regime"],"title":"Kind","type":"string"},"launched_at":{"default":"","title":"Launched At","type":"string"},"max_total_runs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Total Runs"},"max_warmup_bars":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":500,"title":"Max Warmup Bars"},"missing_runs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Missing Runs"},"n_random":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Random"},"name":{"title":"Name","type":"string"},"native_materialization_version":{"default":0,"title":"Native Materialization Version","type":"integer"},"native_materialized":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Native Materialized"},"notes":{"default":"","title":"Notes","type":"string"},"org_id":{"default":"00000143-0000-0000-0000-000000000589","title":"Org Id","type":"string"},"pairs":{"items":{"$ref":"#/components/schemas/PairSelection"},"title":"Pairs","type":"array"},"param_samples":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Param Samples"},"pinned_strategy":{"anyOf":[{"$ref":"#/components/schemas/PinnedStrategy"},{"type":"null"}]},"planned_runs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Planned Runs"},"pre_filter":{"$ref":"#/components/schemas/PreFilterConfig"},"queued_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Queued At"},"queued_concurrent_cap":{"default":0,"title":"Queued Concurrent Cap","type":"integer"},"random_signals":{"$ref":"#/components/schemas/RandomSignalConfig"},"retail_inputs":{"anyOf":[{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object"},{"type":"null"}],"title":"Retail Inputs"},"retail_plan_digest":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retail Plan Digest"},"rotation_params":{"anyOf":[{"$ref":"#/components/schemas/RotationParamSweep"},{"type":"null"}]},"run_index_collisions":{"items":{"additionalProperties":true,"type":"object"},"title":"Run Index Collisions","type":"array"},"run_index_collisions_refused":{"default":0,"title":"Run Index Collisions Refused","type":"integer"},"run_index_scheme":{"default":0,"title":"Run Index Scheme","type":"integer"},"search_mode":{"default":"grid","enum":["grid","random"],"title":"Search Mode","type":"string"},"seed":{"default":42,"title":"Seed","type":"integer"},"selection_report":{"additionalProperties":true,"title":"Selection Report","type":"object"},"skipped_windows":{"items":{"additionalProperties":true,"type":"object"},"title":"Skipped Windows","type":"array"},"status":{"default":"draft","title":"Status","type":"string"},"sweep_complete_billed":{"default":false,"title":"Sweep Complete Billed","type":"boolean"},"sweep_lock_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sweep Lock Token"},"sweep_quota_settled":{"default":false,"title":"Sweep Quota Settled","type":"boolean"},"total_candles":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Candles"},"total_runs":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Runs"},"total_workers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Workers"},"trades_materialized":{"default":false,"title":"Trades Materialized","type":"boolean"},"user_id":{"default":"00000000-0000-0000-0000-000000000003","title":"User Id","type":"string"},"warmup_requirements":{"additionalProperties":true,"title":"Warmup Requirements","type":"object"},"warmup_skipped":{"additionalProperties":{"type":"string"},"title":"Warmup Skipped","type":"object"},"workers_per_dataset":{"default":2,"title":"Workers Per Dataset","type":"integer"}},"required":["name"],"title":"ExperimentConfig","type":"object"},"ExperimentGrant":{"description":"Read access to an experiment and its results, given to an org or a user\noutside its owner.\n\nA grantee cannot change the experiment. Grants are added and removed through\nthe grant routes, never through the experiment body.","properties":{"granted_at":{"default":"","title":"Granted At","type":"string"},"granted_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Granted By"},"principal_id":{"minLength":1,"title":"Principal Id","type":"string"},"principal_type":{"enum":["org","user"],"title":"Principal Type","type":"string"}},"required":["principal_type","principal_id"],"title":"ExperimentGrant","type":"object"},"Filter":{"properties":{"col":{"title":"Col","type":"string"},"op":{"enum":["=","!=",">",">=","<","<=","in","between"],"title":"Op","type":"string"},"value":{"title":"Value"}},"required":["col","op","value"],"title":"Filter","type":"object"},"GenerateResponse":{"description":"Response from POST /simulate/generate.","properties":{"already_existed":{"title":"Already Existed","type":"boolean"},"asset_name":{"title":"Asset Name","type":"string"},"currency":{"default":"USD","title":"Currency","type":"string"},"end_date":{"title":"End Date","type":"string"},"filename":{"title":"Filename","type":"string"},"hash":{"title":"Hash","type":"string"},"rows":{"title":"Rows","type":"integer"},"start_date":{"title":"Start Date","type":"string"},"timeframe":{"title":"Timeframe","type":"string"}},"required":["filename","asset_name","timeframe","start_date","end_date","rows","hash","already_existed"],"title":"GenerateResponse","type":"object"},"GrantRequest":{"description":"Body of ``POST /experiments/{experiment_id}/grants``.","properties":{"principal_id":{"minLength":1,"title":"Principal Id","type":"string"},"principal_type":{"enum":["org","user"],"title":"Principal Type","type":"string"}},"required":["principal_type","principal_id"],"title":"GrantRequest","type":"object"},"GridSignalConfig":{"description":"Signal config for grid search mode.\n\nControls how many param combos per signal in grid enumeration.","properties":{"n_param_combos":{"default":3,"title":"N Param Combos","type":"integer"}},"title":"GridSignalConfig","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ImpactConfigRequest":{"properties":{"coefficient":{"anyOf":[{"maximum":2.0,"minimum":0.0,"type":"number"},{"type":"null"}],"title":"Coefficient"},"decay_exponent":{"anyOf":[{"maximum":2.0,"minimum":0.1,"type":"number"},{"type":"null"}],"title":"Decay Exponent"},"lookback":{"anyOf":[{"maximum":500.0,"minimum":1.0,"type":"integer"},{"type":"null"}],"title":"Lookback"},"mode":{"default":"single_bar","title":"Mode","type":"string"},"permanent_fraction":{"anyOf":[{"maximum":1.0,"minimum":0.0,"type":"number"},{"type":"null"}],"title":"Permanent Fraction"}},"title":"ImpactConfigRequest","type":"object"},"LiquidityConfigRequest":{"properties":{"base_liquidity":{"anyOf":[{"exclusiveMinimum":0.0,"type":"number"},{"type":"null"}],"title":"Base Liquidity"},"consumption_fraction":{"anyOf":[{"maximum":1.0,"minimum":0.0,"type":"number"},{"type":"null"}],"title":"Consumption Fraction"},"floor_fraction":{"anyOf":[{"maximum":1.0,"minimum":0.0,"type":"number"},{"type":"null"}],"title":"Floor Fraction"},"mode":{"default":"mean_revert","title":"Mode","type":"string"},"recovery_rate":{"anyOf":[{"maximum":1.0,"minimum":0.01,"type":"number"},{"type":"null"}],"title":"Recovery Rate"},"vol_lookback":{"anyOf":[{"minimum":1.0,"type":"integer"},{"type":"null"}],"title":"Vol Lookback"},"vol_sensitivity":{"anyOf":[{"minimum":0.0,"type":"number"},{"type":"null"}],"title":"Vol Sensitivity"}},"title":"LiquidityConfigRequest","type":"object"},"MarketConditionConfigRequest":{"properties":{"bear_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bear Threshold"},"bull_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bull Threshold"},"drift_bearish":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Drift Bearish"},"drift_bullish":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Drift Bullish"},"drift_neutral":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Drift Neutral"},"lookback_bars":{"anyOf":[{"minimum":1.0,"type":"integer"},{"type":"null"}],"title":"Lookback Bars"},"mode":{"default":"static","title":"Mode","type":"string"},"schedule":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Schedule"},"static_condition":{"default":"neutral","title":"Static Condition","type":"string"}},"title":"MarketConditionConfigRequest","type":"object"},"OrderBy":{"properties":{"col":{"title":"Col","type":"string"},"dir":{"default":"asc","enum":["asc","desc"],"title":"Dir","type":"string"}},"required":["col"],"title":"OrderBy","type":"object"},"PairSelection":{"description":"A pair of OHLCV files for a continuous-allocation rotation experiment.\n\nMirror of ``DatasetSelection`` but carries metadata for two legs (A and B).\nThe sweep worker loads each leg via ``load_ohlcv_file`` and builds a\nsynthetic A/B ratio frame for kb signal evaluation.","properties":{"asset_a":{"title":"Asset A","type":"string"},"asset_b":{"title":"Asset B","type":"string"},"end_date":{"title":"End Date","type":"string"},"file_a":{"title":"File A","type":"string"},"file_b":{"title":"File B","type":"string"},"hash_a":{"default":"","title":"Hash A","type":"string"},"hash_b":{"default":"","title":"Hash B","type":"string"},"rows_a":{"default":0,"title":"Rows A","type":"integer"},"rows_b":{"default":0,"title":"Rows B","type":"integer"},"start_date":{"title":"Start Date","type":"string"},"timeframe":{"title":"Timeframe","type":"string"}},"required":["asset_a","asset_b","timeframe","file_a","file_b","start_date","end_date"],"title":"PairSelection","type":"object"},"ParamSweep":{"description":"One sampling axis: how many values to take from a range, and how.\n\nEither explicit ``values``, or a ``[min, max]`` range with ``n`` samples\ndrawn in ``mode`` -- ``grid`` takes the n evenly-spaced points, ``random``\ntakes n independent draws. ``n`` is the count in both; the mode only\ndecides which values, never how many. Unset ``n`` and ``mode`` take the\nexperiment's ``param_samples`` and ``search_mode``.\n\n``step`` is the same axis written as an interval, kept so saved configs\nstill load. It is read once and translated to ``n``; nothing writes it.","properties":{"default":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"},{"type":"boolean"},{"items":{"anyOf":[{"type":"integer"},{"type":"number"}]},"type":"array"},{"type":"null"}],"title":"Default"},"max":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Max"},"min":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Min"},"mode":{"anyOf":[{"enum":["grid","random"],"type":"string"},{"type":"null"}],"title":"Mode"},"n":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N"},"step":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Step"},"values":{"anyOf":[{"items":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"string"},{"type":"boolean"},{"items":{"anyOf":[{"type":"integer"},{"type":"number"}]},"type":"array"}]},"type":"array"},{"type":"null"}],"title":"Values"}},"title":"ParamSweep","type":"object"},"PinnedStrategy":{"description":"One strategy, run unchanged on every window of a condition study.\n\nA study varies the market and nothing else, so this is the whole strategy\nand there is no sampling axis anywhere near it: the same ``entry``,\n``exit`` and ``exec_config`` reach every run verbatim. That is what makes\na study's answer about the market rather than about a search.\n\n``source_strategy_id`` is the caller's own identifier for the strategy\n(MangroveAI's strategy UUID). Stamped on every row so a study's results can\nbe joined back to the strategy they describe, and so a second study of the\nsame strategy is recognisable as one.","properties":{"asset":{"title":"Asset","type":"string"},"entry":{"items":{"additionalProperties":true,"type":"object"},"title":"Entry","type":"array"},"exec_config":{"additionalProperties":true,"title":"Exec Config","type":"object"},"exit":{"items":{"additionalProperties":true,"type":"object"},"title":"Exit","type":"array"},"name":{"default":"","title":"Name","type":"string"},"source_strategy_id":{"default":"","title":"Source Strategy Id","type":"string"},"timeframe":{"title":"Timeframe","type":"string"}},"required":["asset","timeframe"],"title":"PinnedStrategy","type":"object"},"PreFilterConfig":{"description":"Binary pre-filter configuration using the Mangrove SIEVE model.","properties":{"confidence_threshold":{"default":0.9,"title":"Confidence Threshold","type":"number"},"enabled":{"default":false,"title":"Enabled","type":"boolean"}},"title":"PreFilterConfig","type":"object"},"QueryRequest":{"description":"Constrained DSL \u2014 never accepts raw SQL.\n\n``WHERE org_id = <caller's org_id>`` is injected by the proxy from\nvalidated request context; clients cannot override it (their filter\nlist is ANDed onto the org_id constraint, not vice versa).","properties":{"filters":{"items":{"$ref":"#/components/schemas/Filter"},"maxItems":20,"title":"Filters","type":"array"},"limit":{"default":100,"maximum":1000.0,"minimum":1.0,"title":"Limit","type":"integer"},"order_by":{"items":{"$ref":"#/components/schemas/OrderBy"},"maxItems":5,"title":"Order By","type":"array"},"page_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Token"},"select":{"items":{"type":"string"},"maxItems":80,"minItems":1,"title":"Select","type":"array"},"table":{"const":"results","title":"Table","type":"string"}},"required":["table","select"],"title":"QueryRequest","type":"object"},"QueryResponse":{"properties":{"cost_estimate_usd":{"title":"Cost Estimate Usd","type":"number"},"next_page_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Page Token"},"row_count":{"title":"Row Count","type":"integer"},"rows":{"items":{"additionalProperties":true,"type":"object"},"title":"Rows","type":"array"},"table":{"title":"Table","type":"string"},"total_bytes_billed":{"title":"Total Bytes Billed","type":"integer"}},"required":["table","rows","row_count","total_bytes_billed","cost_estimate_usd"],"title":"QueryResponse","type":"object"},"RandomSignalConfig":{"description":"Signal count configuration for random search mode.\n\nControls how many signals are randomly drawn per run.","properties":{"allowed_catalogs":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Catalogs"},"allowed_categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Categories"},"max_entry_filters":{"default":1,"title":"Max Entry Filters","type":"integer"},"max_exit_filters":{"default":1,"title":"Max Exit Filters","type":"integer"},"max_exit_triggers":{"default":1,"title":"Max Exit Triggers","type":"integer"},"min_entry_filters":{"default":1,"title":"Min Entry Filters","type":"integer"},"min_exit_filters":{"default":0,"title":"Min Exit Filters","type":"integer"},"min_exit_triggers":{"default":0,"title":"Min Exit Triggers","type":"integer"},"n_entry_triggers":{"default":1,"title":"N Entry Triggers","type":"integer"},"n_param_draws":{"default":1,"title":"N Param Draws","type":"integer"},"signal_groups":{"items":{"$ref":"#/components/schemas/SignalGroup"},"title":"Signal Groups","type":"array"}},"title":"RandomSignalConfig","type":"object"},"ReplayDiff":{"description":"Per-metric drift between the stored row and the replay result.","properties":{"abs_drift":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Abs Drift"},"field":{"title":"Field","type":"string"},"relative_drift":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Relative Drift"},"replay":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Replay"},"stored":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stored"}},"required":["field"],"title":"ReplayDiff","type":"object"},"ReplayResponse":{"description":"Replay-at-original-code response. Always 200 OK regardless of outcome.\n\nR5 (master plan I5): non-replayable rows are still successful queries\n\u2014 the answer is \"this row's classification doesn't support sandbox\nreplay; here's why; use rerun-on-latest\". Not a 4xx.","properties":{"classification":{"title":"Classification","type":"string"},"code_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Version"},"denied_signals":{"items":{"additionalProperties":true,"type":"object"},"title":"Denied Signals","type":"array"},"diff":{"items":{"$ref":"#/components/schemas/ReplayDiff"},"title":"Diff","type":"array"},"execution_time_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Execution Time Seconds"},"hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hint"},"image_tag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Tag"},"metrics":{"additionalProperties":true,"title":"Metrics","type":"object"},"oracle_was_dirty":{"default":false,"title":"Oracle Was Dirty","type":"boolean"},"reason":{"default":"","title":"Reason","type":"string"},"replayable":{"title":"Replayable","type":"boolean"},"trade_count":{"default":0,"title":"Trade Count","type":"integer"},"trades":{"items":{"additionalProperties":true,"type":"object"},"title":"Trades","type":"array"},"used_oracle_fallback":{"default":false,"title":"Used Oracle Fallback","type":"boolean"}},"required":["replayable","classification"],"title":"ReplayResponse","type":"object"},"RerunResponse":{"description":"Rerun-on-latest response (Commit 7).\n\nLives in the same module to keep replay-related schemas adjacent;\nconsumed by the second endpoint that runs every row regardless of\nclassification. Carries the migration diff so the UI can show what\nEC fields were filled / changed during the migration.","properties":{"classification":{"title":"Classification","type":"string"},"code_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code Version"},"diff":{"items":{"$ref":"#/components/schemas/ReplayDiff"},"title":"Diff","type":"array"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"execution_time_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Execution Time Seconds"},"metrics":{"additionalProperties":true,"title":"Metrics","type":"object"},"migration_diff":{"additionalProperties":true,"title":"Migration Diff","type":"object"},"ok":{"title":"Ok","type":"boolean"},"trade_count":{"default":0,"title":"Trade Count","type":"integer"}},"required":["ok","classification"],"title":"RerunResponse","type":"object"},"RotationParamSweep":{"description":"Sweep ranges for the rotation execution parameters.\n\nSweep axes (drawn per run): ``ema_alpha``, ``rebalance_band``,\n``signal_lag``, ``start_weight_a``, ``n_signals_per_run``.\n\nSingle-value (NOT swept) execution costs: ``fee_bps`` and\n``slippage_bps``. Defaults mirror the canonical\n``trading_defaults.json`` values used by the single-asset engine\nwhen ``ExecConfigSweep`` doesn't override them\n(``fee_pct=0.0085`` \u2192 85 bps, ``slippage_pct=0.004`` \u2192 40 bps).\nBoth are applied as proportional drag on the transferred USD per\nswap \u2014 see ``src/services/pair_backtest.py::run_rotation``.","properties":{"ema_alpha":{"$ref":"#/components/schemas/ParamSweep"},"fee_bps":{"default":25.0,"title":"Fee Bps","type":"number"},"n_signals_per_run":{"$ref":"#/components/schemas/ParamSweep"},"rebalance_band":{"$ref":"#/components/schemas/ParamSweep"},"signal_lag":{"$ref":"#/components/schemas/ParamSweep"},"slippage_bps":{"default":20.0,"title":"Slippage Bps","type":"number"},"start_weight_a":{"$ref":"#/components/schemas/ParamSweep"}},"title":"RotationParamSweep","type":"object"},"RunInput":{"description":"Raw run shape consumed by the SIEVE predictor.\n\nMatches what ``src/services/plan_generator.py`` builds before calling\n``predict_batch``. Use this when scoring rows already extracted from\nthe Parquet corpus.","properties":{"asset":{"title":"Asset","type":"string"},"entry_json":{"title":"Entry Json","type":"string"},"exec_config":{"additionalProperties":true,"title":"Exec Config","type":"object"},"exit_json":{"title":"Exit Json","type":"string"}},"required":["entry_json","exit_json","asset","exec_config"],"title":"RunInput","type":"object"},"SievePrediction":{"description":"Probabilities for one input item.\n\n``binary`` is the go/no-go head: ``{\"p_no_trades\", \"p_trades\"}`` \u2014 whether a\nstrategy is worth backtesting (will it place trades). The dict sums to 1.0\nwithin float32 tolerance. The 4-class IRR outcome head is retired: SIEVE\ndoes not predict performance, only worth-backtesting.","properties":{"binary":{"additionalProperties":{"type":"number"},"title":"Binary","type":"object"}},"required":["binary"],"title":"SievePrediction","type":"object"},"SieveScoreRequest":{"description":"Score request \u2014 exactly one of ``strategies`` / ``runs`` must be set.\n\nThe per-request item cap is enforced in the route handler (HTTP 413\non overage); it lives there rather than here so error messages can\ncite the actual limit.","examples":[{"strategies":[{"asset":"BTC","entry":[{"name":"macd_bullish_cross","params":{"window_fast":12,"window_sign":9,"window_slow":26},"signal_type":"TRIGGER","timeframe":"1h"},{"name":"is_above_sma","params":{"window":50},"signal_type":"FILTER","timeframe":"1h"}],"execution_config":{"max_risk_per_trade":0.01,"reward_factor":2.0},"exit":[{"name":"macd_bearish_cross","params":{"window_fast":12,"window_sign":9,"window_slow":26},"signal_type":"TRIGGER","timeframe":"1h"}]}]},{"runs":[{"asset":"BTC","entry_json":"[{\"name\":\"macd_bullish_cross\",\"signal_type\":\"TRIGGER\",\"params\":{\"window_fast\":12,\"window_slow\":26,\"window_sign\":9}}]","exec_config":{"max_risk_per_trade":0.01,"reward_factor":2.0},"exit_json":"[{\"name\":\"macd_bearish_cross\",\"signal_type\":\"TRIGGER\",\"params\":{\"window_fast\":12,\"window_slow\":26,\"window_sign\":9}}]"}]}],"properties":{"runs":{"anyOf":[{"items":{"$ref":"#/components/schemas/RunInput"},"type":"array"},{"type":"null"}],"default":null,"title":"Runs"},"strategies":{"anyOf":[{"items":{"$ref":"#/components/schemas/StrategyInput"},"type":"array"},{"type":"null"}],"default":null,"title":"Strategies"}},"title":"SieveScoreRequest","type":"object"},"SieveScoreResponse":{"description":"Score response.\n\nProbabilities are returned in the same order as the request items.\n``model_version`` is a content hash of the bundled artifacts; it changes\nwhen the model is retrained. ``code_version`` is the standard Oracle\nprovenance stamp (``oracle:<ref> ai:<ref> kb:<ref> roots:<ref>``).","examples":[{"code_version":"oracle:v0.12.0 ai:v3.9.5 kb:1.0.3 roots:v0.3.0","count":1,"model_version":"mangrove-sieve:8b4e2c91d0fa","predictions":[{"binary":{"p_no_trades":0.082,"p_trades":0.918}}]}],"properties":{"code_version":{"title":"Code Version","type":"string"},"count":{"title":"Count","type":"integer"},"model_version":{"title":"Model Version","type":"string"},"predictions":{"items":{"$ref":"#/components/schemas/SievePrediction"},"title":"Predictions","type":"array"}},"required":["predictions","count","model_version","code_version"],"title":"SieveScoreResponse","type":"object"},"SignalConfig":{"description":"A signal selected for sweeping with its param sweep definitions.\n\nUsed in grid mode where the user picks specific signals.","properties":{"name":{"title":"Name","type":"string"},"params_sweep":{"additionalProperties":{"$ref":"#/components/schemas/ParamSweep"},"title":"Params Sweep","type":"object"},"signal_type":{"enum":["TRIGGER","FILTER"],"title":"Signal Type","type":"string"},"timeframe":{"default":"1h","title":"Timeframe","type":"string"}},"required":["name","signal_type"],"title":"SignalConfig","type":"object"},"SignalGroup":{"description":"A named pool of signals for within-group random sampling.\n\nEach strategy sampled from a group draws ALL of its signals \u2014 entry AND\nexit, triggers AND filters \u2014 only from this group's members, so signals\nfrom different groups never co-occur on one strategy (e.g. keep volatility\nand momentum apart by putting them in separate groups).\n\nMembership = every non-blacklisted signal whose category is in\n``categories``, PLUS ``include`` (specific signal names forced in even if\ntheir category isn't listed), MINUS ``exclude`` (specific signal names\nremoved). ``weight`` is the group's relative share of the total strategy\ncount; ``None`` on a group means \"even split with the other unweighted\ngroups\". Weights are normalized across all groups.\n\n``triggers`` and ``filters`` divide that membership by role. A role\nselection is applied to the group's members, never in place of them, so it\ncan only name signals the group already holds; one that names nothing, or\nis absent, gives that role every member. A signal is eligible only for the\nrole its knowledge-base type gives it, so a role selection chooses which of\nthe group's members serve that role rather than reassigning them.","properties":{"categories":{"items":{"type":"string"},"title":"Categories","type":"array"},"exclude":{"items":{"type":"string"},"title":"Exclude","type":"array"},"filters":{"anyOf":[{"$ref":"#/components/schemas/SignalGroupRole"},{"type":"null"}]},"include":{"items":{"type":"string"},"title":"Include","type":"array"},"name":{"title":"Name","type":"string"},"triggers":{"anyOf":[{"$ref":"#/components/schemas/SignalGroupRole"},{"type":"null"}]},"weight":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Weight"}},"required":["name"],"title":"SignalGroup","type":"object"},"SignalGroupRole":{"description":"One role's share of a signal group, by the group's own membership rule.\n\nSame ``(categories union include) minus exclude`` formula a group uses,\napplied to the trigger or the filter pools alone.","properties":{"categories":{"items":{"type":"string"},"title":"Categories","type":"array"},"exclude":{"items":{"type":"string"},"title":"Exclude","type":"array"},"include":{"items":{"type":"string"},"title":"Include","type":"array"}},"title":"SignalGroupRole","type":"object"},"SignalSelection":{"description":"Entry or exit signal configuration for an experiment.\n\n``triggers`` and ``filters`` are the signals a run may draw from, in both\nsearch modes: the mode chooses which points of the space a plan visits, not\nwhat is in it. Empty means empty; a config written before the modes merged\ncarries no ``param_samples`` and reads empty as the whole pool.","properties":{"constraints":{"items":{"items":{"type":"string"},"type":"array"},"title":"Constraints","type":"array"},"filters":{"items":{"$ref":"#/components/schemas/SignalConfig"},"title":"Filters","type":"array"},"max_filters":{"default":1,"title":"Max Filters","type":"integer"},"min_filters":{"default":1,"title":"Min Filters","type":"integer"},"optional":{"default":false,"title":"Optional","type":"boolean"},"triggers":{"items":{"$ref":"#/components/schemas/SignalConfig"},"title":"Triggers","type":"array"}},"title":"SignalSelection","type":"object"},"SignalSpec":{"description":"One entry or exit signal inside a ``StrategyInput``.","properties":{"name":{"title":"Name","type":"string"},"params":{"additionalProperties":true,"default":{},"title":"Params","type":"object"},"signal_type":{"title":"Signal Type","type":"string"},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Timeframe"}},"required":["name","signal_type"],"title":"SignalSpec","type":"object"},"SimulateRunRequest":{"description":"Request body for POST /simulate/run.","properties":{"backtest_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backtest End"},"backtest_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backtest Start"},"config_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Config Hash"},"currency":{"default":"USD","title":"Currency","type":"string"},"data_file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data File Path"},"dataset_file":{"title":"Dataset File","type":"string"},"experiment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Experiment Id"},"run_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Run Index"},"strategy_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Strategy Config"}},"required":["dataset_file"],"title":"SimulateRunRequest","type":"object"},"SimulationConfigRequest":{"description":"Request body for POST /simulate/generate.","properties":{"agent_capital":{"anyOf":[{"exclusiveMinimum":0.0,"type":"number"},{"type":"null"}],"title":"Agent Capital"},"base_liquidity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Base Liquidity"},"currency":{"default":"USD","title":"Currency","type":"string"},"drift_bearish":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Drift Bearish"},"drift_bullish":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Drift Bullish"},"drift_neutral":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Drift Neutral"},"duration_days":{"anyOf":[{"maximum":365.0,"minimum":1.0,"type":"integer"},{"type":"null"}],"title":"Duration Days"},"hourly_volatility":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Hourly Volatility"},"impact":{"anyOf":[{"$ref":"#/components/schemas/ImpactConfigRequest"},{"type":"null"}]},"impact_coefficient":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Impact Coefficient"},"initial_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Initial Price"},"liquidity":{"anyOf":[{"$ref":"#/components/schemas/LiquidityConfigRequest"},{"type":"null"}]},"liquidity_recovery_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liquidity Recovery Rate"},"market_condition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Condition"},"market_condition_config":{"anyOf":[{"$ref":"#/components/schemas/MarketConditionConfigRequest"},{"type":"null"}]},"n_agents":{"anyOf":[{"maximum":5000.0,"minimum":10.0,"type":"integer"},{"type":"null"}],"title":"N Agents"},"preset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"}},"title":"SimulationConfigRequest","type":"object"},"StrategyBacktestResult":{"description":"Per-strategy result within a bulk backtest response.","properties":{"base_token":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Base token of the feed, e.g. BTC. Supply with quote_token and market_data_venue.","examples":["BTC"],"title":"Base Token"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"execution_time_seconds":{"title":"Execution Time Seconds","type":"number"},"market_data_venue":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Venue whose order book the feed comes from, e.g. BINANCE. Supply with base_token and quote_token.","examples":["BINANCE"],"title":"Market Data Venue"},"metrics":{"additionalProperties":true,"title":"Metrics","type":"object"},"quote_token":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Quote token of the feed, e.g. USDC. Supply with base_token and market_data_venue.","examples":["USDC"],"title":"Quote Token"},"strategy_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Strategy Id"},"strategy_name":{"title":"Strategy Name","type":"string"},"success":{"title":"Success","type":"boolean"},"trade_count":{"title":"Trade Count","type":"integer"}},"required":["success","strategy_name","metrics","trade_count","execution_time_seconds"],"title":"StrategyBacktestResult","type":"object"},"StrategyInput":{"description":"MangroveAI-shaped strategy.\n\n``execution_config`` may omit ``reward_factor`` / ``max_risk_per_trade``;\ndefaults are pulled from ``data/defaults/trading_defaults.json`` before\nencoding.","properties":{"asset":{"title":"Asset","type":"string"},"entry":{"items":{"$ref":"#/components/schemas/SignalSpec"},"title":"Entry","type":"array"},"execution_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Execution Config"},"exit":{"items":{"$ref":"#/components/schemas/SignalSpec"},"title":"Exit","type":"array"}},"required":["asset","entry","exit"],"title":"StrategyInput","type":"object"},"StudyRequest":{"description":"One strategy, one condition, one study.","properties":{"condition":{"additionalProperties":true,"description":"Labels to match: direction, volatility, trend.","title":"Condition","type":"object"},"include_gapped":{"default":false,"description":"Include windows with missing bars","title":"Include Gapped","type":"boolean"},"launch":{"default":true,"description":"Launch immediately after validating","title":"Launch","type":"boolean"},"n":{"default":10,"description":"How many windows to run","maximum":50.0,"minimum":1.0,"title":"N","type":"integer"},"name":{"default":"","description":"Study name. Defaults to strategy + condition.","title":"Name","type":"string"},"strategy":{"additionalProperties":true,"description":"The strategy to run unchanged: asset, timeframe, entry[], exit[], exec_config, and optionally source_strategy_id and name. Every signal must run at the study's timeframe.","title":"Strategy","type":"object"}},"required":["strategy"],"title":"StudyRequest","type":"object"},"ValidationError":{"properties":{"ctx":{"title":"Context","type":"object"},"input":{"title":"Input"},"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}},"securitySchemes":{"MangroveBearer":{"description":"A Mangrove API key; keep it server-side.","scheme":"bearer","type":"http"}}},"info":{"description":"Public Oracle paths reachable through MangroveAI. API keys use Bearer authentication; tenant, scopes, entitlements and billing are enforced by the server. The upstream source revision is pinned in x-mangrove-provenance. Retail-adapted operations have intentionally opaque request/response schemas until their adapter envelopes are modelled; upstream declarations are retained only as x-mangrove-upstream-contract evidence. This file does not assert deployed upstream parity.","title":"MangroveAI Oracle proxy API","version":"0.1.0"},"openapi":"3.1.0","paths":{"/api/v1/oracle/backtest":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_run_backtest_api_v1_backtest_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"400":{"description":"Missing required fields, invalid date format or invalid market fields"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"description":"The requested market has no history covering the window and warm-up"},"429":{"description":"Rate, quota or concurrency limit reached"},"500":{"description":"Backtest engine failure"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Engine busy with another synchronous backtest; retry or use /backtest/async"},"504":{"description":"Oracle request timed out"}},"summary":"Run a single backtest","tags":["backtest"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestResult"}}},"description":"Successful Response"},"400":{"description":"Missing required fields, invalid date format or invalid market fields"},"422":{"description":"The requested market has no history covering the window and warm-up"},"500":{"description":"Backtest engine failure"},"503":{"description":"Engine busy with another synchronous backtest; retry or use /backtest/async"}}}}},"/api/v1/oracle/backtest/async":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_submit_async_backtest_api_v1_backtest_async_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"400":{"description":"Missing required fields, invalid date format or invalid market fields"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Backtest thread pool is full \u2014 retry later"},"504":{"description":"Oracle request timed out"}},"summary":"Submit async backtest","tags":["backtest"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AsyncBacktestSubmission"}}},"description":"Successful Response"},"400":{"description":"Missing required fields, invalid date format or invalid market fields"},"503":{"description":"Backtest thread pool is full \u2014 retry later"}}}}},"/api/v1/oracle/backtest/async/{backtest_id}/status":{"get":{"description":"Check the status of an async backtest. Returns 'running', 'completed', or 'failed'. When completed, the response includes metrics, trade_history, trade_count, and execution_time_seconds. When failed, includes error_message.","operationId":"oracle_get_async_backtest_status_api_v1_backtest_async__backtest_id__status_get","parameters":[{"in":"path","name":"backtest_id","required":true,"schema":{"title":"Backtest Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AsyncBacktestStatus"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"404":{"description":"Backtest ID not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Poll async backtest status","tags":["backtest"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/backtest/bulk":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_run_bulk_backtest_api_v1_backtest_bulk_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"400":{"description":"Missing required fields, invalid dates, invalid strategy source or invalid market fields"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Run bulk backtests","tags":["backtest"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkBacktestRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkBacktestResult"}}},"description":"Successful Response"},"400":{"description":"Missing required fields, invalid dates, invalid strategy source or invalid market fields"}}}}},"/api/v1/oracle/backtest/validate":{"post":{"description":"Resolve the generation and verify selected-market coverage without submitting a run.","operationId":"oracle_validate_backtest_api_v1_backtest_validate_post","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Validate Backtest Api V1 Backtest Validate Post","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Validate Backtest","tags":["backtest"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/backtest/{backtest_id}":{"get":{"description":"Retrieve a completed backtest result by ID from the Redis-backed async store. Returns the full result including status, metrics, and trade history. Results live for 24h from submission (the configured TTL).","operationId":"oracle_get_backtest_result_api_v1_backtest__backtest_id__get","parameters":[{"in":"path","name":"backtest_id","required":true,"schema":{"title":"Backtest Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AsyncBacktestStatus"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"404":{"description":"Backtest not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Retrieve backtest result","tags":["backtest"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/backtest/{backtest_id}/trades":{"get":{"description":"Retrieve the trade history for a completed backtest. Returns individual trade records including entry/exit prices, timestamps, profit/loss, position size, and exit reasons (TP, SL, time-based, etc.).","operationId":"oracle_get_backtest_trades_api_v1_backtest__backtest_id__trades_get","parameters":[{"in":"path","name":"backtest_id","required":true,"schema":{"title":"Backtest Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestTradesResponse"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"404":{"description":"Backtest not found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Retrieve backtest trades","tags":["backtest"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/conditions":{"get":{"description":"The condition axes and the values the catalog holds, with window counts.\n\nNarrowed by ``asset``/``timeframe`` when given, so the counts say what that\nmarket actually covers rather than what the corpus covers overall. A value\nwith no windows is omitted rather than returned as zero.","operationId":"oracle_list_conditions_api_v1_conditions_get","parameters":[{"in":"query","name":"asset","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset"}},{"in":"query","name":"timeframe","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response List Conditions Api V1 Conditions Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Conditions","tags":["conditions"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/conditions/preview":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_preview_condition_api_v1_conditions_preview_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Preview Condition","tags":["conditions"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConditionPreviewRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Preview Condition Api V1 Conditions Preview Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/conditions/studies":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_create_study_api_v1_conditions_studies_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Create Study","tags":["conditions"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudyRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Create Study Api V1 Conditions Studies Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/conditions/studies/{study_id}":{"get":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_get_study_api_v1_conditions_studies__study_id__get","parameters":[{"in":"path","name":"study_id","required":true,"schema":{"title":"Study Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Study","tags":["conditions"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Study Api V1 Conditions Studies  Study Id  Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/conditions/studies/{study_id}/billing-evidence":{"get":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_get_study_billing_evidence_api_v1_conditions_studies__study_id__billing_evidence_get","parameters":[{"in":"path","name":"study_id","required":true,"schema":{"title":"Study Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Study Billing Evidence","tags":["conditions"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Study Billing Evidence Api V1 Conditions Studies  Study Id  Billing Evidence Get","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/data/query":{"post":{"description":"Constrained DSL over the experiment results / OHLCV corpus. ``WHERE org_id = <caller>`` is enforced server-side; clients cannot read another tenant's rows. ``maximum_bytes_billed`` is capped per query so a single call cannot scan the corpus unboundedly. Each successful query records a `bq_query` billing event with the actual `total_bytes_billed` from BigQuery.","operationId":"oracle_query_data_api_v1_data_query_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResponse"}}},"description":"Successful Response"},"400":{"description":"DSL validation failed or query exceeds scan cap"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller lacks `data:query` scope"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Query the experiment corpus","tags":["data","data"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/datasets":{"get":{"description":"List the windows a sweep can select, with regime labels where we have them.\n\nA window is listed only when its market's series covers it and its warm-up\n(``series_coverage.runnable``); the verdict comes from the series index,\nnever from a series. Labels are attached here rather than inside ``discover_datasets`` because the\nregime labeller itself enumerates the catalog \u2014 having discovery read the table\nit is about to write would be circular.\n\nCached, because the dataset picker calls this on mount and discovery reads every\nCSV in the corpus to count bars (5.5s for 4,103 files). Off the event loop for the\nsame reason: a 5s synchronous walk in an async handler blocks every other request\non the worker, and this endpoint is not the only thing the Configure view loads.\n\nThe cache is keyed on the catalog generation as well as the clock. Every cache\nhere is a module global, so a create invalidates only the process that served\nit, and a deployment runs more than one. The manifest is rewritten by every\ncreate, so its generation reports whether any instance has changed the catalog,\nat the cost of one metadata call per listing.","operationId":"oracle_list_datasets_api_v1_datasets_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"title":"Response List Datasets Api V1 Datasets Get","type":"array"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Datasets","tags":["datasets"],"x-mangrove-schema-status":"upstream-declaration"},"post":{"description":"Create one window of a market's series and register it as a dataset.\n\nThe window is a span of the venue's series; a market with no series on the\nvenue gets one first, seeded from the venue's history source (the response\nnames it in ``seeded``). A start the series cannot warm up is refused with\n422 and the earliest start it can; a history source that does not answer\nis 503. Idempotent on the resulting filename.\n\nA range longer than MAX_BARS bars is shortened to the whole days that fit,\nand the shortening is reported in the response warnings.","operationId":"oracle_create_dataset_api_v1_datasets_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDatasetRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Create Dataset Api V1 Datasets Post","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Create Dataset","tags":["datasets"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/datasets/detailed":{"get":{"description":"List available OHLCV data files with price statistics (cached 5min).","operationId":"oracle_list_datasets_detailed_api_v1_datasets_detailed_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"title":"Response List Datasets Detailed Api V1 Datasets Detailed Get","type":"array"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Datasets Detailed","tags":["datasets"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/datasets/limits":{"get":{"description":"The builder's cap, readable before a build.\n\nThe create response carries ``max_bars`` too, but that is after the fact:\nthe panel disables an over-long range BEFORE the user spends a build on a\nwindow they did not ask for, so it needs the number up front. Served rather\nthan mirrored: both UIs hardcoded a copy once, and the copies drifted.","operationId":"oracle_dataset_limits_api_v1_datasets_limits_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Dataset Limits Api V1 Datasets Limits Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Dataset Limits","tags":["datasets"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/datasets/ohlcv/{filename}":{"get":{"description":"The candles of one window: its span of its series.","operationId":"oracle_get_dataset_ohlcv_api_v1_datasets_ohlcv__filename__get","parameters":[{"in":"path","name":"filename","required":true,"schema":{"title":"Filename","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Dataset Ohlcv Api V1 Datasets Ohlcv  Filename  Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Dataset Ohlcv","tags":["datasets"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/deployed/strategies":{"get":{"description":"List all deployed strategies with merged registry + state + portfolio.\n\nMerges:\n- Registry entries from leaderboard.json (name, avatar, strategy config)\n- Redis state hashes (last tick, health, equity from sidecar)\n- Portfolio snapshot from MangroveAI (positions, trades via httpx)","operationId":"oracle_list_deployed_strategies_api_v1_deployed_strategies_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response List Deployed Strategies Api V1 Deployed Strategies Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Deployed Strategies","tags":["deployed"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/deployed/stream":{"get":{"description":"SSE endpoint for real-time deployed strategy events.\n\nSubscribes to the Redis pub/sub channel `mangrove:deployed:events` and\nforwards each message as an SSE event. Uses the existing leaderboard SSE\npattern (StreamingResponse with text/event-stream).\n\nSingle SSE bus -- the `type` field inside each event discriminates:\n- deployed-tick: a strategy evaluation completed\n- deployed-fire: a signal fired and an order was placed\n- deployed-error: an evaluation error occurred\n- deployed-heartbeat: periodic liveness pulse","operationId":"oracle_stream_deployed_events_api_v1_deployed_stream_get","parameters":[],"responses":{"200":{"content":{"text/event-stream":{"schema":{"type":"string"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Stream Deployed Events","tags":["deployed"],"x-mangrove-schema-status":"proxy-sse-stream"}},"/api/v1/oracle/deployed/{strategy_id}/events":{"get":{"description":"Last N events from the strategy's Redis Stream (eval log).\n\nReturns events in chronological order (oldest first).","operationId":"oracle_get_strategy_events_api_v1_deployed__strategy_id__events_get","parameters":[{"in":"path","name":"strategy_id","required":true,"schema":{"title":"Strategy Id","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":500,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Strategy Events Api V1 Deployed  Strategy Id  Events Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Strategy Events","tags":["deployed"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/deployed/{strategy_id}/state":{"get":{"description":"Per-strategy current equity, open positions, last tick, health status.\n\nReads from the sidecar's Redis hash. Returns 503 if Redis is unavailable,\n404 if the strategy has no state in Redis.","operationId":"oracle_get_strategy_state_api_v1_deployed__strategy_id__state_get","parameters":[{"in":"path","name":"strategy_id","required":true,"schema":{"title":"Strategy Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Strategy State Api V1 Deployed  Strategy Id  State Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Strategy State","tags":["deployed"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/exec-config/defaults":{"get":{"description":"Return the default execution config, flat, plus a ``__sections__`` guide.\n\nReads the canon trading_defaults.json (pinned MangroveAI). The response is\nthe flat merged dict (backward-compatible \u2014 this is what create-experiment\nconsumes as ``execution_config.base``), with one additive key:\n\n``__sections__``: an ordered list of ``{key, label, params}`` derived from\nthe canon section structure (dropped/empty sections omitted). The builder\nuses it to render controls grouped EXACTLY as they are sectioned in\ntrading_defaults.json. Consumers that only want values ignore it; the UI\nstrips it before using the rest as ``base``.","operationId":"oracle_get_exec_config_defaults_api_v1_exec_config_defaults_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Exec Config Defaults Api V1 Exec Config Defaults Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Exec Config Defaults","tags":["exec-config"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments":{"get":{"description":"List experiments the caller may see \u2014 summary view, no live progress.\n\nReturns only the persisted config fields. Live progress (parquet\nflush count, reconciled \"running\" \u2192 \"completed\" transitions) is\nexpensive: each experiment requires a separate GCS LIST call. The\nprior implementation did this in an N+1 loop and pushed past the\ngateway 60s timeout once the experiment catalog grew past ~50\nentries (observed on prod 2026-05-31: 504 upstream timeout).\n\nCallers needing live progress should hit\n``GET /experiments/{experiment_id}`` per experiment of interest\n\u2014 that endpoint does the GCS read once for the single row the\ncaller is actually inspecting.\n\nThe ``status`` field here reflects the last-persisted state on\nthe config row. For a \"running\" experiment it may lag the actual\nGCS parquet-count state until the next progress poll reconciles\nit. ``completed`` is populated from ONE grouped native-table query\n(finalized sweeps only \u2014 the native table fills at finalize); for\nin-flight or unmerged experiments it stays None so callers don't\ntreat the list view as a live-progress source.\n\nSync on purpose: FastAPI runs a sync handler in its threadpool, so the\nblocking store read below never holds the event loop (#588).","operationId":"oracle_list_experiments_api_v1_experiments_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"title":"Response List Experiments Api V1 Experiments Get","type":"array"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Experiments","tags":["experiments"],"x-mangrove-schema-status":"upstream-declaration"},"post":{"description":"Create a new experiment in draft status.\n\nStamps ``org_id`` and ``user_id`` from validated request context.\nInternal callers (no proxy headers) default to the Mangrove Admin /\nMangrove Team seed UUIDs from ``src/shared/org_constants.py``. The\nbody's ``org_id`` / ``user_id`` are overridden by the request context\nso customers can't write to another tenant's experiments via the JSON\nbody.","operationId":"oracle_create_experiment_api_v1_experiments_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentConfig"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Create Experiment Api V1 Experiments Post","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Create Experiment","tags":["experiments"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/caps":{"get":{"description":"The per-sweep caps THIS caller will actually be judged against.\n\nRead straight off ``request.state`` \u2014 the very values\n``validate_experiment`` gates on, injected by the upstream proxy from the\ncaller's tier. A client that displays these cannot show a limit the gate\ndoes not apply.\n\nIt exists because the builder carried its own copy of the tier table, with\na hardcoded number per tier. When the caller's forwarded tier and the\nclient's idea of it disagreed, the wizard sized a sweep to 5,000 runs that\nthe gate then refused at 1,000 \u2014 and the wizard had no candle number at\nall, so the candle cap could only ever be discovered by being rejected.\n\n``0`` means no cap is enforced for this caller (internal callers, and any\nproxy that injects no cap headers). ``-1`` means unlimited.","operationId":"oracle_sweep_caps_api_v1_experiments_caps_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"integer"},"title":"Response Sweep Caps Api V1 Experiments Caps Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Sweep Caps","tags":["experiments"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/estimate":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_estimate_experiment_api_v1_experiments_estimate_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Estimate Experiment","tags":["experiments"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentConfig"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Estimate Experiment Api V1 Experiments Estimate Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/generations":{"get":{"description":"The cohort labels a new experiment may be stamped with.\n\n``known`` is the described catalog from src/shared/generations.py;\n``observed`` is every generation actually stamped on an experiment the\ncaller can see, so a number someone entered ad hoc in the builder still\ncomes back and can be picked again. The builder renders the union and never\ncarries a list of its own \u2014 a hardcoded copy is what mislabeled the gen-4\n(#394) and gen-5 cohorts.","operationId":"oracle_list_generations_api_v1_experiments_generations_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response List Generations Api V1 Experiments Generations Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Generations","tags":["experiments"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/shared":{"get":{"description":"Experiments that grant access to one org or user. Operator only.","operationId":"oracle_list_shared_experiments_api_v1_experiments_shared_get","parameters":[{"in":"query","name":"principal_type","required":true,"schema":{"enum":["org","user"],"title":"Principal Type","type":"string"}},{"in":"query","name":"principal_id","required":true,"schema":{"title":"Principal Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"title":"Response List Shared Experiments Api V1 Experiments Shared Get","type":"array"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Shared Experiments","tags":["experiments"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/shared-with-me":{"get":{"description":"Completed experiments other orgs have shared with the caller.\n\nScans every org's configs for grants naming the caller; the scan result is\ncached per instance (see ``executor.list_experiments_granted_to``).","operationId":"oracle_list_experiments_shared_with_me_api_v1_experiments_shared_with_me_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"title":"Response List Experiments Shared With Me Api V1 Experiments Shared With Me Get","type":"array"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Experiments Shared With Me","tags":["experiments"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}":{"delete":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_delete_experiment_api_v1_experiments__experiment_id__delete","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Delete Experiment","tags":["experiments"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Delete Experiment Api V1 Experiments  Experiment Id  Delete","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}},"get":{"description":"Get experiment detail including full config.\n\nSync on purpose: FastAPI runs a sync handler in its threadpool, so the\nblocking store read below never holds the event loop (#588).","operationId":"oracle_get_experiment_api_v1_experiments__experiment_id__get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Experiment Api V1 Experiments  Experiment Id  Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Experiment","tags":["experiments"],"x-mangrove-schema-status":"upstream-declaration"},"put":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_update_experiment_api_v1_experiments__experiment_id__put","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Update Experiment","tags":["experiments"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentConfig"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Update Experiment Api V1 Experiments  Experiment Id  Put","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/{experiment_id}/billing-evidence":{"get":{"operationId":"oracle_get_engine_billing_evidence_api_v1_experiments__experiment_id__billing_evidence_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Engine Billing Evidence Api V1 Experiments  Experiment Id  Billing Evidence Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Engine Billing Evidence","tags":["experiments"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/billing-plan":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_prepare_engine_billing_plan_api_v1_experiments__experiment_id__billing_plan_post","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Prepare Engine Billing Plan","tags":["experiments"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Prepare Engine Billing Plan Api V1 Experiments  Experiment Id  Billing Plan Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/{experiment_id}/grants":{"get":{"description":"The orgs and users an experiment is shared with. Operator only.","operationId":"oracle_list_grants_api_v1_experiments__experiment_id__grants_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response List Grants Api V1 Experiments  Experiment Id  Grants Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Grants","tags":["experiments"],"x-mangrove-schema-status":"upstream-declaration"},"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_add_grant_api_v1_experiments__experiment_id__grants_post","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Add Grant","tags":["experiments"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Add Grant Api V1 Experiments  Experiment Id  Grants Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/{experiment_id}/grants/{principal_type}/{principal_id}":{"delete":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_remove_grant_api_v1_experiments__experiment_id__grants__principal_type___principal_id__delete","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"principal_type","required":true,"schema":{"enum":["org","user"],"title":"Principal Type","type":"string"}},{"in":"path","name":"principal_id","required":true,"schema":{"title":"Principal Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Remove Grant","tags":["experiments"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Remove Grant Api V1 Experiments  Experiment Id  Grants  Principal Type   Principal Id  Delete","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/{experiment_id}/launch":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_launch_experiment_api_v1_experiments__experiment_id__launch_post","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Launch Experiment","tags":["experiments"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Launch Experiment Api V1 Experiments  Experiment Id  Launch Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/{experiment_id}/pause":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_pause_experiment_api_v1_experiments__experiment_id__pause_post","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Pause Experiment","tags":["experiments"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Pause Experiment Api V1 Experiments  Experiment Id  Pause Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/{experiment_id}/progress":{"get":{"description":"Return current progress as JSON (polled by Monitor tab).\n\nSync on purpose: FastAPI runs a sync handler in its threadpool, so the\nblocking store read below never holds the event loop (#588).","operationId":"oracle_get_progress_api_v1_experiments__experiment_id__progress_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Progress","tags":["progress"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/progress/stream":{"get":{"description":"Server-Sent Events stream for real-time experiment progress.\n\nTries Redis Streams first. Falls back to polling Parquet file counts\nif Redis is unavailable.","operationId":"oracle_stream_progress_api_v1_experiments__experiment_id__progress_stream_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"text/event-stream":{"schema":{"type":"string"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Stream Progress","tags":["progress"],"x-mangrove-schema-status":"proxy-sse-stream"}},"/api/v1/oracle/experiments/{experiment_id}/results":{"get":{"description":"Query experiment results with server-side filters, sort, and pagination.\n\nResults are cached in Redis. Same filter+sort+offset returns cached data.\nChanging any param creates a new cache entry without invalidating old ones.\n\nSync on purpose: FastAPI runs a sync handler in its threadpool, so the\nblocking store read below never holds the event loop (#588).","operationId":"oracle_query_experiment_results_api_v1_experiments__experiment_id__results_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"query","name":"asset","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset"}},{"in":"query","name":"asset_b","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset B"}},{"in":"query","name":"timeframe","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"}},{"in":"query","name":"trigger_name","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger Name"}},{"in":"query","name":"kind","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"min_trades","required":false,"schema":{"default":0,"title":"Min Trades","type":"integer"}},{"in":"query","name":"min_sharpe","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Sharpe"}},{"in":"query","name":"min_win_rate","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Win Rate"}},{"in":"query","name":"min_return","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Return"}},{"in":"query","name":"min_irr","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Irr"}},{"in":"query","name":"min_delta_vs_benchmark","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Delta Vs Benchmark"}},{"in":"query","name":"min_delta_vs_asset","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Delta Vs Asset"}},{"in":"query","name":"max_trades","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Trades"}},{"in":"query","name":"max_sharpe","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Sharpe"}},{"in":"query","name":"max_win_rate","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Win Rate"}},{"in":"query","name":"max_return","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Return"}},{"in":"query","name":"max_irr","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Irr"}},{"in":"query","name":"max_delta_vs_benchmark","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Delta Vs Benchmark"}},{"in":"query","name":"max_delta_vs_asset","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Delta Vs Asset"}},{"in":"query","name":"min_gain_to_pain","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Gain To Pain"}},{"in":"query","name":"max_gain_to_pain","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Gain To Pain"}},{"in":"query","name":"min_peak_drawdown","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Peak Drawdown"}},{"in":"query","name":"max_peak_drawdown","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Peak Drawdown"}},{"in":"query","name":"min_current_drawdown","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Current Drawdown"}},{"in":"query","name":"max_current_drawdown","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Current Drawdown"}},{"in":"query","name":"run_index","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Run Index"}},{"in":"query","name":"reward_factor","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reward Factor"}},{"in":"query","name":"cooldown_bars","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cooldown Bars"}},{"in":"query","name":"atr_period","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Atr Period"}},{"in":"query","name":"max_risk_per_trade","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Risk Per Trade"}},{"in":"query","name":"beats_benchmarks","required":false,"schema":{"default":false,"title":"Beats Benchmarks","type":"boolean"}},{"in":"query","name":"beats_legs","required":false,"schema":{"default":false,"title":"Beats Legs","type":"boolean"}},{"in":"query","name":"beats_fifty_fifty","required":false,"schema":{"default":false,"title":"Beats Fifty Fifty","type":"boolean"}},{"in":"query","name":"beats_crypto_benchmarks","required":false,"schema":{"default":false,"title":"Beats Crypto Benchmarks","type":"boolean"}},{"in":"query","name":"coverage_date","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverage Date"}},{"in":"query","name":"coverage_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverage From"}},{"in":"query","name":"coverage_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverage To"}},{"in":"query","name":"generation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generation"}},{"in":"query","name":"direction","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"}},{"in":"query","name":"volatility","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Volatility"}},{"in":"query","name":"trend","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend"}},{"in":"query","name":"regime_composite","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Regime Composite"}},{"in":"query","name":"sort","required":false,"schema":{"default":"sharpe_ratio","title":"Sort","type":"string"}},{"in":"query","name":"order","required":false,"schema":{"default":"desc","title":"Order","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":500,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Query Experiment Results Api V1 Experiments  Experiment Id  Results Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Query Experiment Results","tags":["results"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/results/filters":{"get":{"description":"Return the distinct values of every filterable column for one experiment.\n\nTenant access enforced by the router-level require_experiment_access dependency.\n\nSync on purpose: FastAPI runs a sync handler in its threadpool, so the\nblocking store read below never holds the event loop (#588).","operationId":"oracle_get_experiment_filter_options_api_v1_experiments__experiment_id__results_filters_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Experiment Filter Options Api V1 Experiments  Experiment Id  Results Filters Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Experiment Filter Options","tags":["results"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/results/{run_index}/ohlcv":{"get":{"description":"Return OHLCV candle data for a result's data file (no backtest needed).","operationId":"oracle_get_ohlcv_api_v1_experiments__experiment_id__results__run_index__ohlcv_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"run_index","required":true,"schema":{"title":"Run Index","type":"integer"}},{"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","in":"query","name":"config_hash","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","title":"Config Hash"}},{"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","in":"query","name":"data_file_path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","title":"Data File Path"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Ohlcv Api V1 Experiments  Experiment Id  Results  Run Index  Ohlcv Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Ohlcv","tags":["results"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/results/{run_index}/replay/at-original-code":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_replay_at_original_code_endpoint_api_v1_experiments__experiment_id__results__run_index__replay_at_original_code_post","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"run_index","required":true,"schema":{"title":"Run Index","type":"integer"}},{"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","in":"query","name":"config_hash","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","title":"Config Hash"}},{"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","in":"query","name":"data_file_path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","title":"Data File Path"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Replay At Original Code Endpoint","tags":["replay"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplayResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/{experiment_id}/results/{run_index}/replay/at-original-code/async":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_replay_at_original_code_async_api_v1_experiments__experiment_id__results__run_index__replay_at_original_code_async_post","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"run_index","required":true,"schema":{"title":"Run Index","type":"integer"}},{"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","in":"query","name":"config_hash","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","title":"Config Hash"}},{"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","in":"query","name":"data_file_path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","title":"Data File Path"}}],"responses":{"202":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Submit replay-at-original-code asynchronously","tags":["replay"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"202":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Replay At Original Code Async Api V1 Experiments  Experiment Id  Results  Run Index  Replay At Original Code Async Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/{experiment_id}/results/{run_index}/replay/on-latest":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_replay_on_latest_endpoint_api_v1_experiments__experiment_id__results__run_index__replay_on_latest_post","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"run_index","required":true,"schema":{"title":"Run Index","type":"integer"}},{"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","in":"query","name":"config_hash","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","title":"Config Hash"}},{"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","in":"query","name":"data_file_path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","title":"Data File Path"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Replay On Latest Endpoint","tags":["replay"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RerunResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/experiments/{experiment_id}/results/{run_index}/signals":{"get":{"description":"Apply entry/exit signals against OHLCV data and return firing timestamps.\n\nPure pandas operation using mangrove_kb RuleRegistry -- no backtest engine.\nReturns in <1s, enabling instant signal overlay while backtest runs.","operationId":"oracle_run_signal_evaluation_api_v1_experiments__experiment_id__results__run_index__signals_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"run_index","required":true,"schema":{"title":"Run Index","type":"integer"}},{"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","in":"query","name":"config_hash","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","title":"Config Hash"}},{"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","in":"query","name":"data_file_path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","title":"Data File Path"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Run Signal Evaluation Api V1 Experiments  Experiment Id  Results  Run Index  Signals Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Run Signal Evaluation","tags":["results"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/results/{run_index}/stored-visualization":{"get":{"description":"Read archived chart artifacts; this route never executes a backtest.","operationId":"oracle_read_stored_visualization_api_v1_experiments__experiment_id__results__run_index__stored_visualization_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"run_index","required":true,"schema":{"title":"Run Index","type":"integer"}},{"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","in":"query","name":"config_hash","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","title":"Config Hash"}},{"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","in":"query","name":"data_file_path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","title":"Data File Path"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Read Stored Visualization Api V1 Experiments  Experiment Id  Results  Run Index  Stored Visualization Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Read Stored Visualization","tags":["results"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/results/{run_index}/strategy":{"get":{"description":"Return the reconstructed strategy config JSON for a single run.\n\nNo backtest re-run needed -- reconstructs from stored Parquet columns.","operationId":"oracle_get_strategy_config_api_v1_experiments__experiment_id__results__run_index__strategy_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"run_index","required":true,"schema":{"title":"Run Index","type":"integer"}},{"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","in":"query","name":"config_hash","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","title":"Config Hash"}},{"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","in":"query","name":"data_file_path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","title":"Data File Path"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Strategy Config Api V1 Experiments  Experiment Id  Results  Run Index  Strategy Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Strategy Config","tags":["results"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/results/{run_index}/trades":{"get":{"description":"First-class query surface for persisted per-run trades (#370).\n\nSync on purpose: the trades read can download many chunk files, and an\n``async`` handler doing that blocking read held the event loop, so every\nother request to the instance (a 50ms ``/strategy``) waited it out. FastAPI\nruns a sync handler in its threadpool (same reasoning as #588).\n\nReads the trades parquet persisted at sweep time (#359) from\n``cloud/trades/org_id=<X>/<exp>/**`` (keyed by ``run_index``) instead of\nre-running the backtest \u2014 unlike ``visualize``, which embeds trades in a\nchart response. Tenant access is enforced by the router-level\n``require_experiment_access`` dependency; the org partition is the owning\norg of the experiment, which the sweep stamps on every trade. Rows are\nreturned in stable ``entry_timestamp`` order,\npaginated by ``limit``/``offset``.\n\nAn optional timezone-aware ``as_of`` freezes pagination to the same\nsnapshot as result curves. Only known entry timestamps after the cutoff\nare excluded; rows with absent or malformed timestamps remain inspectable.\n\n``persisted=false`` means the experiment predates trade persistence (no\nartifact); callers wanting trades for those should use the visualize\nendpoint, which re-runs to regenerate them.\n\nTrade rows are keyed by ``run_index`` alone, and an index can name several\nruns (MangroveOracle#782). Such an index answers 409 ``ambiguous_run`` unless\n``config_hash``/``data_file_path`` names one; a named run's trades are read\nby the config_hash stamped on each trade row, or -- trades written before\nthe stamp -- from its own dataset_key, and when another run at the index\nshares that dataset_key the trades cannot be split and the answer is 409\n``run_trades_not_separable`` -- never the two runs' trades merged.","operationId":"oracle_get_run_trades_api_v1_experiments__experiment_id__results__run_index__trades_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"run_index","required":true,"schema":{"title":"Run Index","type":"integer"}},{"in":"query","name":"limit","required":false,"schema":{"default":500,"maximum":5000,"minimum":1,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},{"in":"query","name":"as_of","required":false,"schema":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"As Of"}},{"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","in":"query","name":"config_hash","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","title":"Config Hash"}},{"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","in":"query","name":"data_file_path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","title":"Data File Path"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Run Trades Api V1 Experiments  Experiment Id  Results  Run Index  Trades Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Run Trades","tags":["results"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/results/{run_index}/visualize":{"get":{"description":"Run a backtest and return full visualization data.\n\nResults are persisted to disk on first execution. Subsequent requests\nreturn the cached result instantly. Pass force=true to re-execute.","operationId":"oracle_visualize_result_api_v1_experiments__experiment_id__results__run_index__visualize_get","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}},{"in":"path","name":"run_index","required":true,"schema":{"title":"Run Index","type":"integer"}},{"in":"query","name":"force","required":false,"schema":{"default":false,"title":"Force","type":"boolean"}},{"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","in":"query","name":"config_hash","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's config_hash, from its result row. run_index alone can name several runs of one experiment; with more than one match and no disambiguator the route answers 409 listing the candidates.","title":"Config Hash"}},{"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","in":"query","name":"data_file_path","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The run's data_file_path (file name), from its result row; narrows like config_hash.","title":"Data File Path"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Visualize Result Api V1 Experiments  Experiment Id  Results  Run Index  Visualize Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Visualize Result","tags":["results"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/experiments/{experiment_id}/validate":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_validate_experiment_api_v1_experiments__experiment_id__validate_post","parameters":[{"in":"path","name":"experiment_id","required":true,"schema":{"title":"Experiment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Validate Experiment","tags":["experiments"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Validate Experiment Api V1 Experiments  Experiment Id  Validate Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/results":{"get":{"description":"Query results across all experiments (or a specific one).\n\nSync on purpose: FastAPI runs a sync handler in its threadpool, so the\nblocking store read below never holds the event loop (#588).","operationId":"oracle_query_all_results_api_v1_results_get","parameters":[{"in":"query","name":"experiment_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Experiment Id"}},{"in":"query","name":"asset","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset"}},{"in":"query","name":"asset_b","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset B"}},{"in":"query","name":"timeframe","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"}},{"in":"query","name":"trigger_name","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger Name"}},{"in":"query","name":"kind","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"in":"query","name":"status","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"in":"query","name":"min_trades","required":false,"schema":{"default":0,"title":"Min Trades","type":"integer"}},{"in":"query","name":"min_sharpe","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Sharpe"}},{"in":"query","name":"min_win_rate","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Win Rate"}},{"in":"query","name":"min_return","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Return"}},{"in":"query","name":"min_irr","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Irr"}},{"in":"query","name":"min_delta_vs_benchmark","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Delta Vs Benchmark"}},{"in":"query","name":"min_delta_vs_asset","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Delta Vs Asset"}},{"in":"query","name":"max_trades","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Trades"}},{"in":"query","name":"max_sharpe","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Sharpe"}},{"in":"query","name":"max_win_rate","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Win Rate"}},{"in":"query","name":"max_return","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Return"}},{"in":"query","name":"max_irr","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Irr"}},{"in":"query","name":"max_delta_vs_benchmark","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Delta Vs Benchmark"}},{"in":"query","name":"max_delta_vs_asset","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Delta Vs Asset"}},{"in":"query","name":"min_gain_to_pain","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Gain To Pain"}},{"in":"query","name":"max_gain_to_pain","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Gain To Pain"}},{"in":"query","name":"min_peak_drawdown","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Peak Drawdown"}},{"in":"query","name":"max_peak_drawdown","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Peak Drawdown"}},{"in":"query","name":"min_current_drawdown","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Current Drawdown"}},{"in":"query","name":"max_current_drawdown","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Current Drawdown"}},{"in":"query","name":"run_index","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Run Index"}},{"in":"query","name":"beats_benchmarks","required":false,"schema":{"default":false,"title":"Beats Benchmarks","type":"boolean"}},{"in":"query","name":"beats_legs","required":false,"schema":{"default":false,"title":"Beats Legs","type":"boolean"}},{"in":"query","name":"beats_fifty_fifty","required":false,"schema":{"default":false,"title":"Beats Fifty Fifty","type":"boolean"}},{"in":"query","name":"beats_crypto_benchmarks","required":false,"schema":{"default":false,"title":"Beats Crypto Benchmarks","type":"boolean"}},{"in":"query","name":"coverage_date","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverage Date"}},{"in":"query","name":"coverage_from","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverage From"}},{"in":"query","name":"coverage_to","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coverage To"}},{"in":"query","name":"generation","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generation"}},{"in":"query","name":"direction","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction"}},{"in":"query","name":"volatility","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Volatility"}},{"in":"query","name":"trend","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend"}},{"in":"query","name":"regime_composite","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Regime Composite"}},{"in":"query","name":"sort","required":false,"schema":{"default":"irr_annualized","title":"Sort","type":"string"}},{"in":"query","name":"order","required":false,"schema":{"default":"desc","title":"Order","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":500,"title":"Limit","type":"integer"}},{"in":"query","name":"offset","required":false,"schema":{"default":0,"title":"Offset","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Query All Results Api V1 Results Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Query All Results","tags":["results-global"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/results/filters":{"get":{"description":"Return distinct filter values across the caller's visible experiments.\n\nWith ``experiment_id``, across that one experiment only (404 if the caller\nmay not see it). Sync on purpose: FastAPI runs a sync handler in its\nthreadpool, so the blocking store read below never holds the event loop (#588).","operationId":"oracle_get_global_filter_options_api_v1_results_filters_get","parameters":[{"in":"query","name":"experiment_id","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Experiment Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Global Filter Options Api V1 Results Filters Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Global Filter Options","tags":["results-global"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/sieve/score":{"post":{"description":"Run candidate strategies through the Mangrove SIEVE go/no-go gate and return predicted probabilities. Accepts either a list of MangroveAI-shaped Strategy objects (`strategies`) or a list of raw run dicts (`runs`) \u2014 exactly one must be provided. Each response item carries the binary go/no-go head (`p_no_trades`, `p_trades`) \u2014 whether a strategy is worth backtesting (will it place trades). SIEVE does NOT predict performance; the retired 4-class outcome head is no longer returned. Responses are provenance-stamped with `model_version` (a content hash of the bundled artifacts) and `code_version` (Oracle + MangroveAI + KB + Roots refs). Per-request cap: 99 items.","operationId":"oracle_score_strategies_api_v1_sieve_score_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SieveScoreRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SieveScoreResponse"}}},"description":"Successful Response"},"400":{"description":"Both or neither of `strategies` / `runs` provided, or empty"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"413":{"description":"Per-request cap exceeded (>99 items)"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"SIEVE model unavailable (artifacts missing or load failed)"},"504":{"description":"Oracle request timed out"}},"summary":"Score strategies through the Mangrove SIEVE classifier","tags":["sieve"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/signals":{"get":{"description":"List available signals from the knowledge base.\n\nQuery params:\n    type: Filter by signal type (TRIGGER or FILTER).\n    search: Substring filter on signal name.\n    catalog: Keep only signals a selection catalogue names -- repeat it to\n        allow several, and a signal any one of them names is kept. Known\n        catalogues are ``indicators`` and ``candlestick_patterns``.","operationId":"oracle_list_signals_api_v1_signals_get","parameters":[{"in":"query","name":"type","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"in":"query","name":"search","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"in":"query","name":"catalog","required":false,"schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Catalog"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"title":"Response List Signals Api V1 Signals Get","type":"array"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Signals","tags":["signals"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/signals/catalogs":{"get":{"description":"The selection catalogues, resolved against the signals we have.\n\nEach entry carries the signals of it that are actually in the pool, so a\nchip built from this counts what selecting it would reach, and ``missing``\nnames anything the catalogue lists that the knowledge base no longer\noffers. ``sources`` is where the entry list was drawn from, so a selection\nmade with it can be traced back to what it was based on.","operationId":"oracle_list_catalogs_api_v1_signals_catalogs_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response List Catalogs Api V1 Signals Catalogs Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Catalogs","tags":["signals"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/signals/{name}":{"get":{"description":"Read a canonical or retired signal spelling and its runtime eligibility.","operationId":"oracle_get_signal_api_v1_signals__name__get","parameters":[{"in":"path","name":"name","required":true,"schema":{"title":"Name","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Signal Api V1 Signals  Name  Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Signal","tags":["signals"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/simulate/generate":{"post":{"description":"Run a simulation and produce an OHLCV dataset.\n\nIdempotent: same config produces same file (skips re-generation).","operationId":"oracle_generate_api_v1_simulate_generate_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationConfigRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateResponse"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Generate","tags":["simulate"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/simulate/history":{"get":{"description":"List previously generated simulation datasets.","operationId":"oracle_simulation_history_api_v1_simulate_history_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"title":"Response Simulation History Api V1 Simulate History Get","type":"array"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Simulation History","tags":["simulate"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/simulate/presets":{"get":{"description":"Return all simulation presets with parameter values.","operationId":"oracle_list_presets_api_v1_simulate_presets_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"title":"Response List Presets Api V1 Simulate Presets Get","type":"array"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Presets","tags":["simulate"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/simulate/run":{"post":{"description":"The proxy may adapt this operation for the caller's retail accounting workflow. Request/response envelopes remain opaque until those adapters are modelled. Inspect x-mangrove-upstream-contract for the pinned upstream declaration. Native backtest requests with explicit market selectors must instead use the canonical /api/v2/backtests/ or /api/v1/backtests surface.","operationId":"oracle_run_strategy_api_v1_simulate_run_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"402":{"description":"The retail usage limit was reached (error code RETAIL_USAGE_LIMIT). This is not an x402 payment challenge; the operation does not accept x402 payment."},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Run Strategy","tags":["simulate"],"x-mangrove-schema-status":"retail-adapter-envelope-unmodelled","x-mangrove-upstream-contract":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulateRunRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Run Strategy Api V1 Simulate Run Post","type":"object"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}}}}},"/api/v1/oracle/templates":{"get":{"description":"List saved experiment templates.","operationId":"oracle_list_templates_api_v1_templates_get","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"title":"Response List Templates Api V1 Templates Get","type":"array"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"List Templates","tags":["templates"],"x-mangrove-schema-status":"upstream-declaration"},"post":{"description":"Save an experiment config as a named template.","operationId":"oracle_save_template_api_v1_templates_post","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Body","type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Save Template Api V1 Templates Post","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Save Template","tags":["templates"],"x-mangrove-schema-status":"upstream-declaration"}},"/api/v1/oracle/templates/{name}":{"delete":{"description":"Delete a template.","operationId":"oracle_delete_template_api_v1_templates__name__delete","parameters":[{"in":"path","name":"name","required":true,"schema":{"title":"Name","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"title":"Response Delete Template Api V1 Templates  Name  Delete","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Delete Template","tags":["templates"],"x-mangrove-schema-status":"upstream-declaration"},"get":{"description":"Load a template by name.","operationId":"oracle_get_template_api_v1_templates__name__get","parameters":[{"in":"path","name":"name","required":true,"schema":{"title":"Name","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"title":"Response Get Template Api V1 Templates  Name  Get","type":"object"}}},"description":"Successful Response"},"401":{"description":"A valid Mangrove credential is required"},"403":{"description":"Caller role, scope or entitlement does not permit this operation"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"429":{"description":"Rate, quota or concurrency limit reached"},"502":{"description":"Oracle is unavailable"},"503":{"description":"Compute accounting or service is unavailable"},"504":{"description":"Oracle request timed out"}},"summary":"Get Template","tags":["templates"],"x-mangrove-schema-status":"upstream-declaration"}}},"security":[{"MangroveBearer":[]}],"servers":[{"url":"https://api.mangrovedeveloper.ai"}],"x-mangrove-provenance":{"generation":"git archive of exact commit; app.openapi(); sockets blocked; lifespan not started","schema_sha256":"270d4bb1701d67c97fdcd4f1276382610c37967a6c3aaa23abd3fefde86217c8","source_commit":"ddccbc115024b2df00d096538c727dc8f257d5d8","source_repository":"MangroveTechnologies/MangroveOracle"}}
