{
  "x402Version": 2,
  "id": 72386,
  "slug": "saylorinnovations-api-finance-portfolio-risk",
  "resource": "https://saylorinnovations.com/api/finance/portfolio-risk",
  "description": "Risk metrics from a price or return series - annualised return and volatility, Sharpe, Sortino, Calmar, max drawdown, 95 percent VaR, expected shortfall and skew",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95830",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "observations": {
        "type": "number",
        "description": "Observations in time order"
      },
      "input_type": {
        "type": "string",
        "description": "Input type"
      },
      "total_return_percent": {
        "type": "number",
        "description": "Total return percent"
      },
      "annualised_return_percent": {
        "type": "number",
        "description": "Annualised return, as a percentage"
      },
      "annualised_volatility_percent": {
        "type": "number",
        "description": "Annualised volatility, as a percentage"
      },
      "sharpe_ratio": {
        "type": [
          "number",
          "null"
        ],
        "description": "Sharpe ratio"
      },
      "sortino_ratio": {
        "type": [
          "number",
          "null"
        ],
        "description": "Sortino ratio"
      },
      "max_drawdown_percent": {
        "type": "number",
        "description": "Max drawdown, as a percentage"
      },
      "value_at_risk_95_percent": {
        "type": "number",
        "description": "Value at risk 95, as a percentage"
      },
      "expected_shortfall_95_percent": {
        "type": "number",
        "description": "Expected shortfall 95, as a percentage"
      },
      "note": {
        "type": "string",
        "description": "Caveat or context for reading the result"
      },
      "source": {
        "type": "string",
        "description": "Data source the values come from"
      },
      "skewness": {
        "description": "Skewness of returns; negative means a longer left tail",
        "type": [
          "number",
          "null"
        ]
      },
      "periods_per_year": {
        "type": [
          "number",
          "null"
        ],
        "description": "Periods per year"
      },
      "calmar_ratio": {
        "type": [
          "number",
          "null"
        ],
        "description": "Calmar ratio"
      },
      "max_drawdown_peak_index": {
        "type": [
          "number",
          "null"
        ],
        "description": "Max drawdown peak index"
      },
      "max_drawdown_trough_index": {
        "type": [
          "number",
          "null"
        ],
        "description": "Max drawdown trough index"
      },
      "currently_in_drawdown_percent": {
        "type": [
          "number",
          "null"
        ],
        "description": "Currently in drawdown, as a percentage"
      },
      "best_period_percent": {
        "type": [
          "number",
          "null"
        ],
        "description": "Best period, as a percentage"
      },
      "worst_period_percent": {
        "type": [
          "number",
          "null"
        ],
        "description": "Worst period, as a percentage"
      },
      "positive_periods_percent": {
        "type": [
          "number",
          "null"
        ],
        "description": "Positive periods, as a percentage"
      },
      "excess_kurtosis": {
        "type": [
          "number",
          "null"
        ],
        "description": "Excess kurtosis"
      }
    },
    "required": [
      "observations",
      "sharpe_ratio",
      "max_drawdown_percent"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "periods_per_year": "252",
            "prices": "100,102,101,105,103,108,107,111,109,114"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "observations": 9,
            "input_type": "prices",
            "periods_per_year": 252,
            "total_return_percent": 14,
            "annualised_return_percent": 3820.449,
            "annualised_volatility_percent": 45.812,
            "sharpe_ratio": 8.268,
            "sortino_ratio": 24.278,
            "calmar_ratio": 2005.736,
            "max_drawdown_percent": -1.905,
            "max_drawdown_peak_index": 3,
            "max_drawdown_trough_index": 4,
            "currently_in_drawdown_percent": 0,
            "best_period_percent": 4.854,
            "worst_period_percent": -1.905,
            "positive_periods_percent": 55.6,
            "value_at_risk_95_percent": 1.905,
            "expected_shortfall_95_percent": 1.905,
            "skewness": -0.056,
            "excess_kurtosis": -2.031,
            "note": "Computed from the series you supply; historical VaR is the 5th percentile loss per period and expected shortfall the mean of the worst 5%. Sharpe and Sortino use the annual risk-free rate you pass (default 0). Past performance does not predict future results.",
            "source": "sample statistics"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "periods_per_year": {
                    "type": "string",
                    "description": "optional, default 252 (daily); 12 monthly, 52 weekly"
                  },
                  "prices": {
                    "type": "string",
                    "description": "Comma-separated prices (5-1000 values)"
                  }
                },
                "required": [
                  "prices"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "observations": {
                    "type": "number",
                    "description": "Observations in time order"
                  },
                  "input_type": {
                    "type": "string",
                    "description": "Input type"
                  },
                  "total_return_percent": {
                    "type": "number",
                    "description": "Total return percent"
                  },
                  "annualised_return_percent": {
                    "type": "number",
                    "description": "Annualised return, as a percentage"
                  },
                  "annualised_volatility_percent": {
                    "type": "number",
                    "description": "Annualised volatility, as a percentage"
                  },
                  "sharpe_ratio": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Sharpe ratio"
                  },
                  "sortino_ratio": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Sortino ratio"
                  },
                  "max_drawdown_percent": {
                    "type": "number",
                    "description": "Max drawdown, as a percentage"
                  },
                  "value_at_risk_95_percent": {
                    "type": "number",
                    "description": "Value at risk 95, as a percentage"
                  },
                  "expected_shortfall_95_percent": {
                    "type": "number",
                    "description": "Expected shortfall 95, as a percentage"
                  },
                  "note": {
                    "type": "string",
                    "description": "Caveat or context for reading the result"
                  },
                  "source": {
                    "type": "string",
                    "description": "Data source the values come from"
                  },
                  "skewness": {
                    "description": "Skewness of returns; negative means a longer left tail",
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "periods_per_year": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Periods per year"
                  },
                  "calmar_ratio": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Calmar ratio"
                  },
                  "max_drawdown_peak_index": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Max drawdown peak index"
                  },
                  "max_drawdown_trough_index": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Max drawdown trough index"
                  },
                  "currently_in_drawdown_percent": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Currently in drawdown, as a percentage"
                  },
                  "best_period_percent": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Best period, as a percentage"
                  },
                  "worst_period_percent": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Worst period, as a percentage"
                  },
                  "positive_periods_percent": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Positive periods, as a percentage"
                  },
                  "excess_kurtosis": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Excess kurtosis"
                  }
                },
                "required": [
                  "observations",
                  "sharpe_ratio",
                  "max_drawdown_percent"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "sharpe ratio from a price series",
    "max drawdown calculator",
    "portfolio volatility and var",
    "sortino ratio from returns",
    "risk metrics for a strategy"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.940Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "periods_per_year": {
          "type": "string",
          "description": "optional, default 252 (daily); 12 monthly, 52 weekly"
        },
        "prices": {
          "type": "string",
          "description": "Comma-separated prices (5-1000 values)"
        }
      },
      "required": [
        "prices"
      ]
    },
    "exampleResponse": {
      "observations": 9,
      "input_type": "prices",
      "periods_per_year": 252,
      "total_return_percent": 14,
      "annualised_return_percent": 3820.449,
      "annualised_volatility_percent": 45.812,
      "sharpe_ratio": 8.268,
      "sortino_ratio": 24.278,
      "calmar_ratio": 2005.736,
      "max_drawdown_percent": -1.905,
      "max_drawdown_peak_index": 3,
      "max_drawdown_trough_index": 4,
      "currently_in_drawdown_percent": 0,
      "best_period_percent": 4.854,
      "worst_period_percent": -1.905,
      "positive_periods_percent": 55.6,
      "value_at_risk_95_percent": 1.905,
      "expected_shortfall_95_percent": 1.905,
      "skewness": -0.056,
      "excess_kurtosis": -2.031,
      "note": "Computed from the series you supply; historical VaR is the 5th percentile loss per period and expected shortfall the mean of the worst 5%. Sharpe and Sortino use the annual risk-free rate you pass (default 0). Past performance does not predict future results.",
      "source": "sample statistics"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "periods_per_year": "252",
              "prices": "100,102,101,105,103,108,107,111,109,114"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "observations": 9,
              "input_type": "prices",
              "periods_per_year": 252,
              "total_return_percent": 14,
              "annualised_return_percent": 3820.449,
              "annualised_volatility_percent": 45.812,
              "sharpe_ratio": 8.268,
              "sortino_ratio": 24.278,
              "calmar_ratio": 2005.736,
              "max_drawdown_percent": -1.905,
              "max_drawdown_peak_index": 3,
              "max_drawdown_trough_index": 4,
              "currently_in_drawdown_percent": 0,
              "best_period_percent": 4.854,
              "worst_period_percent": -1.905,
              "positive_periods_percent": 55.6,
              "value_at_risk_95_percent": 1.905,
              "expected_shortfall_95_percent": 1.905,
              "skewness": -0.056,
              "excess_kurtosis": -2.031,
              "note": "Computed from the series you supply; historical VaR is the 5th percentile loss per period and expected shortfall the mean of the worst 5%. Sharpe and Sortino use the annual risk-free rate you pass (default 0). Past performance does not predict future results.",
              "source": "sample statistics"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "periods_per_year": {
                      "type": "string",
                      "description": "optional, default 252 (daily); 12 monthly, 52 weekly"
                    },
                    "prices": {
                      "type": "string",
                      "description": "Comma-separated prices (5-1000 values)"
                    }
                  },
                  "required": [
                    "prices"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "observations": {
                      "type": "number",
                      "description": "Observations in time order"
                    },
                    "input_type": {
                      "type": "string",
                      "description": "Input type"
                    },
                    "total_return_percent": {
                      "type": "number",
                      "description": "Total return percent"
                    },
                    "annualised_return_percent": {
                      "type": "number",
                      "description": "Annualised return, as a percentage"
                    },
                    "annualised_volatility_percent": {
                      "type": "number",
                      "description": "Annualised volatility, as a percentage"
                    },
                    "sharpe_ratio": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Sharpe ratio"
                    },
                    "sortino_ratio": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Sortino ratio"
                    },
                    "max_drawdown_percent": {
                      "type": "number",
                      "description": "Max drawdown, as a percentage"
                    },
                    "value_at_risk_95_percent": {
                      "type": "number",
                      "description": "Value at risk 95, as a percentage"
                    },
                    "expected_shortfall_95_percent": {
                      "type": "number",
                      "description": "Expected shortfall 95, as a percentage"
                    },
                    "note": {
                      "type": "string",
                      "description": "Caveat or context for reading the result"
                    },
                    "source": {
                      "type": "string",
                      "description": "Data source the values come from"
                    },
                    "skewness": {
                      "description": "Skewness of returns; negative means a longer left tail",
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "periods_per_year": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Periods per year"
                    },
                    "calmar_ratio": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Calmar ratio"
                    },
                    "max_drawdown_peak_index": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Max drawdown peak index"
                    },
                    "max_drawdown_trough_index": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Max drawdown trough index"
                    },
                    "currently_in_drawdown_percent": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Currently in drawdown, as a percentage"
                    },
                    "best_period_percent": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Best period, as a percentage"
                    },
                    "worst_period_percent": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Worst period, as a percentage"
                    },
                    "positive_periods_percent": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Positive periods, as a percentage"
                    },
                    "excess_kurtosis": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Excess kurtosis"
                    }
                  },
                  "required": [
                    "observations",
                    "sharpe_ratio",
                    "max_drawdown_percent"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/finance/portfolio-risk?prices=100,102,101,105,103,108,107,111,109,114&periods_per_year=252",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "observations": 0,
    "input_type": "string",
    "total_return_percent": 0,
    "annualised_return_percent": 0,
    "annualised_volatility_percent": 0,
    "sharpe_ratio": 0,
    "sortino_ratio": 0,
    "max_drawdown_percent": 0,
    "value_at_risk_95_percent": 0,
    "expected_shortfall_95_percent": 0,
    "note": "string",
    "source": "string",
    "skewness": 0,
    "periods_per_year": 0,
    "calmar_ratio": 0,
    "max_drawdown_peak_index": 0,
    "max_drawdown_trough_index": 0,
    "currently_in_drawdown_percent": 0,
    "best_period_percent": 0,
    "worst_period_percent": 0,
    "positive_periods_percent": 0,
    "excess_kurtosis": 0
  }
}