Listar Coins

GET /coinsCopy Anchor Link

Retorna todas las categorías de monedas (Criptomonedas, Bank, Cash, E-Wallet, Gift Card, Móvil) junto con los coins que pertenecen a cada una. Cada coin incluye su configuración completa: comisiones de entrada y salida, límites, campos requeridos para retiros y estado de disponibilidad.

AutenticaciónCopy Anchor Link

No requiere autenticación (endpoint público).

RequestCopy Anchor Link

curl -X GET https://api.qvapay.com/coins

ResponseCopy Anchor Link

[
  {
    "id": 1,
    "name": "Criptomonedas",
    "logo": "crypto",
    "Coins": [
      {
        "id": "6",
        "coins_categories_id": 1,
        "network": "TRON",
        "name": "USDT (TRC20)",
        "logo": "usdt",
        "tick": "USDT",
        "fee_in": "0.2",
        "fee_in_gold": "0",
        "fee_out": "1",
        "fee_out_gold": "0.8",
        "fee_out_fixed": [100, 1],
        "min_in": "1",
        "min_out": "2",
        "max_in": 1000000,
        "max_out": 5000,
        "working_data": [
          {
            "name": "Wallet",
            "type": "text"
          }
        ],
        "enabled_in": true,
        "enabled_out": true,
        "enabled_p2p": true,
        "auto_withdraw": true,
        "p2p_rate_discount": "0",
        "trade": false,
        "price": "1",
        "decimals": 2,
        "stable": true,
        "created_at": null,
        "updated_at": "2025-06-12T03:40:01.000Z",
        "description": "### ¿Qué es USDT (TRC20)? ...",
        "seo_title": "USDT TRC20 ✓ Compra y envía en QvaPay",
        "seo_description": "USDT TRC20 en QvaPay: stablecoin rápido y seguro..."
      }
    ]
  }
]

Campos de la categoríaCopy Anchor Link

Campos del coinCopy Anchor Link

Cómo funciona fee_out_fixedCopy Anchor Link

fee_out_fixed define un fee fijo para retiros de montos pequeños, en lugar del porcentaje fee_out. Es un arreglo de dos valores:

fee_out_fixed: [umbral, fee_fijo]

• umbral (primer valor): límite en USD que separa los dos modos de comisión.
• fee_fijo (segundo valor): comisión fija en USD que se cobra cuando el monto del retiro es menor o igual al umbral.

La regla de cálculo es:

Cuando fee_out_fixed es null, siempre se aplica el porcentaje fee_out sin importar el monto.

EjemploCopy Anchor Link

USDT (TRC20) tiene fee_out: "1" y fee_out_fixed: [100, 1]:

• Retiro de $50 → como 50 <= 100, se cobra el fee fijo de $1. El usuario recibe $49.
• Retiro de $100 → como 100 <= 100, se cobra el fee fijo de $1. El usuario recibe $99.
• Retiro de $500 → como 500 > 100, se cobra el 1%: $5. El usuario recibe $495.

Este esquema evita que los retiros pequeños paguen comisiones porcentuales insignificantes que no cubren el costo de red, garantizando un fee mínimo rentable, mientras que los retiros grandes pagan el porcentaje normal.

Nota: para usuarios GOLD el porcentaje usado por encima del umbral es fee_out_gold, pero el fee fijo por debajo del umbral es el mismo para todos los usuarios.

Campos de working_dataCopy Anchor Link

working_data describe el formulario que el usuario debe completar al retirar en ese coin (ej: dirección de wallet, datos bancarios, número de celular). Cada elemento tiene:

Las opciones de un campo select pueden incluir metadatos adicionales:

Efectivo por zonas: si una moneda de efectivo tiene tarifario por municipio (cash_zones en el propio coin, o GET /withdraw/cash-zones?coin=…), el fee_pct de la provincia se ignora y el recargo sale de la zona elegida. Ver Listar y Crear Retiros.

Tarifario de efectivo por municipio (cash_zones)Copy Anchor Link

Las monedas de efectivo que se entregan por municipio (hoy USDCASH) llevan el tarifario completo dentro del coin, con el mismo contenido que GET /withdraw/cash-zones. El campo aparece igual en GET /coins, GET /coins/v2 y GET /coins/:id.

"cash_zones": {
  "margin_pct": 1,
  "zones": [
    {
      "id": "1",
      "coin_tick": "USDCASH",
      "province_code": "ART",
      "province_name": "Artemisa",
      "municipality": "Artemisa",
      "is_capital": true,
      "provider_pct": 3,
      "margin_pct": null,
      "total_pct": 4,
      "min_usd": 50,
      "small_flat_usd": 4,
      "eta_min_hours": 24,
      "eta_max_hours": 48,
      "home_delivery": true,
      "route": "p2p",
      "enabled": true
    }
  ]
}

Cargo de la zona sobre el amount del retiro, que se suma al fee_out del coin: max(amount × provider_pct / 100, small_flat_usd) + amount × margen / 100. Por ejemplo, retirar $200 en Artemisa cuesta max(6, 4) + 2 = $8 de cargo de zona, más el fee_out del coin.

Si la moneda deja de entregarse por zonas, cash_zones desaparece y el retiro vuelve al fee_pct del select de provincia. Las tarifas pueden tardar hasta unos 15 minutos en reflejar un cambio (caché).

NotasCopy Anchor Link

• La respuesta es un array JSON de categorías, cada una con sus coins en la propiedad Coins.
• Los IDs de tipo BigInt se serializan como strings en la respuesta.
• Los precios (price) de activos no estables se actualizan periódicamente mediante un cron; el campo updated_at refleja la última actualización.
• Las comisiones fee_in, fee_in_gold, fee_out y fee_out_gold son siempre porcentajes, no montos fijos.