Listar Stocks

`GET /stocks`

Retorna las cotizaciones actuales de todas las acciones disponibles en la plataforma. Este endpoint es público y no requiere autenticación.

Autenticación

No requiere autenticación (endpoint público).

Request

curl -X GET https://api.qvapay.com/stocks

Response

[
  {
    "symbol": "AAPL",
    "name": "Apple",
    "icon": "apple",
    "iconStyle": "brand",
    "image": "https://www.qvapay.com/img/stocks/AAPL.svg",
    "price": 178.52,
    "change": 1.25,
    "changeDollar": 2.21,
    "volume": 54320100,
    "timestamp": "2025-03-17 15:30:00"
  },
  {
    "symbol": "GOOGL",
    "name": "Alphabet",
    "icon": "google",
    "iconStyle": "brand",
    "image": "https://www.qvapay.com/img/stocks/GOOGL.svg",
    "price": 141.80,
    "change": -0.45,
    "changeDollar": -0.64,
    "volume": 21540300,
    "timestamp": "2025-03-17 15:30:00"
  }
]

Campos de respuesta

Campo	Tipo	Descripción
`symbol`	string	Símbolo bursátil (ticker)
`name`	string	Nombre de la empresa
`icon`	string	Nombre del icono
`iconStyle`	string	Estilo del icono (`brand` o `solid`)
`image`	string	URL del logo SVG de la acción
`price`	number	Precio actual de cierre
`change`	number	Cambio porcentual respecto al cierre anterior
`changeDollar`	number	Cambio en dólares respecto al cierre anterior
`volume`	number	Volumen de operaciones
`timestamp`	string	Fecha y hora de la cotización

Acciones disponibles

AAPL, GOOGL, MSFT, AMZN, TSLA, META, NVDA

Errores

Código	Descripción
`429`	Demasiadas solicitudes
`500`	Error interno del servidor
`502`	No se pudieron obtener las cotizaciones de los proveedores externos

Notas

Las cotizaciones se almacenan en caché durante 5 minutos.
El header X-Cache indica si la respuesta proviene del caché (HIT) o fue consultada en tiempo real (MISS).

On this page