Correspondance API — routes réelles du backend et leur usage dans l'app
État 2.0 (2026-11-20). Deux clients dans l'app :
Core/Networking/VQuantAPI.swift— les routes de 1.0 (v5.8.0), toujours servies par le backend 6 (ajouts seulement) ; réponses de référence dansCoreTests/Fixtures/.VQuantKit(paquet partagé, à traversVQuant/Next/NextTransport.swift) — les routes/api/v2du backend 6 et le catalogue étendu de/api/quant. Contrat :vquant-next/docs/next/CONTRACT.md. Vérifié contre le backend de test figéM2U64:5058(NextLiveTests, tests d'interface).
Chaque requête porte X-VQ-Client: vquant-ios/2.0.0 (2) : cet en-tête ouvre les 19 moteurs et le statut cancelled
(un en-tête 1.x ne reçoit que les six moteurs de 1.0 — vérifié par theNextHeaderUnlocksTheLabEngines). Aucune route
n'a été inventée. Les sections « 1.0 » ci-dessous restent exactes ; les changements d'usage sont notés.
Backend 6 — ce que 2.0 consomme
Synchronisation (CONTRACT §1)
| Route | Par | Écran |
|---|---|---|
GET /api/v2/sync/changes?since= |
VQSyncEngine.pull |
démarrage, retour au premier plan, tirer pour actualiser, actualisation en arrière-plan |
GET /api/v2/sync/stream (SSE : hello, change, hint) |
VQSyncEngine.start |
état de synchronisation ; les hint rafraîchissent analyses, conversations, calculs |
PUT /api/v2/objects/:kind/:id {data, baseRev} |
VQSyncEngine.flush (file durable) |
toute modification d'un objet ; 409 → fusion |
DELETE /api/v2/objects/:kind/:id?baseRev= |
idem | suppression d'une liste, d'un portefeuille, d'un projet, d'une note, d'un espace |
Objets utilisés : watchlist (Marchés, Accueil, widget), portfolio (main = celui de l'agent), chart
(sym-<SYMBOLE> : tracés), project, note, review (lecture seule, écrit par le serveur), workspace,
preference (default). Non utilisés : …/versions (historique des révisions — pas d'écran).
Modèles et consommation (§2)
| Route | Fonction du paquet | Écran |
|---|---|---|
GET /api/v2/models |
ModelStore.refresh |
sélecteur de modèle (fournisseurs, logos, Auto), Réglages |
GET /api/v2/usage?days=30 |
ModelStore.refreshUsage |
Plus › Consommation et coûts |
événements model_routed, budget, provenance, done.usage du flux |
VQGenerationEvent |
en-tête de l'étude, provenance des données |
Non utilisées : GET /api/v2/models/route (aperçu du routage), GET /api/v2/generations/:id/trace (la chronologie
vient du flux et de l'espace de travail).
Couche de données et terminal (§3)
| Route | Fonction | Écran |
|---|---|---|
GET /api/v2/market/overview |
TerminalStore.refreshOverview |
Accueil (indices), Terminal (sections, courbe des taux, calendrier) |
GET /api/v2/data/quotes?symbols= (≤ 60) |
MarketStore.refreshQuotes |
toutes les cotations (liste, portefeuilles, panneaux) ; repli sur /api/fmp/quote/:symbol |
GET /api/v2/data/bars/:symbol?interval=&from= |
MarketStore.bars |
graphiques, historique de portefeuille ; repli sur /api/fmp/chart/* |
GET /api/v2/data/statements/:symbol?period=&limit= |
TerminalStore.statements |
États financiers (fiche d'actif, panneau) |
GET /api/v2/search?q= |
TerminalStore.search |
recherche universelle (⌘K) |
GET /api/v2/data/health |
TerminalStore.refreshHealth |
Terminal › Fournisseurs de données |
Quant Lab (§4)
| Route | Fonction | Écran |
|---|---|---|
GET /api/quant/tools (19 outils, category, resultSchema, groupes, types date / text / json) |
LabStore.refreshCatalog |
catalogue par catégorie, formulaires |
POST /api/quant/jobs {tool, params, projectId?} |
LabStore.start |
formulaire, calculs rapides, analyse de portefeuille |
GET /api/quant/jobs, GET /api/quant/jobs/:id |
LabStore.refreshJobs, .job |
liste (progression), résultat |
POST /api/quant/jobs/:id/cancel |
LabStore.cancel |
bouton Annuler (moteurs lab/1) |
DELETE /api/quant/jobs/:id |
LabStore.delete |
balayage |
Studio (§5) et recherche autonome (§9)
| Route | Fonction | Écran |
|---|---|---|
GET /api/v2/projects/:id/bundle |
StudioStore.bundle |
projet (titres et états résolus des éléments) |
POST /api/v2/projects/:id/export + GET /api/download/:filename |
StudioStore.export |
export PDF / Markdown / LaTeX / ZIP, Quick Look, partage |
POST /api/v2/reviews |
StudioStore.review |
revue automatisée d'une analyse, d'un calcul, d'une note |
POST /api/chat avec mode: "research", model, budget, projectId |
ResearchStore.start |
composition |
GET /api/v2/research/sessions, GET …/:id |
ResearchHub |
études autonomes, étude conservée |
POST /api/v2/research/sessions |
ResearchHub.createSession |
création de l'espace avant le premier message (dépôt d'un jeu de données) |
POST …/:id/upload (multipart), GET …/:id/inspect?path= |
ResearchHub.upload, .inspect |
jeu de données et sa carte d'inspection |
GET …/:id/file?path= (texte ou octets) |
ResearchHub.textFile, .fileData |
code, journaux, figures, fichiers (copie chiffrée pour le hors-ligne) |
GET /api/v2/research/runs/:id, POST …/cancel |
vues du paquet | exécutions longues |
GET /api/v2/research/approvals?status=pending, POST …/:id |
ResearchHub.refreshApprovals, .answer |
carte d'autorisation, actions de notification |
GET /api/v2/research/sandbox |
ResearchHub.refreshSandbox |
limite de dépôt, état du bac à sable |
Événements de flux ajoutés par le backend 6 et lus par le réducteur partagé : research_workspace, dataset,
research_file, code_execution, package_install, research_run, experiment, research_note, figure_lint,
approval_request, approval_resolved, quality_gate.
Non utilisées en 2.0 : POST /api/v2/projects/:id/run (la composition passe par /api/chat avec projectId, même
effet), mémoire v2 (/api/v2/memory* — l'écran Agent garde les routes 1.0), GET /api/v2/audit.
Routes de 1.0 (toujours utilisées, sauf mention)
Source : vquant.git v5.8.0 (server/native.ts, server/routes.ts, server/routes/*.ts).
Session et appareils
| Route | Fonction | Écran |
|---|---|---|
POST /api/native/login/options, …/login/verify |
PasskeyService.signIn |
Connexion |
POST /api/native/register/options, …/register/verify |
PasskeyService.enrol |
Connexion › lien d'invitation |
POST /api/native/reauth/options, …/reauth/verify |
PasskeyService.reauthenticate |
Avant révocation |
GET /api/native/session |
session() |
Lancement, diagnostic |
POST /api/native/logout |
logout() |
Réglages › Se déconnecter |
GET /api/native/devices |
devices() |
Réglages › Appareils |
DELETE /api/native/devices/:id |
revokeDevice |
idem |
DELETE /api/native/passkeys/:ref |
revokePasskey |
idem |
GET /api/me |
me() |
tests |
GET /api/health |
health() |
Diagnostic |
Données de marché (proxy FMP)
| Route | Fonction | Écran |
|---|---|---|
GET /api/fmp/indices |
indices() |
Accueil, Marchés, widgets |
GET /api/fmp/quote/:symbol |
quote() |
repli quand /api/v2/data/quotes échoue |
GET /api/fmp/gainers · losers · actives |
movers() |
Marchés |
GET /api/fmp/market-hours |
marketHours() |
Marchés, calcul de la fraîcheur |
GET /api/fmp/search?q=&limit= |
search() |
Recherche de symbole |
GET /api/fmp/chart/full/:symbol?from=&to= |
bars() (quotidien) |
Graphique 3M → Max |
GET /api/fmp/chart/intraday/:symbol?interval=&from=&to= |
bars() (5 min, 15 min, 1 h) |
Graphique 1J, 5J, 1M |
GET /api/fmp/company-profile/:symbol |
profile() |
Fiche › Société |
GET /api/fmp/financial-news/:symbol |
news() |
Fiche › Actualités |
GET /api/fmp/{income-statement, balance-sheet, cash-flow, key-metrics, financial-ratios, analyst-estimates, earnings-surprises, dividend-history, institutional-holders, insider-trading, upgrades-downgrades, price-target-summary}/:symbol |
fundamentals() |
Fiche › Fondamentaux (tableau générique : tous les champs renvoyés, aucun inventé) |
Non utilisées : stock-quote (doublon de quote), historical-price et chart/light (couvertes par chart/full),
intraday (couverte par chart/intraday), price-target, esg-score.
Analyses (tâches serveur)
| Route | Fonction | Écran |
|---|---|---|
POST /api/chat {query, history, sessionId?, mode, imageData?, imageMimeType?} → SSE |
startAnalysis |
Composition |
GET /api/generations |
generations() |
Recherche, Accueil, widget, Raccourci |
GET /api/generations/:id/stream?from=N → SSE |
streamGeneration |
Suivi en direct, reprise |
POST /api/generations/:id/cancel |
cancelGeneration |
Bouton Arrêter |
Événements SSE décodés (AnalysisEvent) : job, status, text, thinking, plan, tool_start,
tool_complete, tool_error, tool_result, python_code, custom_python_figures, agent_start, agent_tool,
agent_done, sources, followups, error, done. tools et workspace sont ignorés sciemment ; tout autre type
est conservé et signalé dans l'écran de suivi. Le champ model n'est pas envoyé : le serveur applique son modèle par
défaut (la liste des modèles n'est exposée par aucune route en production).
Limites appliquées par le serveur et restituées telles quelles : 4 analyses simultanées par personne (429), une par conversation (409), rejeu 20 minutes après la fin, liste 24 heures. Un redémarrage du serveur interrompt les analyses en cours.
Conversations et rapports
| Route | Fonction | Écran |
|---|---|---|
GET /api/sessions[?q=] |
conversations() |
Recherche › Historique |
GET /api/sessions/:id |
conversation() |
Conversation |
PATCH /api/sessions/:id {title} / {pinned} |
renameConversation, pinConversation |
balayage |
DELETE /api/sessions/:id |
deleteConversation |
balayage + confirmation |
GET /api/shared-reports, GET /api/share/:shareId |
sharedReports, sharedReport |
Bibliothèque |
POST /api/generate-pdf {question, answer} |
pdf() |
Conversation › PDF |
GET /figures/…, /plots/… |
file() |
Figures des rapports |
Non utilisées : POST /api/share, POST /api/generate-docx, POST /api/convert-to-slides,
POST /api/speech-to-text, GET /api/download/:filename, /api/admin/*, /api/analytics/*.
Calculs quantitatifs (moteurs Python du serveur)
| Route | Fonction | Écran |
|---|---|---|
GET /api/quant/tools |
quantTools() |
Calculs, formulaire |
POST /api/quant/jobs {tool, params} → 202 |
startQuantJob |
Formulaire |
GET /api/quant/jobs |
quantJobs() |
Calculs, Accueil, Raccourci |
GET /api/quant/jobs/:id |
quantJob() |
Résultat (paramètres, code, résultat) |
DELETE /api/quant/jobs/:id |
deleteQuantJob |
balayage |
Moteurs au 2026-11-18 : garch, var, monte_carlo, options, portfolio_optimization, risk_metrics. Il n'existe
pas de route d'annulation ; au plus 3 calculs simultanés par personne. Le formulaire est construit depuis params
(type, défaut, bornes, choix) ; le serveur revalide et renvoie les paramètres effectivement appliqués.
Espace de travail
| Route | Fonction | Écran |
|---|---|---|
GET /api/workspace |
workspace() |
Portefeuille, Agent, Accueil |
PUT /api/workspace/portfolio/:symbol {quantity, costBasis?, note?} |
upsertPosition |
Portefeuille |
DELETE /api/workspace/portfolio/:symbol |
removePosition |
Portefeuille |
POST /api/workspace/memories, DELETE …/:id |
addMemory, deleteMemory |
Agent › Mémoire |
POST /api/workspace/watches, PATCH …/:id, DELETE …/:id, POST …/:id/run |
createWatch, updateWatch, deleteWatch, runWatch |
Agent › Veilles |
2.0 : PUT / DELETE /api/workspace/portfolio/:symbol ne sont plus appelées (les positions sont écrites dans l'objet
portfolio), GET /api/workspace sert encore la mémoire et les veilles.
Ce qui n'existe pas côté serveur
Flux WebSocket de cotations, ordres ou courtage, push APNs (toutes les notifications sont locales), sessions web par appareil.