get_agentspec_reference

The exact AgentSpec JSON schema + indicator list + grade-report shape. Read this BEFORE constructing a spec for grade_strategy. Free, no key needed.

Parameters

No parameters.

Raw schema

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

grade_strategy

Backtest + grade an AgentSpec on 6 years of real data: 60/40 chronological train/OOS split, fees modeled, five hard gates (positive OOS expectancy, clears cost hurdle, robust across assets, survivable drawdown, not overfit). Returns the full grade report and a permanent public verify URL. Requires an API key (free at tessen.ai/studio/keys). Call get_agentspec_reference first for the schema.

Parameters

agentSpec

object

required

AgentSpec per get_agentspec_reference

Raw schema

{
  "type": "object",
  "properties": {
    "agentSpec": {
      "type": "object",
      "description": "AgentSpec per get_agentspec_reference"
    }
  },
  "required": [
    "agentSpec"
  ]
}

grade_trade_record

Grade the caller's OWN trade history (>=30 trades) instead of a backtest — chronologically 60/40 split, same gates. Marked 'Checked' not 'Verified' since the data is self-supplied. Requires an API key.

Parameters

trades	array	required
risk_per_trade_pct	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "trades": {
      "type": "array",
      "minItems": 30,
      "items": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string"
          },
          "entry_ts": {
            "type": "number",
            "description": "epoch seconds (ordering only)"
          },
          "net_return_pct": {
            "type": "number",
            "description": "e.g. 1.5 == +1.5% net of costs"
          }
        },
        "required": [
          "symbol",
          "entry_ts",
          "net_return_pct"
        ]
      }
    },
    "risk_per_trade_pct": {
      "type": "number",
      "default": 1
    }
  },
  "required": [
    "trades"
  ]
}

get_grade_report

Fetch any existing grade by its gradeId (the id in a tessen.ai/verify/... URL). Free, no key needed.

Parameters

gradeId

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "gradeId": {
      "type": "string"
    }
  },
  "required": [
    "gradeId"
  ]
}

get_corpus_insights

Honest aggregates over every strategy ever graded on Tessen: grade distribution, gate fail rates, the win-rate trap, and timeframe/indicator bucket base rates. Free, no key needed.

Parameters

No parameters.

Raw schema

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

Grader

get_agentspec_reference

grade_strategy

grade_trade_record

get_grade_report

get_corpus_insights

Install

Remote endpoint