Comprar Stock

`POST /stocks/:tick/buy`

Compra acciones fraccionadas de una empresa utilizando el saldo disponible en QvaPay. El precio de compra incluye un spread sobre el precio de mercado, que varía según si el mercado está abierto o cerrado.

Autenticación

Bearer Token en el header Authorization.

Authorization: Bearer {tu-token}

Request

curl -X POST https://api.qvapay.com/stocks/AAPL/buy \
  -H "Authorization: Bearer {tu-token}" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50}'

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 del Body

Parámetro	Tipo	Requerido	Descripción
`amount`	number/string	Sí	Monto en USD a invertir. Debe estar entre el mínimo y máximo configurados.

Response

{
  "success": true,
  "data": {
    "trade_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "transaction_uuid": "f0e1d2c3-b4a5-6789-0abc-def123456789",
    "symbol": "AAPL",
    "quantity": 0.279832,
    "effective_price": 178.68,
    "market_price": 178.25,
    "spread_percent": 0.24,
    "fee": 0.25,
    "total_debited": 50.25,
    "after_hours": false
  }
}

Campos de respuesta

Campo	Tipo	Descripción
`trade_uuid`	string	UUID único de la operación
`transaction_uuid`	string	UUID de la transacción asociada
`symbol`	string	Símbolo de la acción comprada
`quantity`	number	Cantidad de acciones adquiridas (fraccionadas)
`effective_price`	number	Precio efectivo de compra (con spread)
`market_price`	number	Precio de mercado al momento de la compra
`spread_percent`	number	Porcentaje de spread aplicado
`fee`	number	Comisión fija cobrada
`total_debited`	number	Monto total debitado del saldo (`amount + fee`)
`after_hours`	boolean	Indica si la compra se realizó fuera del horario de mercado

Acciones válidas

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

Errores

Código	Descripción
`400`	Símbolo inválido, datos inválidos, monto fuera de rango, saldo insuficiente o inversión total máxima excedida
`401`	No autenticado
`429`	Demasiadas solicitudes
`500`	Error procesando la compra
`503`	Trading deshabilitado o precio de mercado no disponible

Notas

El spread varía según el horario: es mayor fuera del horario de mercado.
Se aplica una comisión fija adicional al monto de compra.
Existe un límite máximo de inversión total por usuario.
Las compras se ejecutan en una transacción atómica para garantizar consistencia.

On this page