SecretCryptos API-Dokumentation

Bestellstatus

Verwenden Sie einen einzigen Endpunkt, um den Status von Mixer- und Exchange-Bestellungen zu prüfen. Sie können den Bestelltyp explizit setzen (mixer/ exchange) oder die API automatisch erkennen lassen.

Endpunkt

Request Body

• trackcode(erforderlich): Der 16-stellige Tracking-Code der Bestellung in Großbuchstaben.
• type(optional): mixer | exchange. Wenn weggelassen, versucht die API, automatisch zu erkennen.
• outputs(optional): none | summary | full (Standard: summary).
• mask_addresses(optional): true=Adressen maskieren (Standard), false=volle Adressen zurückgeben.

Antwort

• type: mixer oder exchange.
• deposit.confirm_status: Status der Einzahlung:
  • 0: Keine Zahlung eingegangen.
  • 1: Zahlung eingegangen, aber noch ausstehend (entweder wartend auf Bestätigungen oder noch nicht vollständig gedeckt).
  • 2: Einzahlung vollständig bestätigt und gedeckt.
• deposit.delete_in_sec: Verbleibende Sekunden bis zum Ablauf der 48-Stunden-Aufbewahrung.
• deposit.funding-Block:
  • waiting_balance: Gesamterwartungsbetrag.
  • received_balance: Bisher erhaltener Betrag.
  • remaining_need: Noch benötigter Betrag.
  • is_fully_funded: Ob vollständig gedeckt.
  • can_start: nur true, wenn confirm_status==2 UND is_fully_funded==true.
• outputs:
  • none: Nicht zurückgegeben.
  • summary: Gibt count, sent_count, sent_total zurück.
  • full: Für jede Ausgabe: index, address (maskiert oder nicht), destination_tag, coin, network, share_percent, delay_label, delay_seconds, state, confirm, tx, amount, left_seconds.
• status_reason: z. B. "INSUFFICIENT_FUNDS" (falls nicht vollständig gedeckt).

Geschäftsregeln

• Bestellungen starten nicht, solange sie nicht vollständig gedeckt sind (is_fully_funded=false): Ausgaben bleiben unzugewiesen und keine Partnervergütung wird generiert.
• Wenn confirm_status==2 UND is_fully_funded==true:
  • Ausgaben werden einmal mit Zeitstempeln versehen und bleiben bei wiederholten Abfragen konsistent.
  • Partnervergütungen werden einmalig gutgeschrieben, wenn die Bestellung gültig wird.

Beispielanfrage (PHP)

// Mixer-Beispiel (volle Ausgaben, unmaskierte Adressen)<?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);

Beispielantwort — Vollständig gedeckt

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

Beispielantwort — Unterdeckt

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

Ausgabenerklärung

• index: Fortlaufende Ausgabennummer in der Bestellung.
• address: Zieladresse, an die Gelder gesendet werden.
• destination_tag: Optionales Tag/Memo für XRP, XLM usw. (null, falls nicht erforderlich).
• coin: Kryptowährungscode der Ausgabe (z. B. btc, eth).
• network: Netzwerkname, der für die Übertragung verwendet wird (z. B. btc, eth).
• share_percent: Prozentsatz der Gesamteinzahlung, der dieser Ausgabe zugewiesen wird.
• delay_label: Menschlich lesbares Label, wann diese Ausgabe verarbeitet wird (z. B. 2h 0m).
• delay_seconds: Verzögerung in Sekunden, bis die Ausgabe verarbeitet werden kann.
• state: Ausgabestatus:
  • 0 → Wartend (Einzahlung noch nicht vollständig bestätigt).
  • 1 → Verarbeitung (geplant; beginnt, wenn delay_seconds 0 erreicht).
  • 2 → Abgeschlossen (Übertragung beendet).
• confirm: Transferbestätigungsstatus (nur relevant bei state=2):
  • 0 → Transaktion gesendet, aber noch nicht bestätigt (ausstehend).
  • 1 → Transaktion bestätigt (mindestens 1 Blockchain-Bestätigung).
• tx: Blockchain-Transaktionshash für diese Ausgabe.
• amount: An diese Ausgabedresse gesendeter Betrag.
• left_seconds: Verbleibende Sekunden bis zur geplanten Sendezeit.
  Hinweis: Dieser Countdown startet erst, wenn deposit.confirm_status=2 (vollständig bestätigt) ist. Beispiel: wenn 600 Sekunden (10 Minuten) eingestellt sind, beginnt der Countdown erst nach Einzahlungsbestätigung.

Hinweis: Zahlungs- und Ausgabedaten werden etwa jede Minute aktualisiert.

Fehlercodes

• BAD_REQUEST: Fehlender/ungültiger trackcode, fehlerhafter Request Body.
• NOT_FOUND: Bestellung nicht gefunden.
• UNAUTHORIZED / FORBIDDEN: API-Key ungültig oder deaktiviert.
• TOO_MANY_REQUESTS: Tägliches Anfrage-Limit überschritten.
• SERVER_ERROR: Unerwarteter Serverfehler.

• mask_addresses: gesteuert durch mask_addresses (Standard: true).
• delay_seconds: numerisches Äquivalent zu delay_label (nur im full-Modus zurückgegeben).