Developers
AccediInizia a costruire
Non pubblicato — questa pagina è visibile solo in staging e non è sul sito pubblico.
Vedi .mdENIT

Descrivi il modello di strategia

POST/api/v1/research/describe_strategy_model

Descrive il modello di strategia di Fincanva una sezione alla volta — il livello della Combinata, le condizioni di rischio, l’allocazione, le strategie dentro una Combinata, le uscite dalle posizioni, la selezione e le impostazioni di simulazione — elencando ogni campo con il tipo, l’unità, il valore predefinito, i limiti e i valori ammessi, e il limite del tuo piano dove ce n’è uno.

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

Parametri

Quali parametri accetta Descrivi il modello di strategia?

  • sectiontestoFacoltativoPredefinito "overview"

    uno tra overview, combined, risk_conditions, allocation, sub_strategies, position_exits, selection, user_settings

    La sezione da descrivere: overview elenca le sezioni; combined (il livello della Combinata), risk_conditions, allocation, sub_strategies (le sotto-strategie di una Combinata; una Strategia singola porta gli stessi campi in cima), position_exits, selection oppure user_settings (le impostazioni di simulazione).

Risposta

Che cosa restituisce Descrivi il modello di strategia?

  • sectiontesto

    uno tra overview, combined, risk_conditions, allocation, sub_strategies, position_exits, selection, user_settings

    La sezione descritta.

  • titletesto

    almeno 1 caratteri

    Il titolo della sezione, con le parole del prodotto.

  • summarytesto

    almeno 1 caratteri

    Che cosa controlla la sezione, in una o due frasi.

  • fieldselenco

    Ogni campo della sezione, nell’ordine in cui li mostra l’app; vuoto per la panoramica.

    Mostra i 13 campi
    • pathtesto

      Il percorso pubblico del campo in una definizione di strategia, quello che usano la creazione e la modifica di una strategia.

    • nametesto

      almeno 1 caratteri

      Il nome del campo come lo mostra l’app.

    • typetesto

      uno tra number, integer, boolean, enum, string, list, object

      number, integer, boolean, enum, string, list o object.

    • unittesto

      uno tra none, number, count, days, weeks, months, quarters, years, reports, bars, fraction, percent, multiple, sharpe_points, sigma, usd, base_currency, date, native

      L’unità del valore del campo. Convenzione: fraction

    • defaultnumero / vero o falso / testo

      può essere null · unità: l’unità di ciò che descrive

      Il valore usato quando il campo non viene indicato. Convenzione: native_unit

    • enabledByDefaultvero o falso

      può essere null

      Per un campo che si può attivare o disattivare, se è attivo in modo predefinito; null per ogni altro campo.

    • minnumero

      può essere null · unità: l’unità di ciò che descrive

      Il valore più piccolo che il prodotto consente, oppure null. Convenzione: native_unit

    • maxnumero

      può essere null · unità: l’unità di ciò che descrive

      Il valore più grande che il prodotto consente, oppure null. Convenzione: native_unit

    • valueselenco

      può essere null

      I valori che l’app offre per un campo enum, oppure null. Dove l’app blocca una scelta, è elencato solo il valore bloccato: due condizioni di rischio si combinano con or e la cadenza di ribilanciamento è month.

    • stepselenco

      può essere null · unità: l’unità di ciò che descrive

      Gli unici numeri che il campo accetta, in ordine crescente, come gli importi fissi del capitale iniziale; null quando è accettato qualsiasi numero tra min e max. Convenzione: native_unit

    • boundsByoggetto

      può essere null

      Limiti che dipendono da un altro campo, un caso per ogni valore di quel campo, come la soglia di una regola di rischio in base alla metrica che legge; null quando i limiti sono fissi. I valori unit, default, min e max del campo sono quelli del valore predefinito dell’altro campo.

      Mostra i 2 campi
      • ontesto

        Il percorso pubblico del campo il cui valore decide i limiti.

      • caseselenco

        Una voce per ogni valore di quel campo.

        Mostra i 6 campi
        • whentesto

          almeno 1 caratteri

          Il valore del campo decisivo a cui si applica questo caso.

        • unittesto

          uno tra none, number, count, days, weeks, months, quarters, years, reports, bars, fraction, percent, multiple, sharpe_points, sigma, usd, base_currency, date, native

          L’unità del valore del campo in questo caso. Convenzione: fraction

        • defaultnumero / vero o falso / testo

          può essere null · unità: l’unità di ciò che descrive

          Il valore predefinito in questo caso. Convenzione: native_unit

        • minnumero

          può essere null · unità: l’unità di ciò che descrive

          Il valore più piccolo ammesso in questo caso, oppure null. Convenzione: native_unit

        • maxnumero

          può essere null · unità: l’unità di ciò che descrive

          Il valore più grande ammesso in questo caso, oppure null. Convenzione: native_unit

        • stepselenco

          può essere null · unità: l’unità di ciò che descrive

          Gli unici numeri accettati in questo caso, in ordine crescente; null quando è accettato qualsiasi numero tra min e max di questo caso. Convenzione: native_unit

    • valuePlanselenco

      può essere null

      I valori che richiedono un piano più alto di quello del campo stesso, come gli stimatori avanzati della covarianza; null quando ogni valore è incluso con il campo.

      Mostra i 3 campi
      • valuetesto

        almeno 1 caratteri

        Uno dei values del campo.

      • includedInYourPlanvero o falso

        Vale true quando il tuo piano attuale include questo valore.

      • lowestPlantesto

        uno tra free, starter, advanced, ultimate, professional · può essere null

        Il piano più basso che include questo valore, oppure null quando oggi nessun piano lo include.

    • planLimitoggetto

      può essere null

      Il limite del tuo piano sul campo, oppure null quando nessun piano lo limita.

      Mostra i 4 campi
      • includedInYourPlanvero o falso

        Vale true quando il tuo piano ti permette di usare il campo.

      • lowestPlantesto

        uno tra free, starter, advanced, ultimate, professional · può essere null

        Il piano più basso che ti permette di usare il campo, oppure null quando oggi nessun piano te lo permette.

      • yourMinnumero

        può essere null · unità: l’unità di ciò che descrive

        Il minimo del tuo piano per un campo numerico, come il primo anno di partenza che il tuo piano consente, che può essere più alto di min; null quando il tuo piano non ne fissa uno. Convenzione: native_unit

      • yourMaxnumero

        può essere null · unità: l’unità di ciò che descrive

        Il massimo del tuo piano per un campo numerico, che può essere più basso di max; null quando il tuo piano non ne fissa uno. Convenzione: native_unit

  • sectionselenco

    Ogni sezione del modello, da cui muoversi.

    Mostra i 2 campi
    • idtesto

      uno tra overview, combined, risk_conditions, allocation, sub_strategies, position_exits, selection, user_settings

      L’id della sezione, da passare come section.

    • titletesto

      almeno 1 caratteri

      Il titolo della sezione.

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

Errori

Quali codici di errore restituisce Descrivi il modello di strategia?

Descrivi il modello di strategia 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 Descrivi il modello di strategia?

  • Prima di creare o modificare una strategia, per conoscere ogni campo che si può impostare e i limiti del piano dell’utente.
  • L’utente chiede che cosa significa un’impostazione, qual è il suo valore predefinito o fin dove può arrivare.

Com’è fatta una chiamata a Descrivi il modello di strategia?

Le uscite dalle posizioni di una strategia, per un utente il cui piano limita le posizioni

Quanto in basso posso impostare uno stop loss?

Position exits: 5 fields. Max positions is on by default and capped at 10 by your plan; the other four are off until you set them.
Risposta completa · 200
{
  "status": true,
  "data": {
    "result": {
      "section": "position_exits",
      "title": "Position exits",
      "summary": "Rules that close positions inside each strategy: a maximum holding time, a delay before reinvesting, a cap on open positions, a take profit and a stop loss. Each can be switched on or off.",
      "fields": [
        {
          "path": "subStrategies[].positionExits.maxHoldMonths",
          "name": "Max hold months",
          "type": "integer",
          "unit": "months",
          "default": 12,
          "enabledByDefault": false,
          "min": 1,
          "max": 120,
          "values": null,
          "steps": null,
          "boundsBy": null,
          "valuePlans": null,
          "planLimit": null
        },
        {
          "path": "subStrategies[].positionExits.reinvestDelayMonths",
          "name": "Reinvest delay",
          "type": "integer",
          "unit": "months",
          "default": 12,
          "enabledByDefault": false,
          "min": 1,
          "max": 120,
          "values": null,
          "steps": null,
          "boundsBy": null,
          "valuePlans": null,
          "planLimit": null
        },
        {
          "path": "subStrategies[].positionExits.maxPositions",
          "name": "Max positions",
          "type": "integer",
          "unit": "count",
          "default": 10,
          "enabledByDefault": true,
          "min": 1,
          "max": 50,
          "values": null,
          "steps": null,
          "boundsBy": null,
          "valuePlans": null,
          "planLimit": {
            "includedInYourPlan": true,
            "lowestPlan": "free",
            "yourMin": null,
            "yourMax": 10
          }
        },
        {
          "path": "subStrategies[].positionExits.takeProfit",
          "name": "Take profit",
          "type": "number",
          "unit": "fraction",
          "default": 1.5,
          "enabledByDefault": false,
          "min": 0.05,
          "max": 10,
          "values": null,
          "steps": null,
          "boundsBy": null,
          "valuePlans": null,
          "planLimit": null
        },
        {
          "path": "subStrategies[].positionExits.stopLoss",
          "name": "Stop loss",
          "type": "number",
          "unit": "fraction",
          "default": -0.3,
          "enabledByDefault": false,
          "min": -1,
          "max": -0.05,
          "values": null,
          "steps": null,
          "boundsBy": null,
          "valuePlans": null,
          "planLimit": null
        }
      ],
      "sections": [
        {
          "id": "overview",
          "title": "Overview"
        },
        {
          "id": "combined",
          "title": "Combined level"
        },
        {
          "id": "risk_conditions",
          "title": "Risk conditions"
        },
        {
          "id": "allocation",
          "title": "Allocation"
        },
        {
          "id": "sub_strategies",
          "title": "Sub-strategies"
        },
        {
          "id": "position_exits",
          "title": "Position exits"
        },
        {
          "id": "selection",
          "title": "Selection"
        },
        {
          "id": "user_settings",
          "title": "Simulation settings"
        }
      ]
    },
    "summary": "Position exits: 5 fields. Max positions is on by default and capped at 10 by your plan; the other four are off until you set them.",
    "assumed": [],
    "dataVersion": null
  }
}

Dove si sbaglia più spesso con Descrivi il modello di strategia?

  • Take profit e stop loss sono frazioni: 1.5 è +150% e -0.3 è -30%, mentre l’app li mostra come percentuali.
  • Un campo numerico può avere due massimi e due minimi: max e min sono quelli del prodotto, planLimit.yourMax e planLimit.yourMin quelli del tuo piano; vale il più stretto. Un campo con steps accetta solo quei numeri, e un campo con boundsBy prende i limiti del caso che il suo campo decisivo seleziona.
  • Le uscite dalle posizioni si applicano dentro ogni strategia di una Combinata, non alla Combinata nel suo insieme.

Quali piani includono Descrivi il modello di strategia?

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