Skip to main content
POST
/
backtest
Backtest a portfolio of companies
curl --request POST \
  --url https://api.noonum.ai/v1/backtest \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "holdings": [
    {
      "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "weight": 0.5
    }
  ],
  "years": 5,
  "benchmark": "SPY"
}
'
{
  "metadata": {
    "returns": 0.7955,
    "annualizedReturn": 0.1242,
    "variance": 0.1637,
    "sharpeRatio": 0.76,
    "maxDrawdown": -0.2747,
    "stockCount": 20,
    "weekCount": 260,
    "warnings": [
      "<string>"
    ]
  },
  "timeSeries": [
    [
      1594339200,
      10000
    ],
    [
      1594944000,
      10156.8
    ]
  ],
  "benchmarkMetadata": {
    "symbol": "SPY",
    "returns": 0.6512,
    "annualizedReturn": 0.1058,
    "variance": 0.1423,
    "sharpeRatio": 0.74,
    "maxDrawdown": -0.2385
  },
  "benchmarkTimeSeries": [
    [
      1594339200,
      10000
    ],
    [
      1594944000,
      10089.5
    ]
  ]
}

Authorizations

​
Authorization
string
header
required

Enter 'Bearer' followed by a space and then your JWT or API Key. Example: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... or Bearer YOUR_API_KEY_HERE

Body

application/json
​
holdings
object[]
required
​
years
integer
default:5
Required range: 1 <= x <= 20
​
benchmark
string
default:SPY

Benchmark symbol for comparison (e.g. SPY, QQQ)

Response

Backtest results

​
metadata
object
​
timeSeries
number[][]
Example:
[[1594339200, 10000], [1594944000, 10156.8]]
​
benchmarkMetadata
object

Performance statistics for the benchmark

​
benchmarkTimeSeries
number[][]

Benchmark price series rebased to 10000, aligned to portfolio dates

Example:
[[1594339200, 10000], [1594944000, 10089.5]]