Raw schema
{
"type": "object",
"properties": {
"firmId": {
"description": "Directory firm id or firm name (e.g. 'ftmo' or 'FTMO'); discover with propfirms_list_simulatable. Must be paired with challengeId. Mutually exclusive with `spec`.",
"type": "string",
"minLength": 1
},
"challengeId": {
"description": "Directory challenge id; discover with propfirms_list_simulatable. Must be paired with firmId. Mutually exclusive with `spec`.",
"type": "string",
"minLength": 1
},
"spec": {
"description": "Inline challenge ruleset, for challenges not in the directory or for what-if rule edits. Mutually exclusive with firmId/challengeId. Identify the challenge EITHER by directory reference (firmId + challengeId, discovered via propfirms_list_simulatable; firmId accepts the directory id or the firm's name) OR by a full inline `spec` object - the exact shape propfirms_challenge_rules returns, so you can fetch a directory entry, change one rule, and re-simulate to model rule variations. Provide exactly one of the two forms; providing both or neither is an error. Directory references need network access; inline specs are fully offline.",
"type": "object",
"properties": {
"challengeId": {
"type": "string",
"minLength": 1,
"description": "Stable kebab-case id for this ruleset, e.g. '100k-2step'."
},
"name": {
"type": "string",
"minLength": 1,
"description": "Display name, e.g. '100K 2-Step'."
},
"productType": {
"type": "string",
"enum": [
"futures",
"cfd",
"equities"
],
"description": "Instrument class the challenge is traded on: 'futures', 'cfd' (forex/CFD), or 'equities'."
},
"accountSize": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Initial account balance in account currency."
},
"currency": {
"description": "ISO currency code all amounts are denominated in. Default USD.",
"type": "string"
},
"steps": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"profitTargetPct": {
"description": "Profit target in PERCENT UNITS of the initial account size (8 = 8%). Exactly one of profitTargetPct/profitTargetAmount.",
"type": "number",
"exclusiveMinimum": 0
},
"profitTargetAmount": {
"description": "Profit target as a fixed currency amount (alternative to profitTargetPct).",
"type": "number",
"exclusiveMinimum": 0
},
"minTradingDays": {
"description": "Minimum days with at least one trade before the step can be passed. Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"maxDays": {
"description": "Trading-day limit for the step; null (the default) = unlimited time.",
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"dailyLoss": {
"description": "Per-step override of the challenge-level daily loss rule. Omit to inherit; null = no daily loss rule in this step.",
"anyOf": [
{
"type": "object",
"properties": {
"pct": {
"description": "Daily loss limit in PERCENT UNITS (5 = 5%); what it is a percent OF is set by limitBasis. Exactly one of pct/amount.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"amount": {
"description": "Daily loss limit as a fixed currency amount (alternative to pct).",
"type": "number",
"exclusiveMinimum": 0
},
"basis": {
"description": "Anchor today's loss is measured from: prior day's closing balance or closing equity (they differ only with overnight positions). Default 'prior-day-balance'.",
"type": "string",
"enum": [
"prior-day-balance",
"prior-day-equity"
]
},
"limitBasis": {
"description": "What a percentage limit is a percent OF. 'initial-balance': a fixed currency allowance (always e.g. 5% of the starting account). 'anchor': recomputed daily from the day's anchor. Default 'initial-balance'.",
"type": "string",
"enum": [
"initial-balance",
"anchor"
]
},
"includesOpenPnl": {
"description": "Whether floating (unrealized) P&L counts toward the daily loss, i.e. breach can happen intra-position. Default true.",
"type": "boolean"
},
"evaluation": {
"description": "'intraday': fails the moment equity touches the daily floor. 'end-of-day': only the close is checked. Default 'intraday'.",
"type": "string",
"enum": [
"intraday",
"end-of-day"
]
}
},
"additionalProperties": {},
"description": "Daily loss rule: the daily floor is anchor minus limit, reset at each trading-day boundary. Exactly one of pct/amount must be set."
},
{
"type": "null"
}
]
},
"maxLoss": {
"description": "Per-step override of the challenge-level max loss rule. Omit to inherit.",
"type": "object",
"properties": {
"pct": {
"description": "Max loss in PERCENT UNITS of the initial account size (10 = 10%). Exactly one of pct/amount.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"amount": {
"description": "Max loss as a fixed currency amount (alternative to pct).",
"type": "number",
"exclusiveMinimum": 0
},
"mode": {
"type": "string",
"enum": [
"static-initial",
"trailing-realized-eod",
"trailing-intraday-unrealized",
"trailing-locks-at-initial"
],
"description": "How the max-loss floor behaves - the single most consequential rule difference between firms. 'static-initial': floor fixed at initial balance minus the limit; never moves (classic CFD two-step). 'trailing-realized-eod': floor ratchets up with end-of-day balance highs; intraday highs do not move it. 'trailing-intraday-unrealized': floor trails the peak unrealized equity intraday and never stops trailing (futures-style; the most-miscalculated rule in the industry: it cuts pass probability dramatically). 'trailing-locks-at-initial': trails intraday peak equity until the floor reaches the initial balance, then freezes (common futures variant). Locking is also composable: locksAtInitial adds the same lock to an EOD trail, and lockOffsetAmount shifts the lock level to initial balance + that amount (e.g. 100 models 'stops trailing $100 above the start')."
},
"locksAtInitial": {
"description": "For trailing modes: once the trailing floor climbs up to the initial balance (plus lockOffsetAmount), it locks there and stops trailing. Default false. 'trailing-locks-at-initial' locks by definition; set this to add the same lock to 'trailing-realized-eod' (e.g. an EOD trail that stops at the starting balance).",
"type": "boolean"
},
"lockOffsetAmount": {
"description": "Currency offset of the lock level: the floor locks at initial balance + this amount, modeling rules like 'the trailing threshold stops $100 above the start'. Default 0. Only meaningful when the rule locks (mode 'trailing-locks-at-initial' or locksAtInitial=true).",
"type": "number",
"minimum": 0
}
},
"required": [
"mode"
],
"additionalProperties": {}
},
"consistency": {
"description": "Consistency rule - SIMULATED (engine v1), not just flagged: one outsized day effectively raises the target (total profit must reach best day / pct), and the simulated trader keeps trading - rationally stopping days early when that helps - until the best-day share complies (see flag 'consistency-stop-rule'). null or omitted = no consistency rule.",
"anyOf": [
{
"type": "object",
"properties": {
"maxBestDayProfitPct": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100,
"description": "Maximum share of the step's total profit the best single day may contribute, in PERCENT UNITS (40 = the best day may be at most 40% of total profit)."
}
},
"required": [
"maxBestDayProfitPct"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"additionalProperties": {},
"description": "One evaluation step. Each step starts on a fresh account at the initial balance."
},
"description": "Evaluation steps in order. Passing the last step means funded."
},
"dailyLoss": {
"anyOf": [
{
"type": "object",
"properties": {
"pct": {
"description": "Daily loss limit in PERCENT UNITS (5 = 5%); what it is a percent OF is set by limitBasis. Exactly one of pct/amount.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"amount": {
"description": "Daily loss limit as a fixed currency amount (alternative to pct).",
"type": "number",
"exclusiveMinimum": 0
},
"basis": {
"description": "Anchor today's loss is measured from: prior day's closing balance or closing equity (they differ only with overnight positions). Default 'prior-day-balance'.",
"type": "string",
"enum": [
"prior-day-balance",
"prior-day-equity"
]
},
"limitBasis": {
"description": "What a percentage limit is a percent OF. 'initial-balance': a fixed currency allowance (always e.g. 5% of the starting account). 'anchor': recomputed daily from the day's anchor. Default 'initial-balance'.",
"type": "string",
"enum": [
"initial-balance",
"anchor"
]
},
"includesOpenPnl": {
"description": "Whether floating (unrealized) P&L counts toward the daily loss, i.e. breach can happen intra-position. Default true.",
"type": "boolean"
},
"evaluation": {
"description": "'intraday': fails the moment equity touches the daily floor. 'end-of-day': only the close is checked. Default 'intraday'.",
"type": "string",
"enum": [
"intraday",
"end-of-day"
]
}
},
"additionalProperties": {},
"description": "Daily loss rule: the daily floor is anchor minus limit, reset at each trading-day boundary. Exactly one of pct/amount must be set."
},
{
"type": "null"
}
],
"description": "Challenge-level daily loss rule applied to every step unless a step overrides it. null = no daily loss rule. This field is required (pass null explicitly for none)."
},
"maxLoss": {
"type": "object",
"properties": {
"pct": {
"description": "Max loss in PERCENT UNITS of the initial account size (10 = 10%). Exactly one of pct/amount.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"amount": {
"description": "Max loss as a fixed currency amount (alternative to pct).",
"type": "number",
"exclusiveMinimum": 0
},
"mode": {
"type": "string",
"enum": [
"static-initial",
"trailing-realized-eod",
"trailing-intraday-unrealized",
"trailing-locks-at-initial"
],
"description": "How the max-loss floor behaves - the single most consequential rule difference between firms. 'static-initial': floor fixed at initial balance minus the limit; never moves (classic CFD two-step). 'trailing-realized-eod': floor ratchets up with end-of-day balance highs; intraday highs do not move it. 'trailing-intraday-unrealized': floor trails the peak unrealized equity intraday and never stops trailing (futures-style; the most-miscalculated rule in the industry: it cuts pass probability dramatically). 'trailing-locks-at-initial': trails intraday peak equity until the floor reaches the initial balance, then freezes (common futures variant). Locking is also composable: locksAtInitial adds the same lock to an EOD trail, and lockOffsetAmount shifts the lock level to initial balance + that amount (e.g. 100 models 'stops trailing $100 above the start')."
},
"locksAtInitial": {
"description": "For trailing modes: once the trailing floor climbs up to the initial balance (plus lockOffsetAmount), it locks there and stops trailing. Default false. 'trailing-locks-at-initial' locks by definition; set this to add the same lock to 'trailing-realized-eod' (e.g. an EOD trail that stops at the starting balance).",
"type": "boolean"
},
"lockOffsetAmount": {
"description": "Currency offset of the lock level: the floor locks at initial balance + this amount, modeling rules like 'the trailing threshold stops $100 above the start'. Default 0. Only meaningful when the rule locks (mode 'trailing-locks-at-initial' or locksAtInitial=true).",
"type": "number",
"minimum": 0
}
},
"required": [
"mode"
],
"additionalProperties": {},
"description": "Challenge-level max loss rule applied to every step unless a step overrides it. Required."
},
"fees": {
"type": "object",
"properties": {
"price": {
"type": "number",
"minimum": 0,
"description": "Challenge price in account currency. Under 'monthly' billing: price per month."
},
"billing": {
"description": "'one-time' (default): the price buys one attempt; failed attempts are re-bought or reset. 'monthly': recurring subscription while evaluating (common for futures firms).",
"type": "string",
"enum": [
"one-time",
"monthly"
]
},
"resetFee": {
"description": "Discounted fee to reset a failed attempt. null (default) = no reset offer: a failed one-time attempt costs full price again; a failed monthly attempt rides on the subscription.",
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"activationFee": {
"description": "One-time fee charged when the funded account is activated. Default 0.",
"type": "number",
"minimum": 0
},
"refundableOnPass": {
"description": "Whether the one-time challenge fee is refunded once funded (credited back in cost/EV). Default false.",
"type": "boolean"
}
},
"required": [
"price"
],
"additionalProperties": {},
"description": "Fees - everything that goes into expected total cost."
},
"funded": {
"type": "object",
"properties": {
"profitSplitPct": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Trader's share of funded profits in PERCENT UNITS (80 = 80%)."
},
"payoutFrequency": {
"type": "string",
"enum": [
"weekly",
"biweekly",
"monthly",
"on-demand"
],
"description": "How often funded profits can be withdrawn."
},
"firstPayoutMinDays": {
"description": "Minimum days on the funded account before the first payout. Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"dailyLoss": {
"description": "Funded-account override of the daily loss rule. Omit to inherit; null = none.",
"anyOf": [
{
"type": "object",
"properties": {
"pct": {
"description": "Daily loss limit in PERCENT UNITS (5 = 5%); what it is a percent OF is set by limitBasis. Exactly one of pct/amount.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"amount": {
"description": "Daily loss limit as a fixed currency amount (alternative to pct).",
"type": "number",
"exclusiveMinimum": 0
},
"basis": {
"description": "Anchor today's loss is measured from: prior day's closing balance or closing equity (they differ only with overnight positions). Default 'prior-day-balance'.",
"type": "string",
"enum": [
"prior-day-balance",
"prior-day-equity"
]
},
"limitBasis": {
"description": "What a percentage limit is a percent OF. 'initial-balance': a fixed currency allowance (always e.g. 5% of the starting account). 'anchor': recomputed daily from the day's anchor. Default 'initial-balance'.",
"type": "string",
"enum": [
"initial-balance",
"anchor"
]
},
"includesOpenPnl": {
"description": "Whether floating (unrealized) P&L counts toward the daily loss, i.e. breach can happen intra-position. Default true.",
"type": "boolean"
},
"evaluation": {
"description": "'intraday': fails the moment equity touches the daily floor. 'end-of-day': only the close is checked. Default 'intraday'.",
"type": "string",
"enum": [
"intraday",
"end-of-day"
]
}
},
"additionalProperties": {},
"description": "Daily loss rule: the daily floor is anchor minus limit, reset at each trading-day boundary. Exactly one of pct/amount must be set."
},
{
"type": "null"
}
]
},
"maxLoss": {
"description": "Funded-account override of the max loss rule. Omit to inherit.",
"type": "object",
"properties": {
"pct": {
"description": "Max loss in PERCENT UNITS of the initial account size (10 = 10%). Exactly one of pct/amount.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"amount": {
"description": "Max loss as a fixed currency amount (alternative to pct).",
"type": "number",
"exclusiveMinimum": 0
},
"mode": {
"type": "string",
"enum": [
"static-initial",
"trailing-realized-eod",
"trailing-intraday-unrealized",
"trailing-locks-at-initial"
],
"description": "How the max-loss floor behaves - the single most consequential rule difference between firms. 'static-initial': floor fixed at initial balance minus the limit; never moves (classic CFD two-step). 'trailing-realized-eod': floor ratchets up with end-of-day balance highs; intraday highs do not move it. 'trailing-intraday-unrealized': floor trails the peak unrealized equity intraday and never stops trailing (futures-style; the most-miscalculated rule in the industry: it cuts pass probability dramatically). 'trailing-locks-at-initial': trails intraday peak equity until the floor reaches the initial balance, then freezes (common futures variant). Locking is also composable: locksAtInitial adds the same lock to an EOD trail, and lockOffsetAmount shifts the lock level to initial balance + that amount (e.g. 100 models 'stops trailing $100 above the start')."
},
"locksAtInitial": {
"description": "For trailing modes: once the trailing floor climbs up to the initial balance (plus lockOffsetAmount), it locks there and stops trailing. Default false. 'trailing-locks-at-initial' locks by definition; set this to add the same lock to 'trailing-realized-eod' (e.g. an EOD trail that stops at the starting balance).",
"type": "boolean"
},
"lockOffsetAmount": {
"description": "Currency offset of the lock level: the floor locks at initial balance + this amount, modeling rules like 'the trailing threshold stops $100 above the start'. Default 0. Only meaningful when the rule locks (mode 'trailing-locks-at-initial' or locksAtInitial=true).",
"type": "number",
"minimum": 0
}
},
"required": [
"mode"
],
"additionalProperties": {}
},
"payoutRules": {
"description": "Payout gating - SIMULATED (engine v1), not just flagged: a payout happens only when these conditions are met, and on each eligible payout day the trader withdraws the maximum the rules allow (profit above the buffer, under the caps, never below the loss floor); balances and loss floors carry across payouts (see flag 'funded-withdrawal-model'). Omit for ungated payouts.",
"type": "object",
"properties": {
"minWinningDays": {
"description": "Winning days required in a payout window before a payout can be requested. Default 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"winningDayMinProfit": {
"description": "Minimum profit for a day to count as a winning day. Default 0 (any positive day).",
"type": "number",
"minimum": 0
},
"maxPayoutPctOfProfit": {
"description": "Cap on each payout in PERCENT UNITS of accrued profit (50 = at most half the profit per request). Omit for no percentage cap.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
},
"maxPayoutAmount": {
"description": "Absolute currency cap per payout request. Omit for no fixed cap.",
"type": "number",
"exclusiveMinimum": 0
},
"bufferAmount": {
"description": "Profit buffer that must remain in the account; only profit above it is withdrawable. Default 0.",
"type": "number",
"minimum": 0
},
"consistencyMaxBestDayPct": {
"description": "Funded consistency gate in PERCENT UNITS: the best day may contribute at most this share of the payout window's profit. Evaluated per window (see flag 'funded-consistency-window-approximated').",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"additionalProperties": {}
},
"notes": {
"description": "Free-text funded-stage details that are not simulated.",
"type": "string"
}
},
"required": [
"profitSplitPct",
"payoutFrequency"
],
"additionalProperties": {},
"description": "Funded-stage terms used for the payout/EV simulation."
},
"constraints": {
"description": "Informational trading constraints (maxLeverage, newsTrading, weekendHolding, ...). Recorded and flagged, never simulated.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"flagsNotSimulated": {
"description": "Honesty channel: ids of rules this entry has that the engine does not simulate (e.g. 'scaling-plan', 'soft-daily-lockout'). Surfaced in every result's assumption flags. Consistency rules and payout gating do NOT belong here - the engine simulates them.",
"type": "array",
"items": {
"type": "string"
}
},
"sources": {
"description": "Public citations. Optional for inline specs; dataset entries always carry them.",
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public page documenting the rule."
},
"lastVerified": {
"type": "string",
"description": "ISO date the rules were last checked against that page."
},
"note": {
"type": "string"
}
},
"required": [
"url",
"lastVerified"
],
"additionalProperties": {}
}
}
},
"required": [
"challengeId",
"name",
"accountSize",
"steps",
"dailyLoss",
"maxLoss",
"fees",
"funded"
],
"additionalProperties": {}
},
"rSeries": {
"description": "The trader's real trades as R-multiples in chronological order: each trade's P&L divided by the amount risked on it (+1.8 = won 1.8x risk, -1 = lost exactly the risk, -1.4 = stop slipped 40%). At least 10 trades; 100+ strongly recommended - short series make the simulation overconfident in the sample. Mutually exclusive with rSeriesText, tradeLogText, and tradeLogTexts.",
"minItems": 10,
"type": "array",
"items": {
"type": "number"
}
},
"rSeriesText": {
"description": "The same series as pasted text: a JSON array, CSV, or whitespace/newline separated numbers, with an optional 'R' suffix per value (e.g. \"1.8R, -1R, 0.4, 2.1\"). Parsed with the library's parseRSeries; unparseable tokens are reported back. Mutually exclusive with rSeries, tradeLogText, and tradeLogTexts.",
"type": "string",
"minLength": 1
},
"tradeLogText": {
"description": "The trader's trades as one pasted TIMESTAMPED log instead of a bare series. Accepted formats, auto-detected: the generic CSV template (header: open time,close time,symbol,direction,quantity,entry price,exit price,stop loss,pnl,fees,r), plain timestamped CSV/TSV logs (open time + R columns), real platform exports: TradingView strategy-tester list of trades (both generations), MT4/MT5 account statements (CSV or pasted HTML), MT5 deals tables, and ThinkOrSwim account statements, plus broker trade-history JSON in the @luxalgo/broker-sdk shape (a bare fills array, {\"trades\": [...]}, or one snapshot account; fills replay FIFO into round trips with price-based P&L, disclosed). Timestamps WITHOUT an explicit offset are read as UTC. Files that carry P&L but no risk information need importRisk to become R-multiples; ambiguous rule readings are refused with diagnostics rather than guessed, and skipped rows are reported as warnings. Timestamps unlock two things a bare series cannot do: tradesPerDay is derived from the log when not given, and newsFilter can compare odds with and without trading around news. Mutually exclusive with rSeries, rSeriesText, and tradeLogTexts.",
"type": "string",
"minLength": 1
},
"tradeLogTexts": {
"description": "PORTFOLIO MODE: 2 to 5 timestamped trade logs (same format as tradeLogText), one per strategy or account. They are merged into one chronological series and the combined account is simulated, which preserves cross-strategy loss clustering (exactly what daily and max loss limits punish). Overlap across the histories is ALWAYS analyzed and attached as structuredContent.portfolioOverlap with an audit-risk verdict; see the attached structuredContent.portfolioOverlap analysis for the methodology. Mutually exclusive with rSeries, rSeriesText, and tradeLogText.",
"minItems": 2,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"importRisk": {
"description": "Risk per trade for imports that carry P&L but no risk data (e.g. TradingView, MT5 deals, broker JSON, ThinkOrSwim): cash risked per trade (\"25\") or a percent of entry value (\"1%\"). Applies to tradeLogText/tradeLogTexts only, is labeled rSource inferred, and is never applied silently: without it such files are refused with needs-risk.",
"type": "string"
},
"newsFilter": {
"description": "What-if comparison: what are my odds if I do not OPEN trades around scheduled news? Requires a timestamped input (tradeLogText or tradeLogTexts). The simulation runs TWICE with the same seed and options, once on the full history and once with every trade opened inside [event - preMinutes, event + postMinutes] removed; trades opened earlier but held through an event are only counted, not removed. The returned SimResult is the news-AVOIDED scenario; structuredContent.newsComparison carries both scenarios' headline numbers, the excluded-trade count, and a calendar caveat that MUST be relayed to the user (the calendar is a recurring-template approximation of scheduled releases, not a historical feed).",
"type": "object",
"properties": {
"preMinutes": {
"description": "Minutes avoided BEFORE each event. Default 30.",
"type": "number",
"minimum": 0,
"maximum": 1440
},
"postMinutes": {
"description": "Minutes avoided AFTER each event. Default 30.",
"type": "number",
"minimum": 0,
"maximum": 1440
},
"impacts": {
"description": "Impact levels to avoid. Default ['high']. The built-in recurring calendar carries high- and medium-impact templates only; 'low' matches nothing unless customEventTimes supplies the events.",
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
}
},
"currencies": {
"description": "Currencies whose events are avoided. Default: all eight built-in currencies (USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD).",
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"USD",
"EUR",
"GBP",
"JPY",
"AUD",
"CAD",
"CHF",
"NZD"
]
}
},
"customEventTimes": {
"description": "Exact extra event times as epoch MILLISECONDS UTC, merged into the calendar as high-impact events. Use these for releases the recurring templates do not cover.",
"type": "array",
"items": {
"type": "number"
}
}
}
},
"blockMeanLength": {
"description": "Mean block length of the stationary bootstrap (geometrically distributed blocks). Default 5 trades. 1 = i.i.d. resampling (destroys streaks - only for comparison); raise toward 10 if the trader's edge comes and goes in long regimes.",
"type": "number",
"exclusiveMinimum": 0
},
"tradesPerDay": {
"description": "Average trades per simulated trading day. REQUIRED with rSeries/rSeriesText, which carry no timestamps. Optional with tradeLogText/tradeLogTexts: when omitted it is derived from the log's own timestamps (trades divided by distinct UTC trading days) and the output says so. More trades per day means more ways to hit the daily loss limit within a single day.",
"type": "number",
"exclusiveMinimum": 0
},
"tradesPerDayModel": {
"description": "'fixed' (default): the same count every day. 'poisson': daily count drawn Poisson(tradesPerDay); days can then have zero trades, which do not count as trading days.",
"type": "string",
"enum": [
"fixed",
"poisson"
]
},
"riskMode": {
"description": "How riskValue is interpreted. 'percent-of-balance' (default): risk compounds with the current balance. 'percent-of-initial': constant currency risk derived from the initial account size - how most prop traders size, since loss limits are fixed in currency. 'fixed-amount': explicit currency risked per 1R.",
"type": "string",
"enum": [
"percent-of-balance",
"percent-of-initial",
"fixed-amount"
]
},
"riskValue": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Risk per trade - the value of 1R. PERCENT UNITS for percent modes (0.5 = 0.5% risked per trade; a typical prop range is 0.25-2), or a currency amount for 'fixed-amount'. NOT a fraction."
},
"seed": {
"description": "RNG seed (integer or string). Default 42. Same inputs + seed reproduce byte-identical results - include the seed when reporting so users can reproduce the numbers.",
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string"
}
]
},
"paths": {
"description": "Monte Carlo paths (independent simulated trader journeys). Default 10,000 (well under a second); capped at 100,000 per tool call. Confidence intervals shrink roughly with the square root of paths.",
"type": "integer",
"minimum": 100,
"maximum": 100000
},
"attemptCap": {
"description": "Maximum challenge attempts per path before that path gives up. Default 25. Journey statistics (expected attempts/cost, P(funded)) are censored at this cap.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"simulateFunded": {
"description": "Whether to simulate the funded stage (payouts, blowup risk) after passing. Default true - EV is only meaningful with it on; set false to study the evaluation alone.",
"type": "boolean"
},
"fundedHorizonDays": {
"description": "Funded-stage horizon in trading days for the payout/EV simulation. Default 90 (about 4 calendar months). EV scales with this choice - state it when reporting EV.",
"type": "integer",
"minimum": 1,
"maximum": 2000
},
"includeHistograms": {
"description": "Include histogram arrays (attempts, cost, net, drawdown) in the result. Default FALSE for this tool to keep responses compact; summary quantiles (p05...p95) are always included.",
"type": "boolean"
},
"context": {
"type": "string",
"description": "Explain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as \"a user\", \"the customer\", or \"an account\". Example: \"Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution.\""
}
},
"required": [
"riskValue",
"context"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}