---
title: "Specifica OpenAPI 3.1"
description: "Dove l’Open API di Fincanva pubblica il documento OpenAPI 3.1, che cosa descrive — ogni operazione REST, richiesta, risposta, errore — e lo schema di sicurezza."
canonical_url: "https://fincanva.com/it/sviluppatori/sdk-e-strumenti/specifica-openapi-3-1"
last_updated: "2026-10-03"
md_url: "https://fincanva.com/it/sviluppatori/sdk-e-strumenti/specifica-openapi-3-1.md"
---

# Specifica OpenAPI 3.1

L’Open API pubblica un documento OpenAPI 3.1 che descrive ogni operazione REST che serve, per gli strumenti che ne generano un client o vi provano delle chiamate.

## Dove si trova il documento OpenAPI?

In `https://app.fincanva.com/api/v1/research/openapi.json`. È pubblico: leggerlo non richiede credenziali.

## Che cosa descrive il documento OpenAPI?

- Ogni operazione che l’API REST serve, cioè più di quelle che il Riferimento documenta oggi.
- Per ogni operazione il corpo della richiesta, la risposta di successo con esempi e le risposte di errore.
- La sua versione, in `info.version`: `1.0.0`.
- Un solo schema di sicurezza, `bearer`: una chiave API o un token di accesso OAuth 2.1 con lo scope `fincanva.research`.

## Quale pagina documenta ogni accesso a Fincanva?

La tabella elenca ogni operazione servita dall’Open API e dal server MCP, poi ogni altro indirizzo che un client o un utente con accesso raggiunge dall’esterno: il server MCP, questo documento, l’accesso OAuth e i suoi documenti di discovery, e le rotte delle Impostazioni per chiavi API, app collegate, utilizzo e risultati. Una riga senza pagina riporta «Non ancora documentata».

| Operazione o indirizzo | Accesso | Pagina in inglese | Pagina in italiano |
| --- | --- | --- | --- |
| `list_allocation_methods` | MCP + REST | [List allocation methods](/it/sviluppatori/riferimento/list-allocation-methods) | [Elenca i metodi di allocazione](/it/sviluppatori/riferimento/list-allocation-methods) |
| `list_risk_rule_presets` | MCP + REST | [List risk condition presets](/it/sviluppatori/riferimento/list-risk-rule-presets) | [Elenca i preset delle condizioni di rischio](/it/sviluppatori/riferimento/list-risk-rule-presets) |
| `list_screen_filters` | MCP + REST | [List screener filters](/it/sviluppatori/riferimento/list-screen-filters) | [Elenca i filtri dello screener](/it/sviluppatori/riferimento/list-screen-filters) |
| `describe_screen_filter` | MCP + REST | [Describe a screener filter](/it/sviluppatori/riferimento/describe-screen-filter) | [Descrivi un filtro dello screener](/it/sviluppatori/riferimento/describe-screen-filter) |
| `describe_strategy_model` | MCP + REST | [Describe the strategy model](/it/sviluppatori/riferimento/describe-strategy-model) | [Descrivi il modello di strategia](/it/sviluppatori/riferimento/describe-strategy-model) |
| `list_my_strategies` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `list_my_screeners` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `list_my_live_strategies` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_my_strategy` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_my_screener` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `find_assets` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_result` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `run_pipeline` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_data_coverage` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `create_screener` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `edit_screener` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `replace_screener` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `validate_screener` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `explain_screener` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `list_covariance_estimators` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `create_strategy` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `edit_strategy` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `replace_strategy` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `validate_strategy` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `explain_strategy` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `simulate_strategy` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_simulation_metrics` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_simulation_equity` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_simulation_monthly_returns` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_simulation_allocations` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_simulation_positions` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_simulation_current_state` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_strategies_analytics` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_simulation_correlations` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_rolling_correlation` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_start_date_sensitivity` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_contribution_analysis` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_regime_timeline` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_projection_cone` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_backtest_trust` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `run_stress_test` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_rotation_dates` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_todays_rotations` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `compare_simulations` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `get_research_guide` | MCP + REST | Non ancora documentata | Non ancora documentata |
| `POST /mcp` | MCP | [The Fincanva MCP server](/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva) | [Il server MCP di Fincanva](/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva) |
| `POST /api/v1/research/{operation}` | REST | [The Fincanva Open API](/it/sviluppatori/open-api/l-open-api-di-fincanva) | [L’Open API di Fincanva](/it/sviluppatori/open-api/l-open-api-di-fincanva) |
| `GET /api/v1/research/openapi.json` | REST | [OpenAPI 3.1 specification](/it/sviluppatori/sdk-e-strumenti/specifica-openapi-3-1) | [Specifica OpenAPI 3.1](/it/sviluppatori/sdk-e-strumenti/specifica-openapi-3-1) |
| `GET /.well-known/oauth-protected-resource` | Accesso OAuth | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `GET /.well-known/oauth-authorization-server` | Accesso OAuth | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `GET /.well-known/research-jwks.json` | Accesso OAuth | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `GET /api/auth/oauth2/authorize` | Accesso OAuth | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `POST /api/auth/oauth2/consent` | Accesso OAuth | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `POST /api/auth/oauth2/token` | Accesso OAuth | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `POST /api/auth/oauth2/register` | Accesso OAuth | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `POST /api/auth/oauth2/revoke` | Accesso OAuth | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `GET, POST /api/research/keys` | Impostazioni (con accesso) | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `PATCH, DELETE /api/research/keys/{id}` | Impostazioni (con accesso) | [Authentication and API keys](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) | [Autenticazione e chiavi API](/it/sviluppatori/open-api/autenticazione-e-chiavi-api) |
| `GET /api/research/connections` | Impostazioni (con accesso) | [The Fincanva MCP server](/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva) | [Il server MCP di Fincanva](/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva) |
| `PATCH, DELETE /api/research/connections/{clientId}` | Impostazioni (con accesso) | [The Fincanva MCP server](/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva) | [Il server MCP di Fincanva](/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva) |
| `GET /api/research/connections/consent-context` | Impostazioni (con accesso) | [The Fincanva MCP server](/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva) | [Il server MCP di Fincanva](/it/sviluppatori/server-mcp/il-server-mcp-di-fincanva) |
| `GET /api/research/usage` | Impostazioni (con accesso) | [Plans, quotas and limits](/it/sviluppatori/primi-passi/piani-quote-e-limiti) | [Piani, quote e limiti](/it/sviluppatori/primi-passi/piani-quote-e-limiti) |
| `GET, PATCH /api/research/results/{recipeId}` | Impostazioni (con accesso) | [The result envelope](/it/sviluppatori/concetti/la-struttura-del-risultato) | [La struttura del risultato](/it/sviluppatori/concetti/la-struttura-del-risultato) |
| `POST /api/research/results/{recipeId}/rerun` | Impostazioni (con accesso) | [The result envelope](/it/sviluppatori/concetti/la-struttura-del-risultato) | [La struttura del risultato](/it/sviluppatori/concetti/la-struttura-del-risultato) |
| `GET /api/research/open/{kind}/{id}` | Impostazioni (con accesso) | [The result envelope](/it/sviluppatori/concetti/la-struttura-del-risultato) | [La struttura del risultato](/it/sviluppatori/concetti/la-struttura-del-risultato) |
| `GET /open/{kind}/{id}` | Impostazioni (con accesso) | [The result envelope](/it/sviluppatori/concetti/la-struttura-del-risultato) | [La struttura del risultato](/it/sviluppatori/concetti/la-struttura-del-risultato) |

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)