Référence de l'API

Présentation

MiniValuator fournit une API REST qui vous permet de récupérer les fondamentaux des actions par programmation. Ce sont les mêmes fondamentaux qui alimentent le verdict sur la page Évaluer, exposés pour que vous puissiez les intégrer à vos propres outils. Les mêmes règles de facturation en crédits s'appliquent — 10 crédits pour un nouveau symbole, requêtes répétées gratuites dans un délai de 7 jours.

URL de base : https://minivaluator.com

Authentification : clé d'API via l'en-tête Authorization: Bearer sk-...

Obtenir une clé d'API

Connectez-vous à votre compte MiniValuator
Accédez à Paramètres → Clés d'API
Cliquez sur Ajouter une clé d'API, donnez-lui un nom et copiez la clé générée (sk-...)

Gardez votre clé d'API secrète. Toute personne disposant de la clé peut consommer vos crédits.

Point de terminaison

GET /api/stock/fundamentals

Renvoie les données fondamentales d'un symbole boursier donné.

Requête

curl "https://minivaluator.com/api/stock/fundamentals?symbol=AAPL" \
  -H "Authorization: Bearer sk-your-api-key-here"

Paramètres de requête

Paramètre	Type	Obligatoire	Description
`symbol`	string	Oui	Symbole boursier (par ex. `AAPL`, `MSFT`, `GOOGL`)

Réponse

{
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "fcfPerShare": 7.43,
    "currentPrice": 211.45,
    "currentPFCF": 28,
    "eps": 6.42,
    "currentPE": 33,
    "growthEstimate": {
      "rates": [0.062, 0.091, 0.08, 0.08, 0.08],
      "cagr": 0.082,
      "quality": "ok",
      "flags": []
    },
    "earningsGrowthEstimate": {
      "rates": [0.11, 0.13, 0.12, 0.12, 0.12],
      "cagr": 0.12,
      "quality": "ok",
      "flags": []
    },
    "dataSource": "Financial Modeling Prep"
  }
}

Champs de la réponse

Champ	Type	Description
`symbol`	string	Symbole boursier en majuscules
`name`	string	Nom de l'entreprise
`fcfPerShare`	number	Flux de trésorerie disponible par action (TTM, USD)
`currentPrice`	number	Cours actuel de l'action (USD)
`currentPFCF`	number	Multiple cours/FCF (TTM)
`eps`	number	Bénéfice par action (TTM, USD)
`currentPE`	number	Ratio cours/bénéfice (TTM)
`growthEstimate`	object \| null	Estimation de croissance sur 5 ans fondée sur le chiffre d'affaires
`earningsGrowthEstimate`	object \| null	Estimation de croissance sur 5 ans fondée sur le BPA
`dataSource`	string	Nom du fournisseur de données

Champs de growthEstimate

Champ	Type	Description
`rates`	number[]	Cinq taux de croissance d'une année sur l'autre (décimaux, par ex. `0.08` = 8 %)
`cagr`	number	Taux de croissance annuel composé sur l'ensemble de la période
`quality`	`"ok"` \| `"partial"` \| `"insufficient"`	Niveau de confiance des données
`flags`	string[]	Remarques sur les valeurs complétées ou bornées

Réponses d'erreur

Statut HTTP	Message	Cause
`400`	`"Symbol required"`	Paramètre `symbol` manquant
`400`	`"Invalid symbol format"`	Le symbole contient des caractères invalides
`400`	`"Insufficient credits"`	Le compte dispose de moins de 10 crédits
`400`	`"Rate limit exceeded"`	Trop de requêtes provenant de cette adresse IP
`400`	`"Stock not found"`	Symbole non reconnu par le fournisseur de données

Toutes les erreurs suivent le format :

{ "error": "Insufficient credits" }

Consommation de crédits

Scénario	Crédits facturés
Première requête pour un nouveau symbole	10 crédits
Requête répétée dans un délai de 7 jours	Gratuite (servie depuis le cache)
Requête répétée après 7 jours	10 crédits

Exemples de code

Python

import requests

API_KEY = "sk-your-api-key-here"

response = requests.get(
    "https://minivaluator.com/api/stock/fundamentals",
    params={"symbol": "AAPL"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
data = response.json()
print(data["data"]["fcfPerShare"])  # 7.43

JavaScript / Node.js

const API_KEY = "sk-your-api-key-here";

const res = await fetch(
  "https://minivaluator.com/api/stock/fundamentals?symbol=AAPL",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const { data } = await res.json();
console.log(data.fcfPerShare); // 7.43