Checks a proposed order against the house position and gross-exposure floors.
Boundary. Validates supplied numbers only; it cannot place, cancel or route an order and does not read broker state.
- Credits
- 0 credits. Runs locally over stdio or on the hosted endpoint.
- Data sent
- Hosted: the order, equity and current positions you pass. Local: nothing leaves your machine.
- Coverage
- Any symbol; the checker only sees the figures you supply.
- Refusal states
- REJECTED with the exact floor quoted for each violation.
- Next step
- warden.cost_check, then warden.explain_sizing.
Input schema
{
"properties": {
"order": {
"additionalProperties": true,
"description": "Proposed order: {symbol, notional, side: buy|sell}.",
"title": "Order",
"type": "object"
},
"equity": {
"description": "Account equity (base currency) used for the exposure floors.",
"exclusiveMinimum": 0,
"title": "Equity",
"type": "number"
},
"current_positions": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional {symbol: notional} map of current positions.",
"title": "Current Positions"
},
"floor_overrides": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional per-fund overrides {max_position_pct, max_gross_exposure_pct}; the response always reports the deviation from the house floors.",
"title": "Floor Overrides"
}
},
"required": [
"order",
"equity"
],
"title": "validate_orderArguments",
"type": "object"
}
Audits a feature manifest for lookahead leakage and point-in-time provenance violations.
Boundary. Audits the manifest you supply. It cannot see code or data you do not declare.
- Credits
- 0 credits.
- Data sent
- Hosted: the feature manifest you pass. Local: nothing leaves your machine.
- Coverage
- Features declared in the manifest.
- Refusal states
- Lists each leaking or unprovenanced feature; nothing is silently passed.
- Next step
- warden.validate_genome.
Input schema
{
"properties": {
"manifest": {
"description": "Feature manifest: [{name, source, value_ts, as_of}] to audit.",
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Manifest",
"type": "array"
},
"tape_started": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional tape start date (YYYY-MM-DD); features predating it are flagged.",
"title": "Tape Started"
},
"selected_symbols": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional challenger-selected symbols for the coverage check.",
"title": "Selected Symbols"
},
"snapshot_universe": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional archived snapshot universe to measure coverage against.",
"title": "Snapshot Universe"
}
},
"required": [
"manifest"
],
"title": "audit_featuresArguments",
"type": "object"
}
Converts a claimed gross edge into a net-of-cost figure under a pessimistic fill model.
Boundary. A cost calculation on supplied inputs. It is not a backtest and not a forecast.
- Credits
- 0 credits.
- Data sent
- Hosted: the edge and turnover inputs you pass. Local: nothing leaves your machine.
- Coverage
- Any strategy expressed as gross edge and turnover.
- Refusal states
- Reports NEGATIVE_AFTER_COSTS when the claimed edge does not survive costs.
- Next step
- warden.validate_order.
Input schema
{
"properties": {
"gross_edge_bps": {
"description": "Claimed gross edge in basis points before costs.",
"title": "Gross Edge Bps",
"type": "number"
},
"spread_bps": {
"description": "Average bid-ask spread in bps.",
"minimum": 0,
"title": "Spread Bps",
"type": "number"
},
"slippage_bps": {
"description": "Expected slippage in bps.",
"minimum": 0,
"title": "Slippage Bps",
"type": "number"
},
"adverse_selection_bps": {
"description": "Adverse-selection drag in bps.",
"minimum": 0,
"title": "Adverse Selection Bps",
"type": "number"
}
},
"required": [
"gross_edge_bps",
"spread_bps",
"slippage_bps",
"adverse_selection_bps"
],
"title": "cost_checkArguments",
"type": "object"
}
Validates a strategy parameter vector (genome) against the bounded schema and returns its canonical hash.
Boundary. Schema and bounds check only. A valid genome is not a good genome.
- Credits
- 0 credits.
- Data sent
- Hosted: the genome vector you pass. Local: nothing leaves your machine.
- Coverage
- The published genome schema.
- Refusal states
- valid_genome false with the list of schema errors.
- Next step
- warden.audit_features, then gym.probe_fragility.
Input schema
{
"properties": {
"genome": {
"additionalProperties": true,
"description": "Genome object (bounded schema, versioned).",
"title": "Genome",
"type": "object"
}
},
"required": [
"genome"
],
"title": "validate_genomeArguments",
"type": "object"
}
Walks through position sizing step by step, mirroring the live risk engine's sizing logic.
Boundary. Explains a sizing calculation. It does not recommend a position.
- Credits
- 0 credits.
- Data sent
- Hosted: the sizing inputs you pass. Local: nothing leaves your machine.
- Coverage
- Any symbol; inputs are supplied by you.
- Refusal states
- Returns the binding floor and the clipped size when a cap applies.
- Next step
- warden.validate_order.
Input schema
{
"properties": {
"equity": {
"description": "Account equity (base currency).",
"exclusiveMinimum": 0,
"title": "Equity",
"type": "number"
},
"atr_14": {
"description": "14-bar average true range of the instrument.",
"exclusiveMinimum": 0,
"title": "Atr 14",
"type": "number"
},
"close": {
"description": "Current close/reference price.",
"exclusiveMinimum": 0,
"title": "Close",
"type": "number"
},
"weekend_approaching": {
"default": false,
"description": "True when the position would be held into the weekend (gross headroom applies).",
"title": "Weekend Approaching",
"type": "boolean"
},
"gross_exposure": {
"default": 0,
"description": "Current portfolio gross exposure in currency.",
"minimum": 0,
"title": "Gross Exposure",
"type": "number"
},
"overnight_gap": {
"default": 0,
"description": "Expected overnight gap (price units); gaps above 1.2x ATR halve size.",
"minimum": 0,
"title": "Overnight Gap",
"type": "number"
},
"floor_overrides": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional per-fund overrides; deviation from house floors is reported.",
"title": "Floor Overrides"
}
},
"required": [
"equity",
"atr_14",
"close"
],
"title": "explain_sizingArguments",
"type": "object"
}
warden.promotion_verdict
ProHostedsince 0.4.0
Requests a promotion verdict for a candidate.
Boundary. Always INDETERMINATE_LOCAL. The selection machinery is not shipped, so no local promotion verdict exists.
- Credits
- 1 credit per hosted call.
- Data sent
- The candidate summary you pass.
- Coverage
- Not applicable.
- Refusal states
- INDETERMINATE_LOCAL, naming the inputs that only the hosted tournament can supply.
- Next step
- tournament.submit.
Input schema
{
"properties": {
"challenger_genome": {
"additionalProperties": true,
"description": "The challenger genome under evaluation.",
"title": "Challenger Genome",
"type": "object"
},
"champion_genome": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional current champion genome; mutation tiers vs it are reported.",
"title": "Champion Genome"
}
},
"required": [
"challenger_genome"
],
"title": "request_promotion_verdictArguments",
"type": "object"
}
features.build
ProHostedsince 0.4.0
Builds the exact feature vector for a symbol at a session date, with provenance for every field.
Boundary. Runs a no-lookahead guard. Fields without point-in-time evidence are returned as UNSCORABLE, never zero-filled.
- Credits
- 1 credit per hosted call. Pro entitlement required.
- Data sent
- Symbol and as_of date.
- Coverage
- Covered symbol universe.
- Refusal states
- UNSCORABLE per field where provenance is missing.
- Next step
- warden.audit_features.
Input schema
{
"properties": {
"symbol": {
"description": "Ticker symbol, e.g. AAPL.",
"title": "Symbol",
"type": "string"
},
"as_of": {
"description": "Point-in-time session date (YYYY-MM-DD); every feature is a causal recomputation at this date, never a later revision.",
"title": "As Of",
"type": "string"
}
},
"required": [
"symbol",
"as_of"
],
"title": "build_featuresArguments",
"type": "object"
}
Derived technical snapshot per symbol: trend, volatility, oscillator, volume and regime signals.
Boundary. Derived ratios and labels only; no raw provider quotes.
- Credits
- 1 relay call (free plan: 250 per month, 10 symbols per call).
- Data sent
- The symbols you ask about.
- Coverage
- Covered symbol universe; supply your own bars for other symbols.
- Refusal states
- Symbols outside coverage are reported, not estimated.
- Next step
- market.regime.
Input schema
{
"properties": {
"symbols": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional list of tickers to analyze via the shared cache/relay (default: none — supply symbols or your own bars).",
"title": "Symbols"
},
"bars": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional caller-supplied OHLCV rows [{symbol, ts, open, high, low, close, volume}] for symbols the shared cache does not carry.",
"title": "Bars"
}
},
"title": "market_pulseArguments",
"type": "object"
}
Derived sentiment snapshot for a symbol: headline count and an earnings flag.
Boundary. Counts and flags only; no headline text.
- Credits
- 1 relay call.
- Data sent
- The symbol you ask about.
- Coverage
- Covered symbol universe.
- Refusal states
- Reports missing coverage instead of returning a neutral value.
- Next step
- pit.analysis.
Input schema
{
"properties": {
"symbol": {
"description": "Ticker symbol, e.g. TSLA.",
"title": "Symbol",
"type": "string"
}
},
"required": [
"symbol"
],
"title": "sentiment_pulseArguments",
"type": "object"
}
Area-specific weather research for each symbol's operating footprint.
Boundary. Research context. Weather coverage is partial and the output is not a trading signal.
- Credits
- 1 relay call.
- Data sent
- The symbols you ask about.
- Coverage
- Symbols with a mapped operating footprint.
- Refusal states
- Reports symbols without a footprint mapping.
- Next step
- pit.analysis.
Input schema
{
"properties": {
"symbols": {
"description": "Tickers whose operating-area climate to research (registry-covered weather-exposed underlyings, or any ticker you supply `areas` for).",
"items": {
"type": "string"
},
"title": "Symbols",
"type": "array"
},
"areas": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional caller-supplied operating areas for underlyings outside the shipped registry: [{symbol, name?, lat, lon, weight?}]. Weather is fetched ONLY for these made/sold geographies — never the listing exchange or HQ city.",
"title": "Areas"
}
},
"required": [
"symbols"
],
"title": "climate_snapshotArguments",
"type": "object"
}
Tests whether an alternative-data signal is statistically real for a symbol, with an explicit verdict per family and horizon.
Boundary. Statistical significance is not future profitability. Verdicts describe a family's power across the universe, not a forecast for one name.
- Credits
- 1 relay call. Free plan answers in lite mode; full per-horizon detail needs a funded Pro entitlement.
- Data sent
- Symbols and as_of date.
- Coverage
- Point-in-time datasets dated by when they were publicly knowable. Live counts are shown on this page.
- Refusal states
- SIGNIFICANT, NOT SIGNIFICANT, NOT JUDGED (below the observation floor) and RESEARCH-ONLY (under 50% coverage).
- Next step
- features.build.
Input schema
{
"properties": {
"symbols": {
"description": "Underlying tickers to query (max 10). Results are per underlying.",
"items": {
"type": "string"
},
"title": "Symbols",
"type": "array"
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Point-in-time cutoff (YYYY-MM-DD, default today): release points after this date are ignored.",
"title": "As Of"
},
"horizons": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Subset of the run's horizons, e.g. ['1d','1w','1m','6m'] (default: all).",
"title": "Horizons"
},
"only_significant": {
"default": false,
"description": "Only return families with at least one SIGNIFICANT horizon (counts still cover everything).",
"title": "Only Significant",
"type": "boolean"
},
"max_families": {
"default": 20,
"description": "Max families returned per underlying, most significant first (1-100).",
"maximum": 100,
"minimum": 1,
"title": "Max Families",
"type": "integer"
}
},
"required": [
"symbols"
],
"title": "pit_analysisArguments",
"type": "object"
}
cache.warm
ProLocalsince 0.4.0
Backfills history into the local cache for a universe of symbols.
Boundary. Fetches derived data into your cache. It does not redistribute provider data.
- Credits
- 1 relay call per request. Pro entitlement required.
- Data sent
- The symbols and history depth you request.
- Coverage
- Covered symbol universe; depth capped by plan.
- Refusal states
- ACCESS_REQUIRED or a 402 on the free plan or an exhausted pool.
- Next step
- gym.label_regimes.
Input schema
{
"properties": {
"universe": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional list of tickers to backfill (default: the swarm's 13-symbol universe).",
"title": "Universe"
},
"years": {
"default": 1,
"description": "Years of daily history to backfill (max limited by the plan's backfill window).",
"exclusiveMinimum": 0.1,
"maximum": 10,
"title": "Years",
"type": "number"
}
},
"title": "cache_warmArguments",
"type": "object"
}
cache.stats
FreeLocalsince 0.4.0
Inventory of the local cache: rows per symbol, session bounds, depth in weeks and API-call accounting.
Boundary. Reports local state only.
- Credits
- 0 credits.
- Data sent
- Nothing.
- Coverage
- Whatever is in your local cache.
- Refusal states
- Not applicable.
- Next step
- cache.warm.
Input schema
{
"properties": {},
"title": "cache_statsArguments",
"type": "object"
}
cache.offline
FreeLocalsince 0.4.0
Toggles cache-only mode: no network access, reads served from cache, fetches refused.
Boundary. Changes local behaviour only.
- Credits
- 0 credits.
- Data sent
- Nothing.
- Coverage
- Whatever is in your local cache.
- Refusal states
- Fetches are refused while offline mode is on.
- Next step
- cache.stats.
Input schema
{
"properties": {
"enabled": {
"description": "True = cache-only mode (no network; reads from cache, fetches refused).",
"title": "Enabled",
"type": "boolean"
}
},
"required": [
"enabled"
],
"title": "offline_modeArguments",
"type": "object"
}
Causal regime label per symbol: high volatility, drawdown, chop, melt-up or gap-heavy.
Boundary. Labels use trailing data only. A label is a description, not a prediction.
- Credits
- 1 relay call.
- Data sent
- The symbols you ask about.
- Coverage
- Covered symbol universe.
- Refusal states
- Reports insufficient history instead of guessing a label.
- Next step
- gym.label_regimes.
Input schema
{
"properties": {
"symbols": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional list of tickers to label via the shared cache/relay.",
"title": "Symbols"
},
"bars": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional caller-supplied OHLCV rows [{symbol, ts, open, high, low, close, volume}] for symbols the shared cache does not carry.",
"title": "Bars"
}
},
"title": "regime_snapshotArguments",
"type": "object"
}
Derived microstructure snapshot: order-flow imbalance and toxicity measures.
Boundary. Derived values only; no raw quotes.
- Credits
- 1 relay call. Pro entitlement required.
- Data sent
- The symbols you ask about.
- Coverage
- Covered symbol universe.
- Refusal states
- Reports missing coverage per symbol.
- Next step
- volume.forecast.
Input schema
{
"properties": {
"symbol": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Ticker to analyze (served from the shared cache/relay); omit when passing your own bars.",
"title": "Symbol"
},
"bars": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional caller-supplied OHLCV rows [{symbol, ts, open, high, low, close, volume}].",
"title": "Bars"
}
},
"title": "microstructure_snapshotArguments",
"type": "object"
}
Derived volume forecast expressed as a ratio to the trailing 20-session average.
Boundary. A statistical forecast. It is not a price prediction.
- Credits
- 1 relay call. Pro entitlement required.
- Data sent
- The symbols you ask about.
- Coverage
- Covered symbol universe.
- Refusal states
- Reports insufficient history.
- Next step
- market.screen.
Input schema
{
"properties": {
"symbol": {
"description": "Ticker to forecast (served from the shared cache/relay).",
"title": "Symbol",
"type": "string"
},
"horizon_bars": {
"default": 1,
"description": "Number of sessions ahead to forecast (1-10).",
"maximum": 10,
"minimum": 1,
"title": "Horizon Bars",
"type": "integer"
}
},
"required": [
"symbol"
],
"title": "volume_forecastArguments",
"type": "object"
}
Ranked, derived-only screen across a symbol list.
Boundary. Cross-sectional ranking, not a recommendation.
- Credits
- 1 relay call. Pro entitlement required.
- Data sent
- The symbol list.
- Coverage
- Covered symbol universe.
- Refusal states
- Reports symbols that could not be scored.
- Next step
- market.rank.
Input schema
{
"properties": {
"symbols": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "List of tickers to screen (via the shared cache/relay); omit when passing your own bars.",
"title": "Symbols"
},
"bars": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional caller-supplied OHLCV rows [{symbol, ts, open, high, low, close, volume}].",
"title": "Bars"
},
"criteria": {
"default": "breakout",
"description": "Screen criterion: breakout | momentum | volume | anomaly.",
"title": "Criteria",
"type": "string"
}
},
"title": "screen_universeArguments",
"type": "object"
}
Cross-sectional percentile rank of one derived metric across a symbol list.
Boundary. A rank, not a signal to trade.
- Credits
- 1 relay call. Pro entitlement required.
- Data sent
- The symbol list and the metric name.
- Coverage
- Covered symbol universe.
- Refusal states
- Reports symbols that could not be ranked.
- Next step
- market.screen.
Input schema
{
"properties": {
"symbols": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "List of tickers to rank (via the shared cache/relay); omit when passing your own bars.",
"title": "Symbols"
},
"bars": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional caller-supplied OHLCV rows [{symbol, ts, open, high, low, close, volume}].",
"title": "Bars"
},
"metric": {
"default": "momentum_20d",
"description": "Metric to rank by: momentum_20d | volume_ratio_20d | atr_pct | rsi_14.",
"title": "Metric",
"type": "string"
}
},
"title": "cross_sectional_rankArguments",
"type": "object"
}
Labels causal market regimes over cached bars and reports the episode pool per regime, flagging thin pools.
Boundary. Labels use trailing data only; thin pools are flagged UNDERPOWERED.
- Credits
- Hosted: 1 credit per call. Local: 0.
- Data sent
- Hosted: symbols or bars you pass. Local: nothing leaves your machine.
- Coverage
- Your supplied bars or the shared cache.
- Refusal states
- UNDERPOWERED flags where the episode pool is thin.
- Next step
- gym.probe_fragility.
Input schema
{
"properties": {
"symbols": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional tickers served from the shared cache; omit when passing your own bars.",
"title": "Symbols"
},
"bars": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inline OHLCV rows [{symbol, ts, open, high, low, close, volume}].",
"title": "Bars"
},
"min_symbols": {
"default": 8,
"description": "Minimum symbols required for a valid episode pool.",
"maximum": 20,
"minimum": 1,
"title": "Min Symbols",
"type": "integer"
}
},
"title": "label_regimesArguments",
"type": "object"
}
Replays a genome over a capped episode-seed matrix and reports per-regime fragility.
Boundary. Local previews are capped and labelled underpowered. Never a promotion verdict.
- Credits
- Hosted: 1 credit per simulated episode (5 regimes x per_regime x seeds). Local: 0.
- Data sent
- Hosted: the genome vector and bars you pass. Local: nothing leaves your machine.
- Coverage
- Your supplied bars or the shared cache.
- Refusal states
- UNDERPOWERED below 20 episodes; hard-constraint and lookahead violations are listed.
- Next step
- gym.paired_preview.
Input schema
{
"properties": {
"genome": {
"additionalProperties": true,
"description": "Genome to replay over the capped episode-seed matrix.",
"title": "Genome",
"type": "object"
},
"champion_genome": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional champion genome; tier-B/C mutations vs it refuse to score.",
"title": "Champion Genome"
},
"seeds": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional episode seeds (max 8 locally).",
"title": "Seeds"
},
"per_regime": {
"default": 2,
"description": "Episodes per regime (1 or 2 locally).",
"maximum": 2,
"minimum": 1,
"title": "Per Regime",
"type": "integer"
},
"symbols": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional tickers from the shared cache; omit when passing bars.",
"title": "Symbols"
},
"bars": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inline OHLCV rows.",
"title": "Bars"
},
"min_symbols": {
"default": 8,
"description": "Minimum symbols for a valid episode pool.",
"maximum": 20,
"minimum": 1,
"title": "Min Symbols",
"type": "integer"
}
},
"required": [
"genome"
],
"title": "probe_fragilityArguments",
"type": "object"
}
Paired champion-versus-challenger preview on identical market paths.
Boundary. A preview on a capped matrix. It does not issue a promotion verdict.
- Credits
- Hosted: 1 credit per episode (doubled for two genomes). Local: 0.
- Data sent
- Hosted: the genome vectors you pass. Local: nothing leaves your machine.
- Coverage
- Your supplied bars or the shared cache.
- Refusal states
- UNDERPOWERED below 20 paired episodes.
- Next step
- tournament.submit.
Input schema
{
"properties": {
"champion_genome": {
"additionalProperties": true,
"description": "Current champion genome.",
"title": "Champion Genome",
"type": "object"
},
"challenger_genome": {
"additionalProperties": true,
"description": "Challenger genome to compare against the champion.",
"title": "Challenger Genome",
"type": "object"
},
"seeds": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional episode seeds (max 8 locally).",
"title": "Seeds"
},
"per_regime": {
"default": 2,
"description": "Episodes per regime (1 or 2 locally).",
"maximum": 2,
"minimum": 1,
"title": "Per Regime",
"type": "integer"
},
"symbols": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional tickers from the shared cache; omit when passing bars.",
"title": "Symbols"
},
"bars": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inline OHLCV rows.",
"title": "Bars"
},
"min_symbols": {
"default": 8,
"description": "Minimum symbols for a valid episode pool.",
"maximum": 20,
"minimum": 1,
"title": "Min Symbols",
"type": "integer"
}
},
"required": [
"champion_genome",
"challenger_genome"
],
"title": "paired_previewArguments",
"type": "object"
}
Prices a hosted run before you spend credits.
Boundary. An estimate from the published rate card, not a quote for other work.
- Credits
- Hosted: 1 credit per call. Local: 0.
- Data sent
- Hosted: seeds, per_regime and genome count.
- Coverage
- Not applicable.
- Refusal states
- Rejects geometries above the caps.
- Next step
- gym.probe_fragility.
Input schema
{
"properties": {
"seeds": {
"anyOf": [
{
"items": {
"type": "integer"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional episode seeds (default [0..4]).",
"title": "Seeds"
},
"per_regime": {
"default": 4,
"description": "Episodes per regime (default 4 on the hosted side).",
"maximum": 10,
"minimum": 1,
"title": "Per Regime",
"type": "integer"
},
"n_genomes": {
"default": 1,
"description": "Number of genomes in the run.",
"maximum": 100,
"minimum": 1,
"title": "N Genomes",
"type": "integer"
}
},
"title": "estimate_cloud_runArguments",
"type": "object"
}
tournament.submit
ProHostedsince 0.4.0
Submits a genome to the hosted Shadow Tournament: a paired replay against the swarm's champion on identical market paths.
Boundary. Returns a paired statistical outcome. A win is not a promotion, a league seat or a forecast of future returns.
- Credits
- 200 credits, or 100 with contribute=true. Pro entitlement required.
- Data sent
- The genome vector, its hash and the contribute flag. Never symbols, bars, features, orders or code unless you opt into the strategy tier.
- Coverage
- The hosted daily-bar panel.
- Refusal states
- ACCESS_REQUIRED or a 402 with the reason; failed runs refund the credits.
- Next step
- tournament.verdict.
Input schema
{
"properties": {
"genome": {
"additionalProperties": true,
"description": "Genome parameter vector (public schema) to score against the swarm's live champion. Validate locally with warden.validate_genome first.",
"title": "Genome",
"type": "object"
},
"contribute": {
"default": false,
"description": "true: license the genome vector + outcome to the swarm's evolution loop as an external challenger and pay half price. Combine with `disclosure` and/or `strategy_code` for the strategy-contributor tier (leaderboard attribution + league-seat eligibility after review). false (default): the vector is deleted after scoring; only hash + outcome remain.",
"title": "Contribute",
"type": "boolean"
},
"disclosure": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Strategy-contributor tier: author-written decision-logic disclosure (version 1; fields hypothesis, universe, selection, entry_timing, risk_sizing, weekend_hold, expected_edge — describe how the strategy decides, never code, data dumps, or secrets). Requires contribute=true. Validated locally before anything is sent.",
"title": "Disclosure"
},
"strategy_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Strategy-contributor tier: submit strategy CODE for STATIC LLM review. The code is treated as inert text — it is NEVER executed by us or the swarm; the hosted reviewer reads it with an LLM and stores only the structured explanation + a code hash (raw code is discarded after review). Remove keys/secrets first. Requires contribute=true.",
"title": "Strategy Code"
}
},
"required": [
"genome"
],
"title": "tournament_submitArguments",
"type": "object"
}
tournament.verdict
ProHostedsince 0.4.0
Polls a Shadow Tournament job and returns the paired outcome against the champion.
Boundary. Outcome is CHALLENGER_BEATS_CHAMPION, CHALLENGER_LOSES or INCONCLUSIVE. None of them is a promotion.
- Credits
- 0 credits. Pro entitlement required.
- Data sent
- The job id.
- Coverage
- Not applicable.
- Refusal states
- Pending or failed job states are reported as such.
- Next step
- tournament.leaderboard.
Input schema
{
"properties": {
"job_id": {
"description": "job_id returned by tournament.submit.",
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "tournament_verdictArguments",
"type": "object"
}
Anonymised Shadow Tournament board: champion rating and top challengers by ELO.
Boundary. Hashes are truncated and anonymised. Ratings describe replay results.
- Credits
- 0 credits. Free on every plan.
- Data sent
- Nothing.
- Coverage
- All completed tournament runs.
- Refusal states
- Not applicable.
- Next step
- tournament.submit.
Input schema
{
"properties": {},
"title": "tournament_leaderboardArguments",
"type": "object"
}