SecretCryptos API Documentation

Order Status

Utilizza un singolo endpoint per controllare lo stato di entrambi gli ordinimixereexchange. Puoi impostare esplicitamente il tipo di ordine (mixer/ exchange) o lasciare che l'API lo rilevi automaticamente.

Endpoint

Request Body

• trackcode(obbligatorio): il codice di monitoraggio in maiuscolo di 16 caratteri dell'ordine.
• type(opzionale): mixer | exchange. Se omesso, l'API tenterà il rilevamento automatico.
• outputs(opzionale): none | summary | full(impostazione predefinita:summary).
• mask_addresses(opzionale): true=indirizzi maschera (impostazione predefinita),false=restituisce indirizzi completi.

Risposta

• type: mixeroexchange.
• deposit.confirm_status: Stato di conferma del deposito:
  • 0: Nessun pagamento ricevuto.
  • 1: Pagamento ricevuto ma ancora in sospeso (in attesa di conferme o non ancora completamente finanziato).
  • 2: Deposito completamente confermato e finanziato.
• deposit.delete_in_sec: Secondi rimanenti fino alla conservazione di 48 ore scadenza.
• deposit.fundingblocco:
  • waiting_balance: Importo totale previsto.
  • received_balance: Importo ricevuto finora.
  • remaining_need: Importo rimanente necessario.
  • is_fully_funded: Se interamente finanziato.
  • can_start: onlytrue ifconfirm_status==2ANDis_fully_funded==true.
• outputs:
  • none: Non restituito.
  • summary: Restituiscecount, sent_count, sent_total.
  • full: Per ogni output:index, address (mascherato o meno),destination_tag, coin, network, share_percent, delay_label, delay_seconds, state, confirm, tx, amount, left_seconds.
• status_reason: ad es."INSUFFICIENT_FUNDS"(se non completamente finanziato).

Regole aziendali

• Gli ordini non verranno avviatia meno che non siano completamente finanziati (is_fully_funded=false): gli output rimangono non assegnati e non viene generato alcun pagamento per il partner.
• Seconfirm_status==2ANDis_fully_funded==true:
  • Gli output vengono contrassegnati con timestamp una volta e rimangono coerenti anche se ripetuti assegni.
  • I guadagni dell'affiliato vengono accreditati una sola volta quando l'ordine diventa valido.

Richiesta di esempio (PHP)

// Mixer example (full outputs, unmasked addresses)<?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);

Esempio di risposta: interamente finanziato

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

Esempio di risposta: sottofinanziato

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

Spiegazione degli output

• index: Numero di output sequenziale nel ordine.
• address: indirizzo di destinazione dove vengono inviati i fondi.
• destination_tag: tag/memo opzionale per XRP, XLM, ecc. (nullse non richiesto).
• coin: codice criptovaluta dell'output (ad esempio,btc, eth).
• network: nome di rete utilizzato per il trasferimento (ad esempio,btc, eth).
• share_percent: percentuale del deposito totale assegnato a questo output.
• delay_label: etichetta leggibile che mostra quando questo output verrà elaborato (ad es.,2h 0m).
• delay_seconds: ritardo in secondi prima che l'output possa iniziare l'elaborazione.
• state: stato dell'output:
  • 0→ In attesa (deposito non ancora completamente confermato).
  • 1→ Elaborazione (programmata; inizia quandodelay_seconds raggiunge 0).
  • 2→ Completo (trasferimento terminato).
• confirm: Stato di conferma del trasferimento (rilevante solo instate=2):
  • 0→ Transazione trasmessa ma non ancora confermata (in sospeso).
  • 1→ Transazione confermata (almeno 1 blockchain conferma).
• tx: hash della transazione blockchain per questo output.
• amount: importo inviato a questo indirizzo di output.
• left_seconds: secondi rimanenti fino all'ora di invio pianificata.
  Nota:Questo conto alla rovescia si reimposta una voltadeposit.confirm_status=2 (completamente confermato). Esempio: se600secondi (10 minuti), inizia il conto alla rovescia solo dopo la conferma del deposito.

Nota:I dati di pagamento e di output vengono aggiornati ogni circa 1 minuto.

Codici di errore

• BAD_REQUEST: Mancante/non validotrackcode, corpo della richiesta non valido.
• NOT_FOUND: Ordine non valido trovato.
• UNAUTHORIZED / FORBIDDEN: chiave API non valida o disabilitata.
• TOO_MANY_REQUESTS: limite di richieste giornaliere superato.
• SERVER_ERROR: errore imprevisto del server.

• mask_addresses: controllato damask_addresses (predefinito:true).
• delay_seconds: equivalente numerico didelay_label (solo restituito infull).