Brighter

List the strategies published on brighter.fi, newest or best-performing first. Each carries its rebalance cadence, the assets it can hold, and its return over the chosen period against its benchmark. Strategies that can hold leveraged or inverse funds are excluded unless asked for.

{
  "type": "object",
  "properties": {
    "assets": {
      "description": "Only strategies that can hold any of these tickers.",
      "items": {
        "type": "string"
      },
      "maxItems": 30,
      "type": "array"
    },
    "beatsBenchmark": {
      "description": "Only strategies ahead of their benchmark over the period.",
      "type": "boolean"
    },
    "cadence": {
      "description": "Only these rebalance cadences.",
      "items": {
        "enum": [
          "daily",
          "weekly",
          "monthly"
        ],
        "type": "string"
      },
      "maxItems": 3,
      "type": "array"
    },
    "leveraged": {
      "description": "Include strategies that can hold leveraged or inverse funds. Off by default.",
      "type": "boolean"
    },
    "limit": {
      "description": "How many to return.",
      "maximum": 24,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "description": "Where to start, for paging.",
      "maximum": 10000,
      "minimum": 0,
      "type": "integer"
    },
    "period": {
      "description": "Window the returns cover.",
      "enum": [
        "1y",
        "3y",
        "5y"
      ],
      "type": "string"
    },
    "sort": {
      "description": "Order of the list.",
      "enum": [
        "return",
        "newest"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

One strategy in full: what its rule does, the parameters you can tune with their ranges and defaults, every asset it can hold, and its benchmark. Use the parameter keys with backtest_strategy.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Strategy id, as list_strategies returns it.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Run a published strategy over real market history with parameters of your choosing. Returns its figures against its benchmark. Values outside a parameter's range are snapped into it. This is a real backtest, so make each one count.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Strategy id.",
      "type": "string"
    },
    "params": {
      "additionalProperties": {
        "type": "number"
      },
      "description": "Parameter values by key, from get_strategy. Omitted keys use their default.",
      "type": "object"
    },
    "range": {
      "description": "Backtest window. Only these are kept warm; anything else is refused.",
      "enum": [
        "1y",
        "3y",
        "5y"
      ],
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

What a published strategy's rule holds right now, in basis points of the portfolio. This is the live target, computed from the latest close.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Strategy id.",
      "type": "string"
    },
    "params": {
      "additionalProperties": {
        "type": "number"
      },
      "description": "Parameter values by key. Omitted keys use their default.",
      "type": "object"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Search the assets a Brighter strategy can hold — tokenized US stocks, ETFs and T-bills. A rule may only name a ticker that appears here.

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "How many to return.",
      "maximum": 30,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "description": "Where to start.",
      "maximum": 1000,
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "description": "Match against ticker or company name.",
      "type": "string"
    },
    "tickers": {
      "description": "Look up these exact tickers.",
      "items": {
        "type": "string"
      },
      "maxItems": 30,
      "type": "array"
    }
  },
  "additionalProperties": false
}

Daily closing prices for one asset over a calendar year, for checking a rule's premise against what actually happened.

{
  "type": "object",
  "properties": {
    "ticker": {
      "description": "Asset ticker, as find_assets returns it.",
      "type": "string"
    },
    "year": {
      "description": "Calendar year.",
      "maximum": 2100,
      "minimum": 2000,
      "type": "integer"
    }
  },
  "required": [
    "ticker",
    "year"
  ],
  "additionalProperties": false
}

How to write a Brighter strategy: the language's blocks, indentation rules, indicators and limits. Read this before writing any rule — the language is small and specific, and guessing its syntax wastes a turn.

{
  "type": "object",
  "properties": {
    "indicators": {
      "description": "Include the full indicator table with every measure's syntax. Off by default; the reference already names them.",
      "type": "boolean"
    },
    "limits": {
      "description": "Include the numeric limits a rule must stay inside.",
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

The JSON schema for a strategy as an object, for when you would rather build the rule tree than write the text. check_strategy and backtest_code both accept text, which is usually easier.

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

Check a strategy written in Brighter's language: syntax, semantics, and whether every ticker it names is one Brighter can actually trade. Returns the faults with their line and column. Costs nothing and calls nothing upstream — check before you backtest.

{
  "type": "object",
  "properties": {
    "code": {
      "description": "The strategy, in Brighter's language.",
      "type": "string"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

Rewrite a strategy in the language's canonical form — the spelling Studio's editor shows. Useful for checking that what you wrote means what you think it means.

{
  "type": "object",
  "properties": {
    "code": {
      "description": "The strategy, in Brighter's language.",
      "type": "string"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

Run a strategy you have written against real market history and return its figures. This is a real backtest against real prices — not a simulation and not cached per call — so run it deliberately, after check_strategy passes. Returns metrics only, never the curve.

{
  "type": "object",
  "properties": {
    "code": {
      "description": "The strategy, in Brighter's language.",
      "type": "string"
    },
    "range": {
      "description": "Window to test over.",
      "enum": [
        "1y",
        "3y",
        "5y"
      ],
      "type": "string"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}