Referencia de la API

Visión general

MiniValuator ofrece una API REST que te permite obtener los fundamentales de las acciones mediante programación. Se aplican las mismas reglas de facturación por créditos: 10 créditos por un símbolo nuevo, reconsultas gratuitas dentro de los 7 días.

URL base: https://minivaluator.com

Autenticación: clave de API mediante la cabecera Authorization: Bearer sk-...

Cómo obtener una clave de API

Inicia sesión en tu cuenta de MiniValuator
Ve a Ajustes → Claves de API
Haz clic en Añadir clave de API, asígnale un nombre y copia la clave generada (sk-...)

Mantén tu clave de API en secreto. Cualquiera que tenga la clave puede consumir tus créditos.

Endpoint

GET /api/stock/fundamentals

Devuelve los datos fundamentales de un símbolo de acción dado.

Solicitud

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

Parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
`symbol`	string	Sí	Símbolo de la acción (p. ej. `AAPL`, `MSFT`, `GOOGL`)

Respuesta

{
  "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"
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
`symbol`	string	Símbolo de la acción en mayúsculas
`name`	string	Nombre de la empresa
`fcfPerShare`	number	Flujo de caja libre por acción (TTM, USD)
`currentPrice`	number	Precio actual de la acción (USD)
`currentPFCF`	number	Múltiplo precio/FCF (TTM)
`eps`	number	Beneficio por acción (TTM, USD)
`currentPE`	number	Ratio precio/beneficio (TTM)
`growthEstimate`	object \| null	Estimación de crecimiento a 5 años basada en los ingresos
`earningsGrowthEstimate`	object \| null	Estimación de crecimiento a 5 años basada en el BPA
`dataSource`	string	Nombre del proveedor de datos

Campos de growthEstimate

Campo	Tipo	Descripción
`rates`	number[]	Cinco tasas de crecimiento interanual (decimales, p. ej. `0.08` = 8%)
`cagr`	number	Tasa de crecimiento anual compuesta de todo el periodo
`quality`	`"ok"` \| `"partial"` \| `"insufficient"`	Nivel de confianza de los datos
`flags`	string[]	Notas sobre valores rellenados o acotados

Respuestas de error

Estado HTTP	Mensaje	Causa
`400`	`"Symbol required"`	Falta el parámetro `symbol`
`400`	`"Invalid symbol format"`	El símbolo contiene caracteres no válidos
`400`	`"Insufficient credits"`	La cuenta tiene menos de 10 créditos
`400`	`"Rate limit exceeded"`	Demasiadas solicitudes desde esta IP
`400`	`"Stock not found"`	El proveedor de datos no reconoce el símbolo

Todos los errores siguen el formato:

{ "error": "Insufficient credits" }

Consumo de créditos

Escenario	Créditos cobrados
Primera consulta de un símbolo nuevo	10 créditos
Reconsulta dentro de los 7 días	Gratis (servida desde la caché)
Reconsulta después de 7 días	10 créditos

Ejemplos de código

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