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. 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