Puesto promocionado

Cada moneda del mercado P2P tiene dos puestos promocionados, uno por tipo de oferta:

Quien tiene el puesto sale arriba del listado de esa moneda y tipo con su mejor oferta abierta (la de mejor tasa para quien la toma), con borde amarillo y la etiqueta «Promocionado». La misma oferta lleva el borde también en su posición normal. El orden del mercado por mejor tasa no cambia. Si el titular no tiene ninguna oferta abierta de ese par, no sale nada.

Cómo funcionaCopy Anchor Link

• Puesto libre: se compra al instante a precio de salida ($10) y queda bloqueado 30 días. Nadie lo quita en ese tiempo.
• Puesto ocupado: se puja por el periodo siguiente. Para superar la puja líder hay que ofrecer un 10 % más, con un mínimo de +$1. La primera puja empieza en el precio de salida.
• La puja se cobra del saldo al hacerla y queda retenida. Si alguien la supera, se devuelve íntegra al instante. Solo paga quien gana el periodo.
• Al vencer el periodo, la puja más alta empieza el suyo justo donde terminó el anterior. Si nadie pujó, el puesto vuelve a estar libre.
• No puedes subir tu propia puja mientras vas ganando. El titular actual sí puede pujar por el periodo siguiente.
• Te avisamos por push y Telegram cuando te superan, cuando ganas un periodo, cuando termina y 3 días antes de que venza.

GET /p2p/promoCopy Anchor Link

Estado de los dos puestos de una moneda.

AutenticaciónCopy Anchor Link

Bearer Token (Authorization: Bearer <token> en headers).

RequestCopy Anchor Link

curl -X GET "https://api.qvapay.com/p2p/promo?coin=BANK_CUP" \
  -H "Authorization: Bearer <token>"

Response (200)Copy Anchor Link

{
  "data": {
    "coin": "BANK_CUP",
    "enabled": true,
    "slots": [
      {
        "coin": "BANK_CUP",
        "offer_type": "sell",
        "state": "held",
        "holder": { "uuid": "9a1b…", "username": "comerciante" },
        "starts_at": "2026-10-16T12:00:00.000Z",
        "ends_at": "2026-11-15T12:00:00.000Z",
        "leading_amount": 25,
        "min_bid": 27.5,
        "start_price": 10,
        "period_days": 30
      },
      {
        "coin": "BANK_CUP",
        "offer_type": "buy",
        "state": "free",
        "holder": null,
        "starts_at": null,
        "ends_at": null,
        "leading_amount": null,
        "min_bid": 10,
        "start_price": 10,
        "period_days": 30
      }
    ]
  }
}

Con la función apagada, enabled es false y slots viene vacío.

POST /p2p/promoCopy Anchor Link

Compra el puesto (si está libre) o puja por el periodo siguiente (si está ocupado). El servidor decide cuál de las dos según el estado del puesto en ese instante.

Requisitos de la cuenta: KYC aprobado y P2P activo.

RequestCopy Anchor Link

curl -X POST "https://api.qvapay.com/p2p/promo" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{ "coin": "BANK_CUP", "offer_type": "sell", "amount": 27.5, "idempotency_key": "promo-7f3c9a1e" }'

BodyCopy Anchor Link

Response (201)Copy Anchor Link

{
  "data": {
    "uuid": "3f2a…",
    "coin": "BANK_CUP",
    "offer_type": "sell",
    "kind": "bid",
    "status": "held",
    "amount": 27.5,
    "period_starts_at": null,
    "period_ends_at": null,
    "created_at": "2026-10-20T09:15:00.000Z"
  },
  "action": "bid",
  "slot": { "coin": "BANK_CUP", "offer_type": "sell", "state": "held", "leading_amount": 27.5, "min_bid": 30.25 },
  "balance": 412.7
}

action es purchase cuando compraste un puesto libre (kind: "purchase", status: "won", con su periodo) o bid cuando pujaste (status: "held" mientras vas ganando). Repetir una idempotency_key ya usada responde 200 con la misma operación y duplicate: true.

ErroresCopy Anchor Link

Todos los errores de negocio traen slot con el estado actual del puesto.

En el listadoCopy Anchor Link

GET /p2p con coin y type devuelve el campo promoted con la oferta promocionada de ese par, lista para pintar arriba del resto.