
Check normalized portfolios against mandates and calculate allocation constraints.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Calculate explicit portfolio constraints deterministically from normalized holdings. Use this for arithmetic checks, not for interpreting natural-language mandates.
Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Calculate explicit portfolio constraints deterministically from normalized holdings. Use this for arithmetic checks, not for interpreting natural-language mandates.
| Argument | Type | Description |
|---|---|---|
| holdings* | array | |
| constraints* | array | |
| analysis_name | any | Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key. |
| base_currency | string | |
| idempotency_key* | string | |
| source_warnings | any | |
| composition_scope | string |
{
"type": "object",
"$defs": {
"ExposureFilter": {
"type": "object",
"title": "ExposureFilter",
"required": [
"dimension",
"match",
"values"
],
"properties": {
"match": {
"enum": [
"equals",
"not_equals",
"in",
"not_in"
],
"type": "string",
"title": "Match"
},
"values": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"title": "Values",
"maxItems": 100,
"minItems": 1
},
"dimension": {
"enum": [
"denomination_currency",
"country",
"domicile",
"issuer_country",
"listing_country",
"asset_class",
"rating",
"sector"
],
"type": "string",
"title": "Dimension"
}
},
"additionalProperties": false
},
"AlignmentHolding": {
"type": "object",
"title": "AlignmentHolding",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"title": "Id",
"maxLength": 120,
"minLength": 1
},
"name": {
"type": "string",
"title": "Name",
"maxLength": 500,
"minLength": 1
},
"value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Value",
"default": null
},
"weight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Weight",
"default": null,
"description": "Portfolio weight. Prefer a decimal share such as 0.24 for 24%. Percentage-point inputs such as 24 are also accepted and normalized when the supplied holdings use that convention."
},
"currency": {
"type": "string",
"title": "Currency",
"default": "",
"maxLength": 16
},
"attributes": {
"type": "object",
"title": "Attributes",
"maxProperties": 100,
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"source_reference": {
"type": "string",
"title": "Source Reference",
"default": "",
"maxLength": 500
}
},
"additionalProperties": false
},
"DeterministicConstraint": {
"type": "object",
"title": "DeterministicConstraint",
"required": [
"id",
"metric",
"operator"
],
"properties": {
"id": {
"type": "string",
"title": "Id",
"maxLength": 120,
"minLength": 1
},
"top_n": {
"anyOf": [
{
"type": "integer",
"maximum": 1000,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Top N",
"default": null
},
"metric": {
"enum": [
"single_holding_weight",
"selected_holdings_weight",
"filtered_holdings_weight",
"top_n_holdings_weight",
"holding_count",
"total_weight"
],
"type": "string",
"title": "Metric"
},
"operator": {
"enum": [
"<",
"<=",
"=",
"!=",
">=",
">",
"range"
],
"type": "string",
"title": "Operator"
},
"max_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max Value",
"default": null
},
"min_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Min Value",
"default": null
},
"threshold": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Threshold",
"default": null
},
"holding_ids": {
"type": "array",
"items": {
"type": "string"
},
"title": "Holding Ids",
"maxItems": 1000
},
"exposure_filter": {
"anyOf": [
{
"$ref": "#/$defs/ExposureFilter"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
}
},
"title": "calculate_portfolio_constraintsArguments",
"required": [
"holdings",
"constraints",
"idempotency_key"
],
"properties": {
"holdings": {
"type": "array",
"items": {
"$ref": "#/$defs/AlignmentHolding"
},
"title": "Holdings",
"maxItems": 1000,
"minItems": 1
},
"constraints": {
"type": "array",
"items": {
"$ref": "#/$defs/DeterministicConstraint"
},
"title": "Constraints",
"maxItems": 250,
"minItems": 1
},
"analysis_name": {
"anyOf": [
{
"type": "string",
"maxLength": 255,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Analysis Name",
"default": null,
"description": "Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key."
},
"base_currency": {
"type": "string",
"title": "Base Currency",
"default": "USD",
"maxLength": 16,
"minLength": 1
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"maxLength": 255,
"minLength": 1
},
"source_warnings": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"maxItems": 100
},
{
"type": "null"
}
],
"title": "Source Warnings",
"default": null
},
"composition_scope": {
"enum": [
"complete",
"partial",
"unknown"
],
"type": "string",
"title": "Composition Scope",
"default": "unknown"
}
}
}Calculate historical return, volatility, drawdown, risk-adjusted and benchmark-relative statistics from a confirmed portfolio series profile. The metrics parameter describes all available calculations and their required inputs. Use daily, weekly or monthly complete periods; results include coverage, warnings and exact dataset/profile pins. Reuse an idempotency_key only for an identical calculation.
| Argument | Type | Description |
|---|---|---|
| metrics* | array | Select one or more unique metric names. periodic_returns: Return for each complete period at target_frequency. cumulative_return: Compounded return across the selected complete periods. observation_count: Number of source observations in the selected date range. period_count: Number of complete return periods available for calculation. min_return: Lowest periodic return and its period end date. max_return: Highest periodic return and its period end date. volatility: Sample standard deviation of periodic returns, with annualized volatility. drawdown: Decline from the running peak of compounded wealth for each period. max_drawdown: Largest peak-to-trough decline, with peak, trough and recovery dates when available. downside_deviation: Root mean square shortfall below minimum_acceptable_return, with annualized deviation. Requires minimum_acceptable_return. sharpe: Mean return above risk_free_rate divided by the sample standard deviation of excess returns, with annualized ratio. Requires risk_free_rate. sortino: Mean return above minimum_acceptable_return divided by downside deviation, with annualized ratio. Requires minimum_acceptable_return. beta: Sensitivity of portfolio returns to benchmark returns. Requires benchmark_profile_id. alpha: Return above the benchmark return implied by beta and risk_free_rate, with annualized alpha. Requires benchmark_profile_id and risk_free_rate. correlation: Pearson correlation between portfolio and benchmark returns. Requires benchmark_profile_id. tracking_error: Sample standard deviation of portfolio-minus-benchmark returns, with annualized tracking error. Requires benchmark_profile_id. information_ratio: Mean portfolio-minus-benchmark return divided by tracking error, with annualized ratio. Requires benchmark_profile_id. |
Cancel a pending upload and permanently remove its staging chunks.
| Argument | Type | Description |
|---|---|---|
| upload_id* | string | |
| analysis_name | any | Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key. |
{
"type": "object",
"title": "cancel_portfolio_series_uploadArguments",
"required": [
"upload_id"
],
"properties": {
"upload_id": {
"type": "string",
"title": "Upload Id",
"format": "uuid"
},
"analysis_name": {
"anyOf": [
{
"type": "string",
"maxLength": 255,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Analysis Name",
"default": null,
"description": "Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key."
}
}
}Compare a clean mandate with normalized holdings. Do not send PDF, CSV, spreadsheet, or factsheet files; extract them before calling.
| Argument | Type | Description |
|---|---|---|
| rules | any | |
| mandate | string | |
| holdings* | array | |
| analysis_name | any | Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key. |
| base_currency | string | |
| portfolio_name | string | |
| idempotency_key* | string | |
| source_warnings | any | |
| composition_scope | string |
{
"type": "object",
"$defs": {
"AlignmentRule": {
"type": "object",
"title": "AlignmentRule",
"required": [
"target",
"operator"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Id",
"default": null
},
"unit": {
"type": "string",
"title": "Unit",
"default": "percent",
"maxLength": 64
},
"title": {
"type": "string",
"title": "Title",
"default": "",
"maxLength": 200
},
"target": {
"type": "string",
"title": "Target",
"maxLength": 500,
"minLength": 1
},
"enabled": {
"type": "boolean",
"title": "Enabled",
"default": true
},
"operator": {
"enum": [
"<",
"<=",
"=",
"!=",
">=",
">",
"range"
],
"type": "string",
"title": "Operator"
},
"max_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max Value",
"default": null
},
"min_value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Min Value",
"default": null
},
"threshold": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Threshold",
"default": null
},
"explanation": {
"type": "string",
"title": "Explanation",
"default": "",
"maxLength": 2000
},
"exposure_filter": {
"anyOf": [
{
"$ref": "#/$defs/ExposureFilter"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
},
"ExposureFilter": {
"type": "object",
"title": "ExposureFilter",
"required": [
"dimension",
"match",
"values"
],
"properties": {
"match": {
"enum": [
"equals",
"not_equals",
"in",
"not_in"
],
"type": "string",
"title": "Match"
},
"values": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"title": "Values",
"maxItems": 100,
"minItems": 1
},
"dimension": {
"enum": [
"denomination_currency",
"country",
"domicile",
"issuer_country",
"listing_country",
"asset_class",
"rating",
"sector"
],
"type": "string",
"title": "Dimension"
}
},
"additionalProperties": false
},
"AlignmentHolding": {
"type": "object",
"title": "AlignmentHolding",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"title": "Id",
"maxLength": 120,
"minLength": 1
},
"name": {
"type": "string",
"title": "Name",
"maxLength": 500,
"minLength": 1
},
"value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Value",
"default": null
},
"weight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Weight",
"default": null,
"description": "Portfolio weight. Prefer a decimal share such as 0.24 for 24%. Percentage-point inputs such as 24 are also accepted and normalized when the supplied holdings use that convention."
},
"currency": {
"type": "string",
"title": "Currency",
"default": "",
"maxLength": 16
},
"attributes": {
"type": "object",
"title": "Attributes",
"maxProperties": 100,
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"source_reference": {
"type": "string",
"title": "Source Reference",
"default": "",
"maxLength": 500
}
},
"additionalProperties": false
}
},
"title": "evaluate_portfolio_alignmentArguments",
"required": [
"holdings",
"idempotency_key"
],
"properties": {
"rules": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/AlignmentRule"
},
"maxItems": 250
},
{
"type": "null"
}
],
"title": "Rules",
"default": null
},
"mandate": {
"type": "string",
"title": "Mandate",
"default": "",
"maxLength": 50000
},
"holdings": {
"type": "array",
"items": {
"$ref": "#/$defs/AlignmentHolding"
},
"title": "Holdings",
"maxItems": 1000,
"minItems": 1
},
"analysis_name": {
"anyOf": [
{
"type": "string",
"maxLength": 255,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Analysis Name",
"default": null,
"description": "Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key."
},
"base_currency": {
"type": "string",
"title": "Base Currency",
"default": "USD",
"maxLength": 16,
"minLength": 1
},
"portfolio_name": {
"type": "string",
"title": "Portfolio Name",
"default": "Portfolio",
"maxLength": 255
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"maxLength": 255,
"minLength": 1
},
"source_warnings": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"maxItems": 100
},
{
"type": "null"
}
],
"title": "Source Warnings",
"default": null
},
"composition_scope": {
"enum": [
"complete",
"partial",
"unknown"
],
"type": "string",
"title": "Composition Scope",
"default": "unknown"
}
}
}Read retained normalized inputs, operations, results and owner-scoped dataset references. This is not an external agent transcript.
| Argument | Type | Description |
|---|---|---|
| analysis_id* | string |
{
"type": "object",
"title": "get_analysisArguments",
"required": [
"analysis_id"
],
"properties": {
"analysis_id": {
"type": "string",
"title": "Analysis Id",
"format": "uuid"
}
}
}Read private calculation groups and independent operations. Filter by kind, portfolio, dates, ready/running/attention status or legacy open/finished status.
| Argument | Type | Description |
|---|---|---|
| kind | any | |
| page | integer | |
| status | any | |
| date_to | any | |
| date_from | any | |
| page_size | integer | |
| portfolio_id | any |
{
"type": "object",
"title": "list_analysesArguments",
"properties": {
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Kind",
"default": null
},
"page": {
"type": "integer",
"title": "Page",
"default": 1,
"minimum": 1
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Status",
"default": null
},
"date_to": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Date To",
"default": null
},
"date_from": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Date From",
"default": null
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 20,
"maximum": 100,
"minimum": 1
},
"portfolio_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Portfolio Id",
"default": null
}
}
}List owner-scoped portfolios, analytics datasets, and profile readiness.
No arguments.
{
"type": "object",
"title": "list_analysis_portfoliosArguments",
"properties": {}
}Discover owner-scoped immutable series profiles and their exact dataset versions. This returns metadata and coverage only, never dataset rows.
| Argument | Type | Description |
|---|---|---|
| cursor | any | |
| statuses | any | |
| page_size | integer | |
| portfolio_id | any |
{
"type": "object",
"title": "list_portfolio_seriesArguments",
"properties": {
"cursor": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"title": "Cursor",
"default": null
},
"statuses": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"proposed",
"confirmed"
],
"type": "string"
},
"maxItems": 2
},
{
"type": "null"
}
],
"title": "Statuses",
"default": null
},
"page_size": {
"type": "integer",
"title": "Page Size",
"default": 50,
"maximum": 100,
"minimum": 1
},
"portfolio_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Portfolio Id",
"default": null
}
}
}Create an immutable profile revision using revise, or explicitly confirm a warning-free proposal with confirmation=true.
| Argument | Type | Description |
|---|---|---|
| action* | string | |
| revisions | any | |
| profile_id* | string | |
| confirmation | boolean | |
| analysis_name | any | Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key. |
{
"type": "object",
"title": "review_portfolio_series_profileArguments",
"required": [
"profile_id",
"action"
],
"properties": {
"action": {
"enum": [
"revise",
"confirm"
],
"type": "string",
"title": "Action"
},
"revisions": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Revisions",
"default": null
},
"profile_id": {
"type": "string",
"title": "Profile Id",
"format": "uuid"
},
"confirmation": {
"type": "boolean",
"title": "Confirmation",
"default": false
},
"analysis_name": {
"anyOf": [
{
"type": "string",
"maxLength": 255,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Analysis Name",
"default": null,
"description": "Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key."
}
}
}Upload normalized series_key/date/value/distribution rows and commit a dataset version. For up to 5,000 rows, omit chunk_index and total_chunks to complete in one call. For larger inputs, declare total_chunks on every call, send chunks in order, and reuse upload_id and idempotency_key. The final chunk automatically verifies and commits all data and returns immutable series profiles. Parse files locally before calling.
| Argument | Type | Description |
|---|---|---|
| rows* | array | |
| source | any | |
| upload_id | any | |
| dataset_id | any | |
| chunk_index | integer | Zero-based chunk position; upload chunks in order. |
| content_hash | string | |
| dataset_name | string | |
| portfolio_id | any | |
| total_chunks | integer | Total number of chunks in this upload. The last accepted chunk commits the dataset automatically. |
| end_date | any |
| start_date | any |
| analysis_name | any | Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key. |
| risk_free_rate | any | Required for sharpe and alpha. Use a confirmed risk-free rate profile or a source-backed dated annualized scalar with currency, tenor, compounding and provenance. Do not substitute an assumed rate. |
| idempotency_key* | string |
| target_frequency* | string | Calculate complete daily, weekly or monthly return periods. Annualization uses 252, 52 or 12 periods per year respectively; finer-frequency data must be available. |
| series_profile_id* | string | Confirmed portfolio series profile returned by upload or list_portfolio_series; pins one immutable dataset version. |
| benchmark_profile_id | any | Confirmed benchmark series profile in the same currency and return basis as the portfolio. Required for beta, alpha, correlation, tracking_error and information_ratio. Returns are matched by exact period dates. |
| minimum_acceptable_return | any | Required for downside_deviation and sortino. Use a confirmed minimum acceptable return profile or a source-backed dated annualized scalar with currency, tenor, compounding and provenance. |
{
"type": "object",
"$defs": {
"ScalarRateInput": {
"type": "object",
"title": "ScalarRateInput",
"required": [
"type",
"value",
"currency",
"value_date",
"tenor",
"compounding",
"provenance"
],
"properties": {
"type": {
"type": "string",
"const": "scalar",
"title": "Type"
},
"tenor": {
"type": "string",
"title": "Tenor",
"maxLength": 64,
"minLength": 1
},
"value": {
"type": "string",
"title": "Value"
},
"currency": {
"type": "string",
"title": "Currency",
"maxLength": 3,
"minLength": 3
},
"quotation": {
"type": "string",
"const": "annualized",
"title": "Quotation",
"default": "annualized"
},
"provenance": {
"type": "object",
"title": "Provenance",
"additionalProperties": true
},
"value_date": {
"type": "string",
"title": "Value Date",
"format": "date"
},
"compounding": {
"enum": [
"simple",
"annual",
"continuous"
],
"type": "string",
"title": "Compounding"
}
},
"additionalProperties": false
},
"ExactRateSeriesInput": {
"type": "object",
"title": "ExactRateSeriesInput",
"required": [
"type",
"series_profile_id"
],
"properties": {
"type": {
"type": "string",
"const": "series_profile",
"title": "Type"
},
"series_profile_id": {
"type": "string",
"title": "Series Profile Id",
"format": "uuid"
}
},
"additionalProperties": false
}
},
"title": "calculate_portfolio_statisticsArguments",
"required": [
"series_profile_id",
"metrics",
"target_frequency",
"idempotency_key"
],
"properties": {
"metrics": {
"type": "array",
"items": {
"enum": [
"periodic_returns",
"cumulative_return",
"observation_count",
"period_count",
"min_return",
"max_return",
"volatility",
"drawdown",
"max_drawdown",
"downside_deviation",
"sharpe",
"sortino",
"beta",
"alpha",
"correlation",
"tracking_error",
"information_ratio"
],
"type": "string"
},
"title": "Metrics",
"maxItems": 17,
"minItems": 1,
"description": "Select one or more unique metric names. periodic_returns: Return for each complete period at target_frequency. cumulative_return: Compounded return across the selected complete periods. observation_count: Number of source observations in the selected date range. period_count: Number of complete return periods available for calculation. min_return: Lowest periodic return and its period end date. max_return: Highest periodic return and its period end date. volatility: Sample standard deviation of periodic returns, with annualized volatility. drawdown: Decline from the running peak of compounded wealth for each period. max_drawdown: Largest peak-to-trough decline, with peak, trough and recovery dates when available. downside_deviation: Root mean square shortfall below minimum_acceptable_return, with annualized deviation. Requires minimum_acceptable_return. sharpe: Mean return above risk_free_rate divided by the sample standard deviation of excess returns, with annualized ratio. Requires risk_free_rate. sortino: Mean return above minimum_acceptable_return divided by downside deviation, with annualized ratio. Requires minimum_acceptable_return. beta: Sensitivity of portfolio returns to benchmark returns. Requires benchmark_profile_id. alpha: Return above the benchmark return implied by beta and risk_free_rate, with annualized alpha. Requires benchmark_profile_id and risk_free_rate. correlation: Pearson correlation between portfolio and benchmark returns. Requires benchmark_profile_id. tracking_error: Sample standard deviation of portfolio-minus-benchmark returns, with annualized tracking error. Requires benchmark_profile_id. information_ratio: Mean portfolio-minus-benchmark return divided by tracking error, with annualized ratio. Requires benchmark_profile_id."
},
"end_date": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "End Date",
"default": null
},
"start_date": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Start Date",
"default": null
},
"analysis_name": {
"anyOf": [
{
"type": "string",
"maxLength": 255,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Analysis Name",
"default": null,
"description": "Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key."
},
"risk_free_rate": {
"anyOf": [
{
"$ref": "#/$defs/ExactRateSeriesInput"
},
{
"$ref": "#/$defs/ScalarRateInput"
},
{
"type": "null"
}
],
"title": "Risk Free Rate",
"default": null,
"description": "Required for sharpe and alpha. Use a confirmed risk-free rate profile or a source-backed dated annualized scalar with currency, tenor, compounding and provenance. Do not substitute an assumed rate."
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"maxLength": 255,
"minLength": 1
},
"target_frequency": {
"enum": [
"daily",
"weekly",
"monthly"
],
"type": "string",
"title": "Target Frequency",
"description": "Calculate complete daily, weekly or monthly return periods. Annualization uses 252, 52 or 12 periods per year respectively; finer-frequency data must be available."
},
"series_profile_id": {
"type": "string",
"title": "Series Profile Id",
"format": "uuid",
"description": "Confirmed portfolio series profile returned by upload or list_portfolio_series; pins one immutable dataset version."
},
"benchmark_profile_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Benchmark Profile Id",
"default": null,
"description": "Confirmed benchmark series profile in the same currency and return basis as the portfolio. Required for beta, alpha, correlation, tracking_error and information_ratio. Returns are matched by exact period dates."
},
"minimum_acceptable_return": {
"anyOf": [
{
"$ref": "#/$defs/ExactRateSeriesInput"
},
{
"$ref": "#/$defs/ScalarRateInput"
},
{
"type": "null"
}
],
"title": "Minimum Acceptable Return",
"default": null,
"description": "Required for downside_deviation and sortino. Use a confirmed minimum acceptable return profile or a source-backed dated annualized scalar with currency, tenor, compounding and provenance."
}
}
}| analysis_name |
| any |
| Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key. |
| idempotency_key* | string |
| series_profiles | any | Source-backed semantics for each series_key. Supply on the first or final chunk; the final chunk can complete the proposals before commit. Ambiguous or incomplete profiles require review before calculation. |
| new_portfolio_name | string |
{
"type": "object",
"$defs": {
"CanonicalSeriesRow": {
"type": "object",
"title": "CanonicalSeriesRow",
"required": [
"series_key",
"date",
"value"
],
"properties": {
"date": {
"type": "string",
"title": "Date",
"format": "date"
},
"value": {
"type": "string",
"title": "Value"
},
"series_key": {
"type": "string",
"title": "Series Key",
"maxLength": 255,
"minLength": 1
},
"distribution": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Distribution",
"default": null
}
},
"additionalProperties": false
}
},
"title": "upload_portfolio_series_rowsArguments",
"required": [
"idempotency_key",
"rows"
],
"properties": {
"rows": {
"type": "array",
"items": {
"$ref": "#/$defs/CanonicalSeriesRow"
},
"title": "Rows",
"maxItems": 5000,
"minItems": 1
},
"source": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Source",
"default": null
},
"upload_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Upload Id",
"default": null
},
"dataset_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Dataset Id",
"default": null
},
"chunk_index": {
"type": "integer",
"title": "Chunk Index",
"default": 0,
"minimum": 0,
"description": "Zero-based chunk position; upload chunks in order."
},
"content_hash": {
"type": "string",
"title": "Content Hash",
"default": "",
"maxLength": 64
},
"dataset_name": {
"type": "string",
"title": "Dataset Name",
"default": "",
"maxLength": 255
},
"portfolio_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"title": "Portfolio Id",
"default": null
},
"total_chunks": {
"type": "integer",
"title": "Total Chunks",
"default": 1,
"minimum": 1,
"description": "Total number of chunks in this upload. The last accepted chunk commits the dataset automatically."
},
"analysis_name": {
"anyOf": [
{
"type": "string",
"maxLength": 255,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Analysis Name",
"default": null,
"description": "Optional private grouping name. The same case-sensitive name, after trimming outer whitespace, reuses one group for this user. Omit it for an independent operation. Keep the name on retries; each calculation still needs its own idempotency_key."
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"maxLength": 255,
"minLength": 1
},
"series_profiles": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Series Profiles",
"default": null,
"description": "Source-backed semantics for each series_key. Supply on the first or final chunk; the final chunk can complete the proposals before commit. Ambiguous or incomplete profiles require review before calculation."
},
"new_portfolio_name": {
"type": "string",
"title": "New Portfolio Name",
"default": "",
"maxLength": 255
}
}
}