SecretCryptos API दस्तावेज़

ऑर्डर स्थिति

दोनों mixer और exchange ऑर्डर की स्थिति जांचने के लिए एक ही एंडपॉइंट का उपयोग करें। आप ऑर्डर प्रकार को स्पष्ट रूप से सेट कर सकते हैं ( mixer/ exchange) या API को स्वचालित रूप से पहचानने दे सकते हैं।

एंडपॉइंट

अनुरोध बॉडी

• trackcode(आवश्यक): ऑर्डर का 16-अक्षरों का अपरकेस ट्रैकिंग कोड।
• type(वैकल्पिक): mixer | exchange। यदि छोड़ा गया है, तो API इसे स्वतः पहचानने का प्रयास करेगा।
• outputs(वैकल्पिक): none | summary | full (डिफ़ॉल्ट: summary)।
• mask_addresses(वैकल्पिक): true=पते छिपाएँ (डिफ़ॉल्ट), false=पूर्ण पते लौटाएँ।

प्रतिक्रिया

• 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: केवल तब true जब confirm_status==2 और is_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" (यदि पूरी तरह से फंड नहीं हुआ)।

व्यावसायिक नियम

• ऑर्डर शुरू नहीं होंगे जब तक पूरी तरह से फंड नहीं किया गया ( is_fully_funded=false): आउटपुट असाइन नहीं किए जाते और कोई पार्टनर भुगतान उत्पन्न नहीं होता।
• यदि confirm_status==2 और is_fully_funded==true:
  • आउटपुट को एक बार टाइमस्टैम्प किया जाता है और बार-बार जांच करने पर भी स्थिर रहते हैं।
  • एफिलिएट आय केवल एक बार जमा की जाती है जब ऑर्डर वैध हो जाता है।

उदाहरण अनुरोध (PHP)

// मिक्सर उदाहरण (पूर्ण आउटपुट, बिना मास्क किए पते)<?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);

उदाहरण प्रतिक्रिया — पूरी तरह से फंड किया गया

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

उदाहरण प्रतिक्रिया — अपर्याप्त फंड

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

आउटपुट विवरण

• index: ऑर्डर में अनुक्रमिक आउटपुट संख्या।
• address: गंतव्य पता जहाँ फंड भेजे जाते हैं।
• destination_tag: XRP, XLM आदि के लिए वैकल्पिक टैग/मेमो ( null यदि आवश्यक नहीं)।
• coin: आउटपुट की क्रिप्टोकरेंसी कोड (उदा., btc, eth)।
• network: ट्रांसफर के लिए उपयोग किया गया नेटवर्क नाम (उदा., btc, eth)।
• share_percent: इस आउटपुट को सौंपे गए कुल जमा का प्रतिशत।
• delay_label: मानव-पठनीय लेबल जो दिखाता है कि यह आउटपुट कब संसाधित किया जाएगा (उदा., 2h 0m)।
• delay_seconds: सेकंड में देरी जब तक आउटपुट संसाधित होना शुरू हो।
• state: आउटपुट स्थिति:
  • 0 → प्रतीक्षा (जमा अभी तक पूरी तरह से पुष्टि नहीं हुई)।
  • 1 → प्रोसेसिंग (निर्धारित; delay_seconds 0 पर पहुँचने पर शुरू होता है)।
  • 2 → पूर्ण (ट्रांसफर समाप्त)।
• confirm: ट्रांसफर पुष्टिकरण स्थिति (केवल state=2 में प्रासंगिक):
  • 0 → लेन-देन प्रसारित किया गया लेकिन अभी तक पुष्टि नहीं हुई (लंबित)।
  • 1 → लेन-देन की पुष्टि (कम से कम 1 ब्लॉकचेन पुष्टि)।
• tx: इस आउटपुट के लिए ब्लॉकचेन लेन-देन हैश।
• amount: इस आउटपुट पते पर भेजी गई राशि।
• left_seconds: निर्धारित भेजने के समय तक शेष सेकंड।
  नोट: यह काउंटडाउन केवल deposit.confirm_status=2 (पूरी तरह से पुष्टि) होने के बाद शुरू होता है। उदाहरण: यदि 600 सेकंड (10 मिनट) सेट है, तो यह केवल जमा पुष्टि के बाद गिनना शुरू करता है।

नोट: भुगतान और आउटपुट डेटा हर ~1 मिनट में रीफ्रेश किए जाते हैं।

त्रुटि कोड

• BAD_REQUEST: गायब/अमान्य trackcode, गलत अनुरोध बॉडी।
• NOT_FOUND: ऑर्डर नहीं मिला।
• UNAUTHORIZED / FORBIDDEN: API कुंजी अमान्य या अक्षम।
• TOO_MANY_REQUESTS: दैनिक अनुरोध सीमा पार हो गई।
• SERVER_ERROR: अप्रत्याशित सर्वर त्रुटि।

• mask_addresses: mask_addresses द्वारा नियंत्रित (डिफ़ॉल्ट: true)।
• delay_seconds: delay_label का संख्यात्मक समकक्ष (केवल full मोड में लौटाया जाता है)।