ForHosting KIT · Finanzas y dinero

Calculadora de ROI

Indique lo que invirtió y lo que recuperó: 1000 invertidos y 1200 recuperados son un beneficio neto de 200,00 y un ROI del 20,00 %. Los importes se tratan en céntimos exactos, sin errores de redondeo acumulados. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Importe de la inversión
1000
Importe obtenido
1200
Obtiene
Importe de la inversión
1000.00
Importe obtenido
1200.00
Beneficio neto
200.00
Retorno de la inversión (%)
20.00

Introduzca el capital invertido y el importe total recuperado para obtener el beneficio neto y el porcentaje de ROI, calculados en céntimos enteros exactos con redondeo half-up alejándose de cero a dos decimales.

Qué mide el ROI

El retorno de la inversión compara lo que una inversión devolvió con lo que costó. Reste el capital invertido del importe total recuperado para obtener el beneficio neto, divida ese beneficio entre el capital invertido y multiplique por 100. Invertir 1000 y recuperar 1200 da un beneficio neto de 200,00 y un ROI del 20,00 %. Una cifra positiva indica que el dinero creció, una negativa que se perdió una parte, y no recuperar nada equivale a −100 %. Ver el porcentaje junto al beneficio neto permite filtrar una operación de un vistazo.

Céntimos exactos y redondeo previsible

Los importes se convierten en céntimos enteros antes de cualquier operación, así el dinero nunca arrastra los pequeños errores de las fracciones binarias: 1000 y 1200 pasan a ser 100000 y 120000 céntimos. Después el porcentaje se redondea a dos decimales, la mitad hacia arriba y alejándose de cero, de modo que una pérdida que cae justo en la mitad se redondea alejándose de cero y no hacia él. Así resulta sencillo comprobar, fila por fila, una columna de ROI con dos decimales en su propia hoja de cálculo.

Filtrado de operaciones

Muestre el porcentaje de ROI y el beneficio neto junto a un simple desembolso de capital.

Validación de hojas de cálculo

Compruebe una columna de ROI a dos decimales con half-up contra su propia hoja, del lado del servidor.

¿Se permiten números de coma flotante?

No. Use un entero no negativo o una cadena de dinero con como mucho dos decimales.

¿Cómo se redondea el porcentaje?

Half-up alejándose de cero a dos decimales, calculado por completo en céntimos enteros.

¿Qué pasa si recuperé menos de lo que invertí?

Tanto el beneficio neto como el ROI salen negativos. Si no recupera nada, es decir, un retorno de cero, el ROI es del −100 %, lo que significa que perdió toda la inversión.

¿Puede ser cero el capital invertido?

No. La inversión tiene que ser mayor que cero, porque el ROI se divide entre ella. El importe recuperado, en cambio, sí puede ser cero para representar una pérdida total.

¿Cuántos decimales puedo escribir?

Hasta dos, como en 1200,5 o 1200,50. Se rechazan como formato incorrecto el signo más delante, los ceros de relleno como en 01000, la notación científica y más de un separador decimal.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/dev/roi

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/dev/roi \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"investment":"1000","return_amount":"1200"}'
{
  "investment": "1000",
  "return_amount": "1200"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.roi",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Fórmula y análisis del dinero

dev.roi calcula el retorno de la inversión como (return_amount − investment) ÷ investment × 100, junto con el net_profit que lo impulsa. Para evitar la deriva de la coma flotante binaria en el dinero, ambas entradas se analizan en céntimos enteros con BigInt antes de cualquier operación: el ejemplo 1000 y 1200 se convierten en 100000 y 120000 céntimos, lo que da net_profit 200.00 y roi_percent 20.00. Cada campo acepta o bien un entero seguro no negativo o bien una cadena decimal canónica con como mucho dos dígitos fraccionarios —"1200", "1200.5" y "1200.50" son todas válidas, pero un signo más inicial, ceros de relleno como "01000", notación científica, más de un punto decimal, o un literal float de JavaScript se rechazan todos como formato incorrecto—. investment debe analizarse a más de cero céntimos para que la división esté definida; return_amount puede ser cero, lo que representa una pérdida total y arroja un −100.00 por ciento.

Céntimos enteros y half-up alejándose de cero

Las dos centésimas que quedan se convierten en las dos posiciones decimales de la cadena del porcentaje. roi_percent nunca se calcula en coma flotante. Trabajando por completo en BigInt, el motor forma profit_cents × 10000, luego divide por investment_cents con un paso half-up explícito alejándose de cero —suma la mitad del divisor antes de la división entera y refleja el signo para las pérdidas, de modo que un valor exactamente en −0,5 redondea a −1 en lugar de hacia cero—. Cuando return_amount es inferior a investment, tanto net_profit como roi_percent llevan un signo menos inicial: invierta 1000, recupere 800, y verá net_profit −200.00 con roi_percent −20.00.

Salidas, errores y dónde ejecutarlo

El diseño se mantiene deliberadamente estrecho —la versión uno no anualiza, ni pondera una cartera, ni convierte divisas— para que la superficie firmada sea corta y auditable. Cada respuesta exitosa devuelve cuatro cadenas de dos decimales: investment y return_amount normalizadas a la forma canónica, net_profit con su signo, y roi_percent. Los caminos de error usan mensajes estables y coincidibles, cada uno lanzado como un invalid_input tipado: un investment o return_amount ausente, un investment cero, un valor negativo señalado como negativo antes del nombre del campo, y un dinero mal formado reportado como formato no válido. Las tareas fallidas nunca se facturan contra el saldo prepago.

Pruebas golden de CI

Fije cadenas exactas de net_profit y roi_percent que nunca derivan entre plataformas.

¿Puede ser cero investment?

No. Debe analizarse a más de cero céntimos; de lo contrario obtiene un error tipado invalid_input.

¿Puede ser negativo el ROI?

Sí, cuando return_amount es inferior a investment; tanto net_profit como el porcentaje llevan un signo menos.

¿Es gratis en el navegador?

Sí. La API cuesta $0.002 por llamada, facturada solo en las tareas exitosas.

Ver la documentación completa del KIT →