Documentación de la API de SecretCryptos

Estado de Orden

Usa un único endpoint para comprobar el estado de pedidos de mixer y de exchange. Puedes establecer explícitamente el tipo de pedido (mixer/exchange) o dejar que la API lo detecte automáticamente.

Endpoint

Cuerpo de la solicitud

• trackcode(obligatorio): El código de seguimiento de 16 caracteres en mayúsculas del pedido.
• type(opcional): mixer | exchange. Si se omite, la API intentará detectarlo automáticamente.
• outputs(opcional): none | summary | full (por defecto: summary).
• mask_addresses(opcional): true=enmascarar direcciones (por defecto), false=devolver direcciones completas.

Respuesta

• type: mixer o exchange.
• deposit.confirm_status: Estado de confirmación del depósito:
  • 0: No se ha recibido pago.
  • 1: Pago recibido pero aún pendiente (esperando confirmaciones o no totalmente financiado).
  • 2: Depósito completamente confirmado y financiado.
• deposit.delete_in_sec: Segundos restantes hasta la expiración del período de retención de 48 horas.
• Bloque deposit.funding:
  • waiting_balance: Monto total esperado.
  • received_balance: Monto recibido hasta ahora.
  • remaining_need: Monto restante necesario.
  • is_fully_funded: Si está totalmente financiado.
  • can_start: solo true si confirm_status==2 Y is_fully_funded==true.
• outputs:
  • none: No se devuelve.
  • summary: Devuelve count, sent_count, sent_total.
  • full: Para cada salida: index, address (enmascarada o no), destination_tag, coin, network, share_percent, delay_label, delay_seconds, state, confirm, tx, amount, left_seconds.
• status_reason: ej. "INSUFFICIENT_FUNDS" (si no está totalmente financiado).

Reglas de negocio

• Los pedidos no comenzarán a menos que estén totalmente financiados (is_fully_funded=false): las salidas permanecen sin asignar y no se genera comisión de afiliado.
• Si confirm_status==2 Y is_fully_funded==true:
  • Las salidas se sellan con una marca de tiempo una sola vez y permanecen consistentes en comprobaciones repetidas.
  • Las ganancias de afiliados se acreditan una única vez cuando el pedido se valida.

Ejemplo de solicitud (PHP)

// Ejemplo Mixer (salidas completas, direcciones sin enmascarar)<?php
$url = "https://api.secretcryptos.com/v1/orders/check";

$headers = [
  "Authorization: Bearer <API_KEY>",
  "Content-Type: application/json"
];

$data = [
  "trackcode"      => "554FEC10054743FD",
  "type"           => "mixer",     // mixer | exchange
  "outputs"        => "full",      // none | summary | full
  "mask_addresses" => false        // true(default)=masked, false=full
];

$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => $headers,
  CURLOPT_POST           => true,
  CURLOPT_POSTFIELDS     => json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
]);

$result = curl_exec($ch);

if ($result === false) {
  header("Content-Type: text/plain; charset=utf-8");
  echo "cURL error: " . curl_error($ch);
} else {
  header("Content-Type: application/json; charset=utf-8");
  echo $result;
}
curl_close($ch);

Ejemplo de respuesta — Totalmente financiado

{
  "ok": true,
  "type": "mixer",
  "trackcode": "6A5FB3BA8A150EC9",
  "deposit": {
    "confirm_status": 2,
    "coin": "btc",
    "network": "btc",
    "delete_in_sec": 167812,
    "funding": {
      "waiting_balance": "10.00000000",
      "received_balance": "10.00000000",
      "remaining_need": "0.00000000",
      "is_fully_funded": true,
      "can_start": true
    }
  },
  "outputs": [
    {
      "index": 1,
      "address": "35iMHbUZeTssxBodiHwEEkb32jpBfVueEL",
      "destination_tag": null,
      "coin": "btc",
      "network": "btc",
      "share_percent": 84.93,
      "delay_label": "0h 0m",
      "delay_seconds": 0,
      "state": 2,
      "confirm": 1,
      "tx": "135f451af7f894....fafb578eee9e9c4",
      "amount": "8.45469657",
      "left_seconds": 0
    },
    {
      "index": 2,
      "address": "1P279UBChDFPAky8S4DcKGaaxKEMYBK9MM",
      "destination_tag": null,
      "coin": "btc",
      "network": "btc",
      "share_percent": 15.07,
      "delay_label": "2h 0m",
      "delay_seconds": 7200,
      "state": 1,
      "confirm": 0,
      "tx": "",
      "amount": "1.50020343",
      "left_seconds": 5916
    }
  ]
}

Ejemplo de respuesta — No financiado completamente

{
  "ok": true,
  "type": "exchange",
  "trackcode": "A1B2C3D4E5F6A7B8",
  "deposit": {
    "confirm_status": 2,
    "coin": "usdt",
    "network": "erc20",
    "delete_in_sec": 14321,
    "funding": {
      "waiting_balance": "500.00000000",
      "received_balance": "420.00000000",
      "remaining_need": "80.00000000",
      "is_fully_funded": false,
      "can_start": false
    }
  },
  "status_reason": "INSUFFICIENT_FUNDS",
  "outputs": {
    "count": 3,
    "sent_count": 0,
    "sent_total": "0.00000000"
  }
}

Explicación de las salidas

• index: Número secuencial de la salida en el pedido.
• address: Dirección de destino donde se envían los fondos.
• destination_tag: Tag/memo opcional para XRP, XLM, etc. (null si no es requerido).
• coin: Código de la criptomoneda de la salida (ej. btc, eth).
• network: Nombre de la red usada para la transferencia (ej. btc, eth).
• share_percent: Porcentaje del depósito total asignado a esta salida.
• delay_label: Etiqueta legible que muestra cuándo se procesará esta salida (ej. 2h 0m).
• delay_seconds: Retraso en segundos hasta que la salida pueda empezar a procesarse.
• state: Estado de la salida:
  • 0 → Esperando (depósito aún no totalmente confirmado).
  • 1 → Procesando (programado; comienza cuando delay_seconds llega a 0).
  • 2 → Completado (transferencia finalizada).
• confirm: Estado de confirmación de la transferencia (solo relevante en state=2):
  • 0 → Transacción transmitida pero aún sin confirmar (pendiente).
  • 1 → Transacción confirmada (al menos 1 confirmación en blockchain).
• tx: Hash de transacción en blockchain para esta salida.
• amount: Monto enviado a esta dirección de salida.
• left_seconds: Segundos restantes hasta el tiempo de envío programado.
  Nota: Esta cuenta regresiva comienza solo después de que deposit.confirm_status=2 (totalmente confirmado). Ejemplo: si se configuran 600 segundos (10 minutos), empieza a contar únicamente tras la confirmación del depósito.

Nota: Los datos de pagos y salidas se actualizan aproximadamente cada 1 minuto.

Códigos de error

• BAD_REQUEST: trackcode faltante/inválido, cuerpo de solicitud malformado.
• NOT_FOUND: Pedido no encontrado.
• UNAUTHORIZED / FORBIDDEN: API key inválida o deshabilitada.
• TOO_MANY_REQUESTS: Límite diario de solicitudes superado.
• SERVER_ERROR: Error inesperado del servidor.

• mask_addresses: controlado por mask_addresses (por defecto: true).
• delay_seconds: equivalente numérico de delay_label (solo se devuelve en modo full).