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ódigo | Descripción |
|---|---|
| 401 | Sin sesión |
| 429 | Más de 20 consultas por minuto (RATE_LIMITED) |