Документация SecretCryptos API

Статус заказа

Используйте единый endpoint для проверки статуса как 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 минут), отсчёт начинается только после подтверждения депозита.

Примечание: Данные о платежах и выводах обновляются примерно раз в минуту.

Коды ошибок

• BAD_REQUEST: Отсутствует/неверный trackcode, неверное тело запроса.
• NOT_FOUND: Заказ не найден.
• UNAUTHORIZED / FORBIDDEN: API-ключ неверен или отключён.
• TOO_MANY_REQUESTS: Превышен дневной лимит запросов.
• SERVER_ERROR: Неожиданная ошибка сервера.

• mask_addresses: управляется параметром mask_addresses (по умолчанию: true).
• delay_seconds: числовой эквивалент delay_label (возвращается только в режиме full).