Non pubblicato — questa pagina è visibile solo in staging e non è sul sito pubblico.

Elenca i preset delle condizioni di rischio

Q: Quali parametri accetta Elenca i preset delle condizioni di rischio?

group (facoltativo; testo; uno tra volatility, yield_curve, inflation, sp500) — Solo i preset di questo gruppo: volatility, yield_curve, inflation o sp500. Se manca, sono elencati tutti. includeRuleTypes (facoltativo; vero o falso; predefinito false) — Se vale true, il risultato elenca anche i tipi di regola che una condizione di rischio personalizzata può usare.

Q: Com’è fatta una chiamata a Elenca i preset delle condizioni di rischio?

I preset che osservano la volatilità Domanda: Quali segnali di risk-off basati sulla volatilità offre Fincanva? La risposta: Il riepilogo restituito: 2 risk condition presets in the volatility group: VIX ratio and VIX. I valori assunti perché la richiesta non li indicava: /includeRuleTypes = false — the rule types were not asked for, so they are not listed

Q: Quali piani includono Elenca i preset delle condizioni di rischio?

Elenca i preset delle condizioni di rischio appartiene alla famiglia di operazioni «Creazione delle strategie» e conta come una chiamata di ricerca nella quota mensile del tuo piano. Quali piani includono il server MCP e l’Open API, e quanto sono ampie le loro quote, lo trovi in Piani, quote e limiti.

POST/api/v1/research/list_risk_rule_presets

Elenca le condizioni di rischio pronte che una strategia può attivare — il VIX, il rapporto VIX, i TIPS, le regole sulla curva dei rendimenti, l’S&P 500 rispetto alla sua media a 200 giorni e il suo momentum a 12 mesi — ciascuna con la regola che applica: l’indicatore, le soglie di risk-off e di risk-on, le settimane di ritardo e i valori che puoi modificare.

Autenticazione: REST: una chiave API o un token di accesso OAuth. MCP: un token di accesso OAuth.
Strumento MCP: list_risk_rule_presets
Costo: una chiamata di ricerca

Parametri

Quali parametri accetta Elenca i preset delle condizioni di rischio?

grouptestoFacoltativo
uno tra volatility, yield_curve, inflation, sp500
Solo i preset di questo gruppo: volatility, yield_curve, inflation o sp500. Se manca, sono elencati tutti.
includeRuleTypesvero o falsoFacoltativoPredefinito false
Se vale true, il risultato elenca anche i tipi di regola che una condizione di rischio personalizzata può usare.

Mostra il codice

Richiesta

curl -X POST https://app.fincanva.com/api/v1/research/\
list_risk_rule_presets \
  -H "Authorization: Bearer $FINCANVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"volatility"}'

import os

import requests

response = requests.post(
    "https://app.fincanva.com/api/v1/research/list_risk_rule_presets",
    headers={"Authorization": f"Bearer {os.environ['FINCANVA_API_KEY']}"},
    json={
        "group": "volatility",
    },
)
body = response.json()

const response = await fetch("https://app.fincanva.com/api/v1/research/list_risk_rule_presets", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.FINCANVA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "group": "volatility"
  }),
});
const body = await response.json();

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_risk_rule_presets",
    "arguments": {
      "group": "volatility"
    }
  }
}

Risposta

{
  "status": true,
  "data": {
    "result": {
      "presets": [
        {
          "id": "vix_ratio",
          "name": "VIX ratio",
          "group": "volatility",
          …
        },
        …
      ],
      "ruleTypes": null
    },
    "summary": "2 risk condition presets in the vol…",
    "assumed": [ … ],
    "dataVersion": null
  }
}

{
  "type": "object",
  "properties": {
    "presets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "group": {
            "type": "string",
            "enum": [
              "volatility",
              "yield_curve",
              "inflation",
              "sp500"
            ]
          },
          "description": {
            "type": "string",
            "minLength": 1
          },
          "ruleType": {
            "type": "string",
            "enum": [
              "single_series",
              "double_series"
            ]
          },
          "indicator": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "none",
                  "sma",
                  "change",
                  "average_momentum"
                ]
              },
              "value": {
                "type": [
                  "number",
                  "null"
                ]
              }
            },
            "required": [
              "kind",
              "value"
            ],
            "additionalProperties": false
          },
          "riskOff": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "operator": {
                    "type": "string",
                    "enum": [
                      "above",
                      "below"
                    ]
                  },
                  "value": {
                    "type": "number"
                  }
                },
                "required": [
                  "operator",
                  "value"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "riskOn": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "operator": {
                    "type": "string",
                    "enum": [
                      "above",
                      "below"
                    ]
                  },
                  "value": {
                    "type": "number"
                  }
                },
                "required": [
                  "operator",
                  "value"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "crossing": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "operator": {
                    "type": "string",
                    "enum": [
                      "above",
                      "below"
                    ]
                  },
                  "against": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "none",
                          "sma",
                          "change",
                          "average_momentum"
                        ]
                      },
                      "value": {
                        "type": [
                          "number",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "kind",
                      "value"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "operator",
                  "against"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "weeksOfDelay": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "switchRebalances": {
            "type": "boolean"
          },
          "editable": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "riskOffOperator",
                "riskOffValue",
                "riskOnOperator",
                "riskOnValue",
                "indicatorValue"
              ]
            }
          }
        },
        "required": [
          "id",
          "name",
          "group",
          "description",
          "ruleType",
          "indicator",
          "riskOff",
          "riskOn",
          "crossing",
          "weeksOfDelay",
          "switchRebalances",
          "editable"
        ],
        "additionalProperties": false
      }
    },
    "ruleTypes": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "enum": [
                  "single_series",
                  "double_series",
                  "hidden_markov",
                  "clustering",
                  "strategy_based"
                ]
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "detects": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "id",
              "name",
              "detects"
            ],
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "presets",
    "ruleTypes"
  ],
  "additionalProperties": false
}

Risposta

unauthorized

{
  "type": "object",
  "required": [
    "status",
    "message",
    "code"
  ],
  "properties": {
    "status": {
      "const": false
    },
    "message": {
      "type": "string",
      "description": "Written for an AI or a developer to act on."
    },
    "code": {
      "type": "string",
      "enum": [
        "unauthorized"
      ]
    },
    "details": {
      "description": "What the code needs to be acted on, such as the fields of an invalid input."
    }
  }
}

Risposta

plan_limit

{
  "type": "object",
  "required": [
    "status",
    "message",
    "code"
  ],
  "properties": {
    "status": {
      "const": false
    },
    "message": {
      "type": "string",
      "description": "Written for an AI or a developer to act on."
    },
    "code": {
      "type": "string",
      "enum": [
        "plan_limit"
      ]
    },
    "details": {
      "description": "What the code needs to be acted on, such as the fields of an invalid input."
    }
  }
}

Risposta

invalid_input

{
  "type": "object",
  "required": [
    "status",
    "message",
    "code"
  ],
  "properties": {
    "status": {
      "const": false
    },
    "message": {
      "type": "string",
      "description": "Written for an AI or a developer to act on."
    },
    "code": {
      "type": "string",
      "enum": [
        "invalid_input"
      ]
    },
    "details": {
      "description": "What the code needs to be acted on, such as the fields of an invalid input."
    }
  }
}

Risposta

quota_exhausted · rate_limited

{
  "type": "object",
  "required": [
    "status",
    "message",
    "code"
  ],
  "properties": {
    "status": {
      "const": false
    },
    "message": {
      "type": "string",
      "description": "Written for an AI or a developer to act on."
    },
    "code": {
      "type": "string",
      "enum": [
        "quota_exhausted",
        "rate_limited"
      ]
    },
    "details": {
      "description": "What the code needs to be acted on, such as the fields of an invalid input."
    }
  }
}

Risposta completa →

Risposta

Che cosa restituisce Elenca i preset delle condizioni di rischio?

presetselenco
I preset corrispondenti, nell’ordine in cui li elenca l’app.
Mostra i 12 campi
- idtesto
  L’id pubblico e stabile del preset, in snake_case.
- nametesto
  almeno 1 caratteri
  Il nome del preset come lo mostra l’app.
- grouptesto
  uno tra volatility, yield_curve, inflation, sp500
  Il gruppo del preset: volatility, yield_curve, inflation o sp500.
- descriptiontesto
  almeno 1 caratteri
  La descrizione dell’app: che cosa osserva il preset e quando passa a risk-off.
- ruleTypetesto
  uno tra single_series, double_series
  single_series confronta una serie con delle soglie; double_series confronta una serie con un’altra serie o con un proprio indicatore.
- indicatoroggetto
  L’indicatore applicato alla serie prima del confronto.
  Mostra i 2 campi
  kindtesto
  uno tra none, sma, change, average_momentum
  none (la serie così com’è), sma (una media mobile semplice), change (la variazione su un numero di mesi) o average_momentum.
  valuenumero
  può essere null · unità: l’unità di ciò che descrive
  La finestra dell’indicatore: giorni di borsa per sma, mesi per change e average_momentum, null per none. Convenzione: native_unit
- riskOffoggetto
  può essere null
  Quando la condizione passa a risk-off, oppure null per una regola di incrocio.
  Mostra i 2 campi
  operatortesto
  uno tra above, below
  above o below: il regime vale finché la serie è sopra o sotto la soglia.
  valuenumero
  unità: l’unità di ciò che descrive
  La soglia di risk-off, nell’unità della serie che il preset legge. Convenzione: native_unit
- riskOnoggetto
  può essere null
  Quando la condizione torna a risk-on, oppure null per una regola di incrocio.
  Mostra i 2 campi
  operatortesto
  uno tra above, below
  above o below: il regime vale finché la serie è sopra o sotto la soglia.
  valuenumero
  unità: l’unità di ciò che descrive
  La soglia di risk-on, nell’unità della serie che il preset legge. Convenzione: native_unit
- crossingoggetto
  può essere null
  Per un preset double_series, il confronto con la seconda serie; null negli altri casi.
  Mostra i 2 campi
  operatortesto
  uno tra above, below
  above o below: il regime vale finché la serie è sopra o sotto l’indicatore di confronto.
  againstoggetto
  L’indicatore con cui la serie viene confrontata.
  Mostra i 2 campi
  kindtesto
  uno tra none, sma, change, average_momentum
  Il tipo dell’indicatore di confronto, come in indicator.kind.
  valuenumero
  può essere null · unità: l’unità di ciò che descrive
  La finestra dell’indicatore di confronto, come in indicator.value. Convenzione: native_unit
- weeksOfDelayintero
  almeno 0 · unità: settimane
  Quante settimane la condizione attende prima di agire su un cambio di stato.
- switchRebalancesvero o falso
  Vale true quando un cambio di stato fa ribilanciare subito.
- editableelenco
  I valori che puoi modificare mantenendo il preset: riskOffOperator, riskOffValue, riskOnOperator, riskOnValue, indicatorValue.
ruleTypeselenco
può essere null
I tipi di regola che una condizione di rischio personalizzata può usare, oppure null se includeRuleTypes non valeva true.
Mostra i 3 campi
- idtesto
  uno tra single_series, double_series, hidden_markov, clustering, strategy_based
  single_series, double_series, hidden_markov, clustering o strategy_based.
- nametesto
  almeno 1 caratteri
  Il nome del tipo di regola come lo mostra l’app.
- detectstesto
  almeno 1 caratteri
  Che cosa rileva il tipo di regola, in una frase.

Ogni risposta arriva dentro la struttura del risultato comune a tutte le operazioni.

Errori

Quali codici di errore restituisce Elenca i preset delle condizioni di rischio?

Elenca i preset delle condizioni di rischio non ha codici di errore propri oltre a quelli comuni.

Comuni a tutte le operazioni

unauthorized HTTP 401
plan_limit HTTP 403
invalid_input HTTP 422
quota_exhausted HTTP 429
rate_limited HTTP 429

Tutti i codici di errore

Quando si usa Elenca i preset delle condizioni di rischio?

L’utente chiede quali segnali di risk-off offre Fincanva, o come decide uno di essi.
Prima di impostare una condizione di rischio su una strategia, per partire da un preset.

Ti servono i limiti di ogni campo di una condizione di rischio per scriverne una personalizzata — Usa invece describe_strategy_model

Com’è fatta una chiamata a Elenca i preset delle condizioni di rischio?

I preset che osservano la volatilità

Quali segnali di risk-off basati sulla volatilità offre Fincanva?

2 risk condition presets in the volatility group: VIX ratio and VIX.

Risposta completa · 200

{
  "status": true,
  "data": {
    "result": {
      "presets": [
        {
          "id": "vix_ratio",
          "name": "VIX ratio",
          "group": "volatility",
          "description": "Ratio of short-term (VIX) to medium-term (VXV) implied volatility. Risk-Off when the short term exceeds the medium term.",
          "ruleType": "single_series",
          "indicator": {
            "kind": "none",
            "value": null
          },
          "riskOff": {
            "operator": "above",
            "value": 1
          },
          "riskOn": {
            "operator": "below",
            "value": 0.95
          },
          "crossing": null,
          "weeksOfDelay": 0,
          "switchRebalances": false,
          "editable": [
            "riskOffOperator",
            "riskOffValue",
            "riskOnOperator",
            "riskOnValue"
          ]
        },
        {
          "id": "vix",
          "name": "VIX",
          "group": "volatility",
          "description": "CBOE volatility index level. Risk-Off when volatility exceeds the threshold.",
          "ruleType": "single_series",
          "indicator": {
            "kind": "none",
            "value": null
          },
          "riskOff": {
            "operator": "above",
            "value": 25
          },
          "riskOn": {
            "operator": "below",
            "value": 20
          },
          "crossing": null,
          "weeksOfDelay": 0,
          "switchRebalances": false,
          "editable": [
            "riskOffOperator",
            "riskOffValue",
            "riskOnOperator",
            "riskOnValue"
          ]
        }
      ],
      "ruleTypes": null
    },
    "summary": "2 risk condition presets in the volatility group: VIX ratio and VIX.",
    "assumed": [
      {
        "field": "/includeRuleTypes",
        "value": false,
        "reason": "the rule types were not asked for, so they are not listed"
      }
    ],
    "dataVersion": null
  }
}

Dove si sbaglia più spesso con Elenca i preset delle condizioni di rischio?

Le soglie di un preset sono nell’unità della serie che legge — punti indice per il VIX, un rapporto puro per il rapporto VIX — non frazioni.
riskOff e riskOn sono due soglie, non una: lo scarto tra le due impedisce alla condizione di oscillare avanti e indietro attorno a un unico livello.
Solo i valori elencati in editable possono cambiare mantenendo il preset; il resto della regola è fisso.

Quali piani includono Elenca i preset delle condizioni di rischio?

Famiglia: Creazione delle strategie · Costo in quota: una chiamata di ricerca — Disponibilità

Fincanva ha uno scopo solo educativo e illustrativo: non è una consulenza finanziaria personalizzata, e i risultati passati o simulati non indicano quelli futuri. Leggi l'Addendum ai Termini

DOCS · EN — IT