Detalle de Coin

Obtener los datos completos de un coin específico por su ID, incluyendo comisiones, límites y campos de retiro.

`GET /coins/:id`

Retorna la información completa de un coin específico identificado por su ID numérico: comisiones, límites de depósito y retiro, campos requeridos para retirar, estado de disponibilidad, precio y descripción.

Autenticación

Bearer Token en el header Authorization.

Authorization: Bearer {tu-token}

Request

curl -X GET https://api.qvapay.com/coins/6 \
  -H "Authorization: Bearer {tu-token}"

Parámetros de URL

Parámetro	Tipo	Requerido	Descripción
`id`	number	Sí	ID numérico del coin

Response

{
  "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 respuesta

La estructura del coin es idéntica a la de cada elemento de Coins en Listar Coins. Los campos más relevantes:

Campo	Tipo	Descripción
`id`	string	ID del coin (BigInt serializado como string)
`tick`	string	Ticker único del coin
`network`	string \| null	Red blockchain del activo
`fee_in` / `fee_in_gold`	string	Comisión de depósito en % (normal / usuarios GOLD)
`fee_out` / `fee_out_gold`	string	Comisión de retiro en % (normal / usuarios GOLD)
`fee_out_fixed`	array \| null	Fee fijo para retiros pequeños: `[umbral, fee_fijo]`. Ver abajo
`min_in` / `max_in`	string / number	Límites de depósito en USD
`min_out` / `max_out`	string / number	Límites de retiro en USD
`working_data`	array	Campos que el usuario debe completar al retirar
`enabled_in` / `enabled_out` / `enabled_p2p`	boolean	Disponibilidad para depósito, retiro y P2P
`auto_withdraw`	boolean	Los retiros se procesan automáticamente
`price`	string	Precio actual en USD
`stable`	boolean	`true` si mantiene paridad 1:1 con USD
`description`	string	Descripción del activo en Markdown

Cómo funciona `fee_out_fixed`

Cuando fee_out_fixed es un arreglo [umbral, fee_fijo], la comisión de retiro se calcula así:

Si el monto del retiro es menor o igual al umbral (primer valor), se cobra el fee fijo (segundo valor) en USD, en lugar del porcentaje.
Si el monto supera el umbral, se aplica el porcentaje normal (fee_out, o fee_out_gold para usuarios GOLD).

Por ejemplo, con fee_out: "1" y fee_out_fixed: [100, 1]: un retiro de $50 paga $1 fijo (recibe $49), mientras que un retiro de $500 paga el 1% = $5 (recibe $495). Si fee_out_fixed es null, siempre se aplica el porcentaje.

Consulta la explicación completa con ejemplos en Listar Coins → Cómo funciona fee_out_fixed.

Errores

Código	Descripción
`400`	Falta el parámetro `id`
`404`	Coin no encontrado

On this page