SecretCryptos API Documentation

Order Status

Use a single endpoint to check the status of bothmixerandexchangeorders. You can explicitly set the order type (mixer/ exchange) or let the API auto-detect it.

Endpoint

Request Body

• trackcode(required): The 16-character uppercase tracking code of the order.
• type(optional): mixer | exchange. If omitted, API will attempt to auto-detect.
• outputs(optional): none | summary | full(default:summary).
• mask_addresses(optional): true=mask addresses (default),false=return full addresses.

प्रतिक्रिया

• type: mixerयाexchange.
• deposit.confirm_status: जमा पुष्टिकरण स्थिति:
  • 0: कोई भुगतान प्राप्त नहीं हुआ।
  • 1: भुगतान प्राप्त हुआ लेकिन अभी भी लंबित है (या तो पुष्टि की प्रतीक्षा में है या अभी तक पूरी तरह से वित्त पोषित नहीं है)।
  • 2: जमा पूरी तरह से पुष्टि की गई है और वित्त पोषित है।
• deposit.delete_in_sec: 48 घंटे के प्रतिधारण तक शेष सेकंड समाप्ति।
• deposit.fundingब्लॉक:
  • waiting_balance: कुल अपेक्षित राशि।
  • received_balance: अब तक प्राप्त राशि।
  • remaining_need: शेष राशि की आवश्यकता।
  • is_fully_funded: क्या पूरी तरह से वित्त पोषित है।
  • can_start: केवलसत्य ifconfirm_status==2ANDis_fully_funded==true.
• outputs:
  • none: वापस नहीं आया।
  • summary: रिटर्न्सcount, sent_count, sent_total.
  • full: प्रत्येक आउटपुट के लिए:index, address(नकाबपोश या नहीं),destination_tag, coin, network, share_percent, delay_label, delay_seconds, state, confirm, tx, amount, left_seconds.
• status_reason: उदाहरण के लिए।"INSUFFICIENT_FUNDS"(if not fully funded).

Business Rules

• Orders will not startunless fully funded (is_fully_funded=false): outputs remain unassigned and no partner payout is generated.
• Ifconfirm_status==2ANDis_fully_funded==true:
  • Outputs are timestamped once and remain consistent on repeated checks.
  • Affiliate earnings are credited a single time when the order becomes valid.

Example Request (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);

Example Response — Fully Funded

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

Example Response — Underfunded

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

Outputs Explanation

• index: Sequential output number in the order.
• address: Destination address where funds are sent.
• destination_tag: Optional tag/memo for XRP, XLM, etc. (nullif not required).
• coin: Cryptocurrency code of the output (e.g.,btc, eth).
• network: Network name used for transfer (e.g.,btc, eth).
• share_percent: Percentage of the total deposit assigned to this output.
• delay_label: Human-readable label showing when this output will be processed (e.g.,2h 0m).
• delay_seconds: Delay in seconds until the output can start processing.
• state: Output state:
  • 0→ Waiting (deposit not yet fully confirmed).
  • 1→ Processing (scheduled; starts whendelay_secondsreaches 0).
  • 2→ Complete (transfer finished).
• confirm: Transfer confirmation status (only relevant instate=2):
  • 0→ Transaction broadcasted but not yet confirmed (pending).
  • 1→ Transaction confirmed (at least 1 blockchain confirmation).
• tx: Blockchain transaction hash for this output.
• amount: Amount sent to this output address.
• left_seconds: Remaining seconds until scheduled send time.
  Note:This countdown resets oncedeposit.confirm_status=2(fully confirmed). Example: if600seconds (10 minutes) is set, it starts counting down only after deposit confirmation.

Note:Payment and output data are refreshed every ~1 minute.

Error Codes

• BAD_REQUEST: Missing/invalidtrackcode, malformed request body.
• NOT_FOUND: Order not found.
• UNAUTHORIZED / FORBIDDEN: API key invalid or disabled.
• TOO_MANY_REQUESTS: Daily request limit exceeded.
• SERVER_ERROR: Unexpected server error.

• mask_addresses: controlled bymask_addresses(default:true).
• delay_seconds: numeric equivalent ofdelay_label(only returned infullmode).