Detalle de Stock

Obtener el historial de precios o cotización extendida de una acción específica.

`GET /stocks/:tick`

Retorna el historial de precios de una acción específica. También permite obtener una cotización extendida con información del perfil de la empresa usando el parámetro type=quote.

Autenticación

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

Request

Historial de precios:

curl -X GET https://api.qvapay.com/stocks/AAPL?timeframe=24H

Cotización extendida:

curl -X GET https://api.qvapay.com/stocks/AAPL?type=quote

Parámetros de URL

Parámetro	Tipo	Requerido	Descripción
`tick`	string	Sí	Símbolo bursátil de la acción (ej: `AAPL`, `TSLA`)

Parámetros de Query

Parámetro	Tipo	Requerido	Descripción
`type`	string	No	Usar `quote` para obtener cotización extendida con perfil de empresa
`timeframe`	string	No	Intervalo de tiempo para el historial. Por defecto: `24H`

Timeframes válidos

Valor	Descripción	Intervalo	Caché
`1H`	Última hora	1 minuto	2 min
`24H`	Últimas 24 horas	15 minutos	5 min
`1W`	Última semana	1 hora	15 min
`1M`	Último mes	1 día	1 hora
`1Y`	Último año	1 día	2 horas

Response (historial de precios)

[
  {
    "time": 1710600000,
    "value": 172.35
  },
  {
    "time": 1710600900,
    "value": 172.80
  },
  {
    "time": 1710601800,
    "value": 173.12
  }
]

Response (cotización extendida, `type=quote`)

{
  "symbol": "AAPL",
  "name": "Apple Inc",
  "price": 178.52,
  "change": 1.25,
  "changeDollar": 2.21,
  "open": 176.50,
  "high": 179.10,
  "low": 175.80,
  "previousClose": 176.31,
  "volume": 54320100,
  "fiftyTwoWeekHigh": 199.62,
  "fiftyTwoWeekLow": 124.17,
  "exchange": "NASDAQ",
  "type": "Common Stock",
  "description": "Apple Inc. designs, manufactures...",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "ceo": "Tim Cook"
}

Acciones válidas

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

Errores

Código	Descripción
`400`	Símbolo de acción o timeframe inválido
`404`	Historial de precios o cotización no disponible
`429`	Demasiadas solicitudes
`500`	Error interno del servidor

On this page