--- title: "Elenca i preset delle condizioni di rischio" description: "Elenca i preset delle condizioni di rischio restituisce le condizioni pronte — VIX, curva dei rendimenti, TIPS, S&P 500 — con soglie e ciò che ciascuna rileva." canonical_url: "https://fincanva.com/it/sviluppatori/riferimento/list-risk-rule-presets" last_updated: "2026-10-01" md_url: "https://fincanva.com/it/sviluppatori/riferimento/list-risk-rule-presets.md" --- # Elenca i preset delle condizioni di rischio Elenca le condizioni di rischio pronte che una [strategia](/it/glossario/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. Su richiesta elenca anche i tipi di regola che una [condizione di rischio](/it/glossario/condizione-di-rischio) personalizzata può usare. Id dell’operazione: `list_risk_rule_presets` — REST `POST /api/v1/research/list_risk_rule_presets`, strumento MCP `list_risk_rule_presets`. ## 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. Usa un’altra operazione quando: - Ti servono i limiti di ogni campo di una condizione di rischio per scriverne una personalizzata — usa invece [`describe_strategy_model`](/it/sviluppatori/riferimento/describe-strategy-model). ## 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. ## Che cosa restituisce Elenca i preset delle condizioni di rischio? L’oggetto `result` contiene i campi qui sotto. Ogni risultato riporta anche un `summary` testuale, i valori `assumed` e la `dataVersion`, come descrive [la struttura del risultato](/it/sviluppatori/concetti/la-struttura-del-risultato). - `presets` (elenco) — I preset corrispondenti, nell’ordine in cui li elenca l’app. - `presets[].id` (testo) — L’id pubblico e stabile del preset, in snake_case. - `presets[].name` (testo; almeno 1 caratteri) — Il nome del preset come lo mostra l’app. - `presets[].group` (testo; uno tra `volatility`, `yield_curve`, `inflation`, `sp500`) — Il gruppo del preset: `volatility`, `yield_curve`, `inflation` o `sp500`. - `presets[].description` (testo; almeno 1 caratteri) — La descrizione dell’app: che cosa osserva il preset e quando passa a risk-off. - `presets[].ruleType` (testo; 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. - `presets[].indicator` (oggetto) — L’indicatore applicato alla serie prima del confronto. - `presets[].indicator.kind` (testo; uno tra `none`, `sma`, `change`, `average_momentum`) — `none` (la serie così com’è), `sma` (una [media mobile](/it/glossario/media-mobile-semplice-sma) semplice), `change` (la variazione su un numero di mesi) o `average_momentum`. - `presets[].indicator.value` (numero; 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`](/it/sviluppatori/concetti/unita-e-convenzioni#che-cosa-significa-lunità-native)) - `presets[].riskOff` (oggetto; può essere null) — Quando la condizione passa a risk-off, oppure null per una regola di incrocio. - `presets[].riskOff.operator` (testo; uno tra `above`, `below`) — `above` o `below`: il regime vale finché la serie è sopra o sotto la soglia. - `presets[].riskOff.value` (numero; unità: l’unità di ciò che descrive) — La soglia di risk-off, nell’unità della serie che il preset legge. (convenzione [`native_unit`](/it/sviluppatori/concetti/unita-e-convenzioni#che-cosa-significa-lunità-native)) - `presets[].riskOn` (oggetto; può essere null) — Quando la condizione torna a risk-on, oppure null per una regola di incrocio. - `presets[].riskOn.operator` (testo; uno tra `above`, `below`) — `above` o `below`: il regime vale finché la serie è sopra o sotto la soglia. - `presets[].riskOn.value` (numero; unità: l’unità di ciò che descrive) — La soglia di risk-on, nell’unità della serie che il preset legge. (convenzione [`native_unit`](/it/sviluppatori/concetti/unita-e-convenzioni#che-cosa-significa-lunità-native)) - `presets[].crossing` (oggetto; può essere null) — Per un preset `double_series`, il confronto con la seconda serie; null negli altri casi. - `presets[].crossing.operator` (testo; uno tra `above`, `below`) — `above` o `below`: il regime vale finché la serie è sopra o sotto l’indicatore di confronto. - `presets[].crossing.against` (oggetto) — L’indicatore con cui la serie viene confrontata. - `presets[].crossing.against.kind` (testo; uno tra `none`, `sma`, `change`, `average_momentum`) — Il tipo dell’indicatore di confronto, come in `indicator.kind`. - `presets[].crossing.against.value` (numero; può essere null; unità: l’unità di ciò che descrive) — La finestra dell’indicatore di confronto, come in `indicator.value`. (convenzione [`native_unit`](/it/sviluppatori/concetti/unita-e-convenzioni#che-cosa-significa-lunità-native)) - `presets[].weeksOfDelay` (intero; almeno `0`; unità: settimane) — Quante settimane la condizione attende prima di agire su un cambio di stato. - `presets[].switchRebalances` (vero o falso) — Vale true quando un cambio di stato fa ribilanciare subito. - `presets[].editable` (elenco) — I valori che puoi modificare mantenendo il preset: `riskOffOperator`, `riskOffValue`, `riskOnOperator`, `riskOnValue`, `indicatorValue`. - `ruleTypes` (elenco; può essere null) — I tipi di regola che una condizione di rischio personalizzata può usare, oppure null se `includeRuleTypes` non valeva true. - `ruleTypes[].id` (testo; uno tra `single_series`, `double_series`, `hidden_markov`, `clustering`, `strategy_based`) — `single_series`, `double_series`, `hidden_markov`, `clustering` o `strategy_based`. - `ruleTypes[].name` (testo; almeno 1 caratteri) — Il nome del tipo di regola come lo mostra l’app. - `ruleTypes[].detects` (testo; almeno 1 caratteri) — Che cosa rileva il tipo di regola, in una frase. ## 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à](/it/glossario/volatilita) offre Fincanva? ```bash # Chiamante con il piano advanced 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"}' ``` La risposta: ```json { "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 } } ``` 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 ## 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 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. Ogni operazione può restituire anche i codici di errore comuni elencati in [Errori](/it/sviluppatori/open-api/gli-errori-dell-open-api-di-fincanva#quali-codici-di-errore-può-restituire-unoperazione-di-fincanva). ## 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](/it/sviluppatori/primi-passi/piani-quote-e-limiti). 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](https://fincanva.com/it/terms/addendum#section-3)