Documentation de l’API SecretCryptos

Statut de la commande

Utilisez un seul endpoint pour vérifier le statut des commandes mixer et exchange. Vous pouvez définir explicitement le type de commande (mixer/ exchange) ou laisser l’API le détecter automatiquement.

Endpoint

Corps de la requête

• trackcode(obligatoire) : Code de suivi en majuscules de 16 caractères de la commande.
• type(optionnel) : mixer | exchange. Si omis, l’API tentera de détecter automatiquement.
• outputs(optionnel) : none | summary | full (par défaut : summary).
• mask_addresses(optionnel) : true=masquer les adresses (par défaut), false=renvoyer les adresses complètes.

Réponse

• type : mixer ou exchange.
• deposit.confirm_status : Statut de confirmation du dépôt :
  • 0 : Aucun paiement reçu.
  • 1 : Paiement reçu mais encore en attente (en attente de confirmations ou pas encore totalement financé).
  • 2 : Dépôt entièrement confirmé et financé.
• deposit.delete_in_sec : Secondes restantes jusqu’à l’expiration de la rétention de 48 heures.
• Bloc deposit.funding :
  • waiting_balance : Montant total attendu.
  • received_balance : Montant reçu jusqu’à présent.
  • remaining_need : Montant restant à recevoir.
  • is_fully_funded : Indique si le dépôt est entièrement financé.
  • can_start : seulement true si confirm_status==2 ET is_fully_funded==true.
• outputs:
  • none : Non renvoyé.
  • summary : Renvoie count, sent_count, sent_total.
  • full : Pour chaque sortie : index, address (masquée ou non), destination_tag, coin, network, share_percent, delay_label, delay_seconds, state, confirm, tx, amount, left_seconds.
• status_reason : ex. "INSUFFICIENT_FUNDS" (si non totalement financé).

Règles métier

• Les commandes ne démarrent pas tant qu’elles ne sont pas totalement financées (is_fully_funded=false) : les sorties restent non attribuées et aucun gain partenaire n’est généré.
• Si confirm_status==2 ET is_fully_funded==true :
  • Les sorties sont horodatées une seule fois et restent cohérentes lors des vérifications répétées.
  • Les gains des affiliés sont crédités une seule fois lorsque la commande devient valide.

Exemple de requête (PHP)

// Exemple mixer (sorties complètes, adresses non masquées)<?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);

Exemple de réponse — entièrement financée

{
  "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
    }
  ]
}

Exemple de réponse — sous-financée

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

Explication des sorties

• index : Numéro séquentiel de sortie dans la commande.
• address : Adresse de destination où les fonds sont envoyés.
• destination_tag : Tag/memo optionnel pour XRP, XLM, etc. (null si non requis).
• coin : Code de la cryptomonnaie de la sortie (ex. : btc, eth).
• network : Nom du réseau utilisé pour le transfert (ex. : btc, eth).
• share_percent : Pourcentage du dépôt total attribué à cette sortie.
• delay_label : Libellé lisible indiquant quand cette sortie sera traitée (ex. : 2h 0m).
• delay_seconds : Délai en secondes avant que la sortie puisse commencer à être traitée.
• state : État de la sortie :
  • 0 → En attente (dépôt pas encore confirmé).
  • 1 → En cours (planifiée ; commence quand delay_seconds atteint 0).
  • 2 → Terminé (transfert finalisé).
• confirm : Statut de confirmation du transfert (seulement pertinent si state=2) :
  • 0 → Transaction diffusée mais pas encore confirmée (en attente).
  • 1 → Transaction confirmée (au moins 1 confirmation blockchain).
• tx : Hash de transaction blockchain pour cette sortie.
• amount : Montant envoyé à cette adresse de sortie.
• left_seconds : Secondes restantes avant l’envoi prévu.
  Remarque : Ce compte à rebours démarre uniquement lorsque deposit.confirm_status=2 (entièrement confirmé). Exemple : si 600 secondes (10 minutes) est défini, il commence après confirmation du dépôt.

Remarque : Les données de paiement et de sortie sont actualisées environ toutes les minutes.

Codes d’erreur

• BAD_REQUEST : trackcode manquant/invalide, corps de requête mal formé.
• NOT_FOUND : Commande introuvable.
• UNAUTHORIZED / FORBIDDEN : Clé API invalide ou désactivée.
• TOO_MANY_REQUESTS : Limite quotidienne de requêtes dépassée.
• SERVER_ERROR : Erreur serveur inattendue.

• mask_addresses : contrôlé par mask_addresses (par défaut : true).
• delay_seconds : équivalent numérique de delay_label (uniquement renvoyé en mode full).