OpenAPI 3.1 specification
The Open API publishes an OpenAPI 3.1 document describing every REST operation it serves, for the tools that generate a client or test calls from one.
Where is the OpenAPI document?
At https://app.fincanva.com/api/v1/research/openapi.json. It is public: reading it needs no credential.
What does the OpenAPI document describe?
- Every operation the REST API serves, which is more than the Reference documents today.
- Each operation’s request body, its success response with worked examples, and its error responses.
- Its version, in
info.version:1.0.0. - One security scheme,
bearer: an API key or an OAuth 2.1 access token with thefincanva.researchscope.
Which page documents each way into Fincanva?
The table lists every operation the Open API and the MCP server serve, then every other address a client or a signed-in user reaches from outside: the MCP server, this document, OAuth sign-in and its discovery documents, and the Settings routes for API keys, connected apps, usage and results. A row with no page says «Not documented yet».
| Operation or address | Door | English page | Italian page |
|---|---|---|---|
list_allocation_methods | MCP + REST | List allocation methods | Elenca i metodi di allocazione |
list_risk_rule_presets | MCP + REST | List risk condition presets | Elenca i preset delle condizioni di rischio |
list_screen_filters | MCP + REST | List screener filters | Elenca i filtri dello screener |
describe_screen_filter | MCP + REST | Describe a screener filter | Descrivi un filtro dello screener |
describe_strategy_model | MCP + REST | Describe the strategy model | Descrivi il modello di strategia |
list_my_strategies | MCP + REST | Not documented yet | Not documented yet |
list_my_screeners | MCP + REST | Not documented yet | Not documented yet |
list_my_live_strategies | MCP + REST | Not documented yet | Not documented yet |
get_my_strategy | MCP + REST | Not documented yet | Not documented yet |
get_my_screener | MCP + REST | Not documented yet | Not documented yet |
find_assets | MCP + REST | Not documented yet | Not documented yet |
get_result | MCP + REST | Not documented yet | Not documented yet |
run_pipeline | MCP + REST | Not documented yet | Not documented yet |
get_data_coverage | MCP + REST | Not documented yet | Not documented yet |
create_screener | MCP + REST | Not documented yet | Not documented yet |
edit_screener | MCP + REST | Not documented yet | Not documented yet |
replace_screener | MCP + REST | Not documented yet | Not documented yet |
validate_screener | MCP + REST | Not documented yet | Not documented yet |
explain_screener | MCP + REST | Not documented yet | Not documented yet |
list_covariance_estimators | MCP + REST | Not documented yet | Not documented yet |
create_strategy | MCP + REST | Not documented yet | Not documented yet |
edit_strategy | MCP + REST | Not documented yet | Not documented yet |
replace_strategy | MCP + REST | Not documented yet | Not documented yet |
validate_strategy | MCP + REST | Not documented yet | Not documented yet |
explain_strategy | MCP + REST | Not documented yet | Not documented yet |
simulate_strategy | MCP + REST | Not documented yet | Not documented yet |
get_simulation_metrics | MCP + REST | Not documented yet | Not documented yet |
get_simulation_equity | MCP + REST | Not documented yet | Not documented yet |
get_simulation_monthly_returns | MCP + REST | Not documented yet | Not documented yet |
get_simulation_allocations | MCP + REST | Not documented yet | Not documented yet |
get_simulation_positions | MCP + REST | Not documented yet | Not documented yet |
get_simulation_current_state | MCP + REST | Not documented yet | Not documented yet |
get_strategies_analytics | MCP + REST | Not documented yet | Not documented yet |
get_simulation_correlations | MCP + REST | Not documented yet | Not documented yet |
get_rolling_correlation | MCP + REST | Not documented yet | Not documented yet |
get_start_date_sensitivity | MCP + REST | Not documented yet | Not documented yet |
get_contribution_analysis | MCP + REST | Not documented yet | Not documented yet |
get_regime_timeline | MCP + REST | Not documented yet | Not documented yet |
get_projection_cone | MCP + REST | Not documented yet | Not documented yet |
get_backtest_trust | MCP + REST | Not documented yet | Not documented yet |
run_stress_test | MCP + REST | Not documented yet | Not documented yet |
get_rotation_dates | MCP + REST | Not documented yet | Not documented yet |
get_todays_rotations | MCP + REST | Not documented yet | Not documented yet |
compare_simulations | MCP + REST | Not documented yet | Not documented yet |
get_research_guide | MCP + REST | Not documented yet | Not documented yet |
POST /mcp | MCP | The Fincanva MCP server | Il server MCP di Fincanva |
POST /api/v1/research/{operation} | REST | The Fincanva Open API | L’Open API di Fincanva |
GET /api/v1/research/openapi.json | REST | OpenAPI 3.1 specification | Specifica OpenAPI 3.1 |
GET /.well-known/oauth-protected-resource | OAuth sign-in | Authentication and API keys | Autenticazione e chiavi API |
GET /.well-known/oauth-authorization-server | OAuth sign-in | Authentication and API keys | Autenticazione e chiavi API |
GET /.well-known/research-jwks.json | OAuth sign-in | Authentication and API keys | Autenticazione e chiavi API |
GET /api/auth/oauth2/authorize | OAuth sign-in | Authentication and API keys | Autenticazione e chiavi API |
POST /api/auth/oauth2/consent | OAuth sign-in | Authentication and API keys | Autenticazione e chiavi API |
POST /api/auth/oauth2/token | OAuth sign-in | Authentication and API keys | Autenticazione e chiavi API |
POST /api/auth/oauth2/register | OAuth sign-in | Authentication and API keys | Autenticazione e chiavi API |
POST /api/auth/oauth2/revoke | OAuth sign-in | Authentication and API keys | Autenticazione e chiavi API |
GET, POST /api/research/keys | Signed-in settings | Authentication and API keys | Autenticazione e chiavi API |
PATCH, DELETE /api/research/keys/{id} | Signed-in settings | Authentication and API keys | Autenticazione e chiavi API |
GET /api/research/connections | Signed-in settings | The Fincanva MCP server | Il server MCP di Fincanva |
PATCH, DELETE /api/research/connections/{clientId} | Signed-in settings | The Fincanva MCP server | Il server MCP di Fincanva |
GET /api/research/connections/consent-context | Signed-in settings | The Fincanva MCP server | Il server MCP di Fincanva |
GET /api/research/usage | Signed-in settings | Plans, quotas and limits | Piani, quote e limiti |
GET, PATCH /api/research/results/{recipeId} | Signed-in settings | The result envelope | La struttura del risultato |
POST /api/research/results/{recipeId}/rerun | Signed-in settings | The result envelope | La struttura del risultato |
GET /api/research/open/{kind}/{id} | Signed-in settings | The result envelope | La struttura del risultato |
GET /open/{kind}/{id} | Signed-in settings | The result envelope | La struttura del risultato |
UPDATED 2026-10-03REVIEWED 2026-10-03