Stratify

Backtest an Indian index option strategy on real 1-minute NIFTY options data. Returns P&L after real charges and slippage, return-on-margin, and an honesty panel: out-of-sample split, walk-forward folds, bootstrap interval, and a deflated Sharpe that accounts for how many variants you have already tried. Refuses windows too narrow to be meaningful, and reports no ratios below 30 trades. Two spec forms: a PRESET (structure + params) for the common shapes, or an OPEN STRATEGY (legs + rules) for anything else — any number of legs at any strikes on any expiry, strikes chosen by percent, points, premium or delta, entry at any minute, and rules that CHANGE the position while it is live (roll a tested leg, close one side, add a hedge, trail a stop) plus book-level rules like standing down after three losers. Nothing here is restricted by tier; a paid tier only widens the date window.

{
  "type": "object",
  "properties": {
    "spec": {
      "description": "Either a preset spec (structure + params) or an open strategy (legs + rules). Use the open form for anything the presets cannot say.",
      "oneOf": [
        {
          "type": "object",
          "required": [
            "structure",
            "params"
          ],
          "additionalProperties": false,
          "properties": {
            "structure": {
              "type": "string",
              "enum": [
                "credit_spread",
                "iron_condor",
                "iron_fly",
                "long_option",
                "short_strangle"
              ],
              "description": "Option structure to trade."
            },
            "symbol": {
              "type": "string",
              "enum": [
                "NIFTY"
              ],
              "description": "Free tier serves NIFTY only."
            },
            "params": {
              "type": "object",
              "description": "Structure parameters. pct_offset and pct_width are percent of spot. sl_mult is a multiple of the credit received; sl_pct and tp_pct are fractions of premium paid. entry_dte is days to expiry at entry. direction is CE or PE for directional structures, and must be omitted when a bias is set.",
              "properties": {
                "pct_offset": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 20
                },
                "pct_width": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 20
                },
                "sl_mult": {
                  "type": "number",
                  "exclusiveMinimum": 0
                },
                "sl_pct": {
                  "type": "number",
                  "exclusiveMinimum": 0,
                  "maximum": 1
                },
                "tp_pct": {
                  "type": "number",
                  "exclusiveMinimum": 0
                },
                "entry_dte": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 45
                },
                "entry_days_before": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 30,
                  "description": "Entry day as TRADING SESSIONS before expiry (0 = expiry day, 2 = 'T-2'), instead of calendar entry_dte. Set one or the other."
                },
                "direction": {
                  "type": "string",
                  "enum": [
                    "CE",
                    "PE"
                  ]
                }
              }
            },
            "entry_time": {
              "type": "string",
              "enum": [
                "09:15",
                "09:30",
                "11:00",
                "12:00",
                "12:30",
                "13:00",
                "14:00",
                "15:00",
                "EOD"
              ],
              "description": "IST. EOD is 15:29, the last tradeable minute."
            },
            "exit_time": {
              "type": "string",
              "enum": [
                "09:15",
                "09:30",
                "11:00",
                "12:00",
                "12:30",
                "13:00",
                "14:00",
                "15:00",
                "EOD"
              ],
              "description": "IST clock exit — squares the position off the SAME session, so it never reaches expiry. Omit to hold until a stop, a target or settlement. Must be after entry_time. Set this to express an intraday round trip such as in at 11:00, out at 14:00."
            },
            "cadence": {
              "type": "string",
              "enum": [
                "weekly",
                "daily"
              ],
              "description": "'weekly' (default) enters ONCE per expiry, on the day matching entry_dte — about 58 trades a year. 'daily' enters EVERY trading session on whichever expiry is nearest — about 246. Use 'daily' for anything described as 'every day'."
            },
            "max_dte": {
              "type": "integer",
              "minimum": 0,
              "maximum": 45,
              "description": "cadence 'daily' only: skip sessions where the nearest expiry is further out than this. max_dte 0 is expiry-day only."
            },
            "gate": {
              "type": "string",
              "description": "Entry filter; 'always' to disable."
            },
            "overlay": {
              "type": "string",
              "pattern": "^vol[0-9]{1,3}$",
              "description": "Volatility filter: 'vol20' skips a cycle when the index's 20-day realised volatility is above 20% at entry. Omit for none."
            },
            "bias": {
              "type": "string",
              "description": "Chooses the side each cycle for directional structures. 'neutral' to use a fixed direction instead."
            },
            "period": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "from": {
                  "type": "string"
                },
                "to": {
                  "type": "string"
                }
              },
              "description": "YYYY-MM-DD, inside 2025-07-01 to 2026-06-30."
            }
          }
        },
        {
          "type": "object",
          "required": [
            "legs"
          ],
          "additionalProperties": false,
          "description": "An open strategy: any legs, any rules. Covers what the presets cannot say — ratio spreads, calendars, diagonals, jade lizards, broken wings, delta- or premium-selected strikes, per-leg stops, rolling a tested side, trailing stops, entry conditions on the credit available, and book-level rules like standing down after three losers.",
          "properties": {
            "name": {
              "type": "string"
            },
            "symbol": {
              "type": "string",
              "enum": [
                "NIFTY"
              ]
            },
            "legs": {
              "type": "array",
              "minItems": 1,
              "maxItems": 12,
              "items": {
                "type": "object",
                "required": [
                  "side",
                  "type",
                  "strike"
                ],
                "additionalProperties": false,
                "properties": {
                  "side": {
                    "type": "string",
                    "enum": [
                      "sell",
                      "buy"
                    ]
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "CE",
                      "PE"
                    ]
                  },
                  "qty": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100,
                    "description": "lots of THIS leg relative to the others. Unequal quantities are how a ratio spread is written."
                  },
                  "expiry": {
                    "type": "string",
                    "enum": [
                      "near",
                      "next",
                      "far"
                    ],
                    "description": "'near' is the nearest expiry at entry; 'next' is the one after, which is how a calendar or diagonal is written."
                  },
                  "strike": {
                    "description": "How to pick the strike. One of: {\"pct_offset\": 1.0} percent from spot (negative for puts) | {\"points_offset\": 200} | \"atm\" | {\"strike\": 24000} | {\"premium_near\": 50} the strike whose last real print is nearest 50 points | {\"delta_near\": 0.20} | {\"from_leg\": {\"leg\": 0, \"pct\": 0.5}} relative to another leg. Add {\"ref\": \"entry\"} to measure from the spot at entry rather than the spot now."
                  },
                  "label": {
                    "type": "string"
                  }
                }
              },
              "description": "What to open. Leg order defines the indices rules use."
            },
            "entry": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "cadence": {
                  "type": "string",
                  "enum": [
                    "weekly",
                    "daily",
                    "monthly"
                  ],
                  "description": "weekly = one entry per weekly expiry; monthly = one per monthly expiry (the last of its calendar month); daily = one per session."
                },
                "time": {
                  "type": "string",
                  "description": "ANY minute of the session, e.g. '09:20'. Not a grid."
                },
                "dte": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 60,
                  "description": "weekly/monthly only: days before expiry to enter. Defaults to 4 weekly, 21 monthly."
                },
                "max_dte": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 60,
                  "description": "daily only: skip sessions further than this from expiry."
                },
                "when": {
                  "type": "object",
                  "description": "Optional gate on the cycle — the REASON for taking the trade. combined_premium is the credit on offer, so {\"combined_premium\": {\"gte\": 80}} means 'only if I collect 80 points'. Market state is here too: day_of_week, gap_pct, prev_day_move_pct, realised_vol_20d, vix, vix_change_pct, vix_prev_close. e.g. {\"vix\": {\"gte\": 15}}, {\"prev_day_move_pct\": {\"lte\": -1}}, {\"day_of_week\": {\"eq\": 1}} for Mondays. INDEX INDICATORS too, computed on closes up to YESTERDAY: rsi_N (0-100), close_vs_sma_N_pct and close_vs_ema_N_pct (per cent above/below the N-day average), ema_F_vs_S_pct and sma_F_vs_S_pct (fast against slow, positive = fast is above). N from 2 to 250. e.g. {\"rsi_14\": {\"lt\": 30}} for oversold, {\"close_vs_ema_50_pct\": {\"gt\": 0}} for 'above the 50-day', {\"ema_9_vs_21_pct\": {\"gt\": 0}} for a 9/21 crossover. All are knowable before the session — none can see the day's own close."
                }
              }
            },
            "rules": {
              "type": "array",
              "maxItems": 24,
              "description": "Checked every minute, in order; the first match fires. Fields: adjustments_done, combined_premium, credit_kept_frac, day_of_week, drawdown_from_peak, dte, gap_pct, leg_mark, leg_mark_delta, leg_mark_mult, leg_pnl_pts, minutes_held, pnl_frac_of_credit, pnl_frac_of_max, pnl_pts, pnl_rupees, prev_day_move_pct, realised_vol_20d, runup_from_trough, spot, spot_beyond_strike, spot_move_pct, spot_move_pts, time, vix, vix_change_pct, vix_prev_close. Actions: \"close\" | {\"close_legs\": [0]} | {\"open\": [leg,...]} | {\"roll\": {\"legs\": [0], \"to\": strike}} | {\"close_and_open\": {\"close\": [0], \"open\": [leg]}}.",
              "items": {
                "type": "object",
                "required": [
                  "when",
                  "then"
                ],
                "additionalProperties": false,
                "properties": {
                  "when": {
                    "type": "object"
                  },
                  "then": {},
                  "max_times": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "label": {
                    "type": "string"
                  }
                }
              }
            },
            "exit": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "time": {
                  "type": "string",
                  "description": "hard square-off at this minute on the entry day."
                },
                "when": {
                  "type": "object"
                }
              }
            },
            "max_adjustments": {
              "type": "integer",
              "minimum": 0,
              "maximum": 50,
              "description": "how many times the rules may change the position in one trade. Default 4."
            },
            "portfolio": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "stop_after_losses": {
                  "type": "integer",
                  "minimum": 1
                },
                "stop_after_drawdown_pct": {
                  "type": "number"
                },
                "stop_after_profit_pct": {
                  "type": "number"
                },
                "skip_after_loss": {
                  "type": "boolean"
                },
                "max_trades": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "description": "Rules over the SEQUENCE of trades, which no per-trade condition can express."
            },
            "resolution": {
              "type": "integer",
              "enum": [
                1,
                5,
                15
              ],
              "description": "minutes per rule check. 1 is the default and the honest one."
            },
            "period": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "from": {
                  "type": "string"
                },
                "to": {
                  "type": "string"
                }
              }
            }
          }
        }
      ]
    },
    "lots": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "detail": {
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "full"
      ],
      "description": "How much per-trade data to return. 'standard' (default) is the equity curve, breakdowns and the first 25 trades with their leg prices. 'full' returns up to 300 trades — ask for it when the caller wants to audit or chart every trade. 'summary' returns aggregates only, and is the cheapest to read."
    }
  },
  "required": [
    "spec"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "backtest_id": {
      "type": "string"
    },
    "report_url": {
      "type": "string"
    },
    "spec": {
      "type": "object",
      "additionalProperties": true
    },
    "summary": {
      "type": "object",
      "additionalProperties": true
    },
    "honesty": {
      "type": "object",
      "additionalProperties": true
    },
    "interpretation": {
      "type": "object",
      "additionalProperties": true
    },
    "methodology": {
      "type": "object",
      "additionalProperties": true
    },
    "equity_curve": {
      "type": "array"
    },
    "breakdown": {
      "type": "object",
      "additionalProperties": true
    },
    "trades": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "trade_detail": {
      "type": "object",
      "additionalProperties": true
    },
    "data_release": {
      "type": "object",
      "additionalProperties": true
    },
    "quota": {
      "type": "object",
      "additionalProperties": true
    },
    "strategy_book": {
      "type": "object",
      "additionalProperties": true
    },
    "cost_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": true
}

What data is available: symbols, date range, resolution, structures, gates, biases, the cost model, and every known gap.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string"
    },
    "resolution": {
      "type": "string"
    },
    "tier": {
      "type": "string"
    },
    "from": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

How a result is produced: entry pricing, settlement, margin, slippage, the honesty rubric, and what each check can and cannot establish.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "changelog",
        "common_mistakes",
        "contract_spec",
        "costs",
        "interpreting_results",
        "intraday",
        "liquidity",
        "margin",
        "overfitting",
        "overview",
        "sample_size",
        "slippage",
        "strategy_book",
        "structures",
        "validation",
        "what_is_returned"
      ]
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "body": {
      "type": "string"
    },
    "topics": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": true
}

The account's backtests, newest first, with id, date, trade count, net P&L and report URL. Answers a request for the most recent run, which list_strategies does not: that one returns only results that passed the evidence checks, ranked by consistency rather than by date.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "backtests": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "backtest_id": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "n_trades": {
            "type": "integer"
          },
          "net_pnl_rupees": {
            "type": "number"
          },
          "report_url": {
            "type": "string"
          }
        }
      }
    },
    "count": {
      "type": "integer"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Retrieve a previous backtest result by its id — honesty panel, equity curve and per-trade detail, exactly as first computed.

{
  "type": "object",
  "properties": {
    "backtest_id": {
      "type": "string"
    },
    "detail": {
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "full"
      ]
    }
  },
  "required": [
    "backtest_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "backtest_id": {
      "type": "string"
    },
    "report_url": {
      "type": "string"
    },
    "spec": {
      "type": "object",
      "additionalProperties": true
    },
    "summary": {
      "type": "object",
      "additionalProperties": true
    },
    "honesty": {
      "type": "object",
      "additionalProperties": true
    },
    "trades": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "trade_detail": {
      "type": "object",
      "additionalProperties": true
    },
    "data_release": {
      "type": "object",
      "additionalProperties": true
    },
    "detail_note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Strategies from THIS account's history that held up under out-of-sample and walk-forward checks, not merely ones that made money. Ranked by worst walk-forward fold — consistency, not size. Answers what has worked on this account so far without re-running anything.

{
  "type": "object",
  "properties": {
    "order": {
      "type": "string",
      "enum": [
        "consistency",
        "health",
        "pnl"
      ],
      "description": "'consistency' (default) sorts by worst walk-forward fold, then median fold. 'pnl' sorts by total P&L and is the ranking most likely to put an overfit at the top."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "strategies": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "count": {
      "type": "integer"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Search what this service covers — symbols, dates, structures, signals, methodology. Returns ids usable with fetch.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        }
      }
    }
  },
  "additionalProperties": true
}

Fetch a document or backtest result by id, as returned by search.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}

Files a bug report or feature request when the user asks to report something. Confirm the title and body with the user before filing. Passing backtest_id attaches that backtest's spec so the issue can be reproduced.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 160,
      "description": "One line naming the problem or request."
    },
    "body": {
      "type": "string",
      "maxLength": 4000,
      "description": "What was expected, what happened, and any spec involved. Write it from the user's report, not from your own summary of it."
    },
    "category": {
      "type": "string",
      "enum": [
        "bug",
        "confusing",
        "data_gap",
        "feature_request",
        "other",
        "performance",
        "praise",
        "pricing"
      ],
      "description": "Omit it and it will be inferred from the text."
    },
    "severity": {
      "type": "string",
      "enum": [
        "blocker",
        "idea",
        "major",
        "minor"
      ]
    },
    "backtest_id": {
      "type": "string",
      "description": "The result this is about, if any."
    }
  },
  "required": [
    "title",
    "body"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "feedback_id": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "severity": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Creates a shareable report page for a backtest the user owns and returns its URL. The page carries the honesty panel, equity and drawdown curves, walk-forward folds, the gross-to-net breakdown, a month grid and the trade table, computed from the stored backtest. Use when the user asks for a report or something to share.

{
  "type": "object",
  "properties": {
    "backtest_id": {
      "type": "string",
      "description": "From a previous run_backtest."
    },
    "format": {
      "type": "string",
      "enum": [
        "artifact",
        "link",
        "full"
      ],
      "default": "link",
      "description": "'link' (default) returns the hosted URL of the report page. 'artifact' returns the whole self-contained HTML document as well, which costs considerably more tokens. 'full' builds the full strategy report and returns its link: the strategy's rules in plain English, what it did to a given capital, every trade plotted on a zoomable NIFTY chart, the evidence panel and the capital curve. 'full' is rate limited."
    },
    "capital": {
      "type": "integer",
      "minimum": 100000,
      "maximum": 100000000,
      "description": "format 'full' only. Starting capital in rupees. It sets the report's OPENING view — the reader can change it in the page without a new report. Default 1,000,000."
    },
    "deploy_pct": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "description": "format 'full' only. Percent of capital used as margin on any one trade. Default 10."
    },
    "risk_pct": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 100,
      "description": "format 'full' only. Size by RISK instead of margin: the percent of capital the trade is allowed to lose in its worst case (2 means 'risk 2% per trade'). Only works where the position has a bounded worst case — a naked short does not, and the call is refused with that reason rather than sized off a guess. Overrides deploy_pct."
    }
  },
  "required": [
    "backtest_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "backtest_id": {
      "type": "string"
    },
    "report_url": {
      "type": "string"
    },
    "mime_type": {
      "type": "string"
    },
    "document": {
      "type": "string"
    },
    "bytes": {
      "type": "integer"
    },
    "contains": {
      "type": "object",
      "additionalProperties": true
    },
    "document_properties": {
      "type": "object",
      "additionalProperties": true
    },
    "message": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Reports this account has filed, and where each one stands. Use it to answer 'did that bug I reported ever get fixed?'.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "count": {
      "type": "integer"
    }
  },
  "additionalProperties": true
}