QvaPay API
P2P

Ofertas destacadas

Las ofertas promocionadas y las últimas de comerciantes GOLD, el bloque "Ofertas P2P" del dashboard.

GET /p2p/featured

Devuelve el bloque "Ofertas P2P" del dashboard: hasta 2 ofertas promocionadas, elegidas al azar entre todos los puestos vigentes (primero de comerciantes distintos), y las últimas ofertas abiertas de comerciantes GOLD, sin repetir las promocionadas. Así lo enseña el Home de la app.

Cada oferta tiene la misma forma que una fila de GET /p2p. No incluye ofertas privadas ni pausadas. Las ofertas promocionadas pasan por los mismos filtros que en el mercado: el titular cumple la reputación mínima y su tasa está cerca de la del mercado.

Las dos listas se cachean en el servidor (30 s las últimas y 60 s las promocionadas), así que pedirlas más rápido no devuelve datos más frescos. El sorteo de las promocionadas cambia en cada petición.

Autenticación

Bearer Token (Authorization: Bearer <token>). No exige los requisitos del mercado P2P: tomar una oferta sí los exige.

Request

curl -X GET "https://api.qvapay.com/p2p/featured" \
  -H "Authorization: Bearer <token>"

Response (200)

{
  "data": {
    "promoted": [
      { "uuid": "9c1d…", "type": "sell", "coin": "BANK_CUP", "amount": "100", "receive": "41000", "User": { "uuid": "…", "username": "comerciante", "golden_check": true } }
    ],
    "offers": [
      { "uuid": "4f2a…", "type": "buy", "coin": "ZELLE", "amount": "50", "receive": "51", "User": { "uuid": "…", "username": "otro", "golden_check": true } }
    ]
  }
}

promoted llega vacío cuando no hay puestos vigentes o están desactivados. Una fuente caída también llega vacía, nunca como error.

Errores

CódigoDescripción
401Sin sesión
429Más de 20 consultas por minuto (RATE_LIMITED)