Vender Stock

`POST /stocks/:tick/sell`

Vende acciones fraccionadas de una posición existente. El monto resultante se acredita al saldo de QvaPay del usuario. El precio de venta incluye un spread por debajo del precio de mercado.

Autenticación

Bearer Token en el header Authorization.

Authorization: Bearer {tu-token}

Request

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

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
`quantity`	number/string	Sí	Cantidad de acciones a vender. Debe ser mayor que cero y no exceder la cantidad que posee el usuario.

Response

{
  "success": true,
  "data": {
    "trade_uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "transaction_uuid": "c3d4e5f6-a7b8-9012-cdef-012345678901",
    "symbol": "AAPL",
    "quantity": 0.5,
    "effective_price": 177.82,
    "market_price": 178.25,
    "spread_percent": 0.24,
    "fee": 0.25,
    "total_credited": 88.66,
    "realized_pnl": 2.35,
    "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 vendida
`quantity`	number	Cantidad de acciones vendidas
`effective_price`	number	Precio efectivo de venta (con spread)
`market_price`	number	Precio de mercado al momento de la venta
`spread_percent`	number	Porcentaje de spread aplicado
`fee`	number	Comisión fija cobrada
`total_credited`	number	Monto neto acreditado al saldo (`quantity * effective_price - fee`)
`realized_pnl`	number	Ganancia o pérdida realizada respecto al costo promedio
`after_hours`	boolean	Indica si la venta 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, acciones insuficientes o monto de venta insuficiente para cubrir comisiones
`401`	No autenticado
`429`	Demasiadas solicitudes
`500`	Error procesando la venta
`503`	Trading deshabilitado o precio de mercado no disponible

Notas

El spread de venta reduce el precio efectivo respecto al precio de mercado.
El spread es mayor fuera del horario de mercado.
Se aplica una comisión fija que se descuenta del monto bruto de la venta.
El realized_pnl calcula la ganancia/pérdida comparando el precio efectivo de venta con el costo promedio de adquisición.
Si el monto neto de la venta es menor o igual a cero (por comisiones), la operación será rechazada.

On this page