Разработка автоматической конвертации крипто в фиат

Разработка автоматической конвертации крипты в фиат

Задача звучит просто: получил крипту — конвертировал в фиат — вывел на банковский счёт. На практике это цепочка из минимум трёх систем с разными API, задержками, лимитами и точками отказа. Большинство проблем возникает не в блокчейн-части, а на стыке с фиатными рельсами.

Архитектура пайплайна конвертации

Полный пайплайн выглядит так:

On-chain получение → Детектирование → Hot wallet сбор
→ Биржа/OTC API → Продажа в USDT/USD
→ Fiat off-ramp → Банковский перевод

Каждый переход — потенциальная точка задержки. Временно́й диапазон от on-chain подтверждения до денег на банковском счёте: 15 минут–24 часа в зависимости от выбранного стека.

Биржевые интеграции для конвертации

CEX API (Binance, Kraken, Coinbase Prime)

Самый быстрый путь — продажа через спотовый рынок биржи. Биржи дают программный доступ:

import Binance from "node-binance-api";

const binance = new Binance().options({
  APIKEY: process.env.BINANCE_API_KEY,
  APISECRET: process.env.BINANCE_API_SECRET,
});

async function convertToUSDT(symbol: string, amount: number): Promise<string> {
  // Получить текущую цену
  const ticker = await binance.prices(`${symbol}USDT`);
  const price = parseFloat(ticker[`${symbol}USDT`]);

  // Рыночный ордер — исполняется мгновенно, но slippage
  const order = await binance.marketSell(`${symbol}USDT`, amount);
  return order.orderId;
}

Проблема с рыночными ордерами: slippage на крупных суммах. Для конвертации > $10k лучше TWAP (Time-Weighted Average Price) или лимитные ордера:

async function twapConvert(
  symbol: string,
  totalAmount: number,
  parts: number,
  intervalMs: number
) {
  const partAmount = totalAmount / parts;

  for (let i = 0; i < parts; i++) {
    await binance.marketSell(`${symbol}USDT`, partAmount);
    if (i < parts - 1) await sleep(intervalMs);
  }
}

Fiat off-ramp провайдеры

После получения USDT/USD на бирже нужно вывести в фиат. Основные варианты:

Для EU-ориентированных проектов SEPA-переводы через Kraken или BCB Group — стандартный путь. Для CIS-рынка выбор значительно уже.

Управление курсовым риском

Между получением крипты и фиатным выводом есть временной зазор, во время которого курс может меняться. Стратегии mitigation:

Немедленная стабилизация в USDT/USDC — сразу после on-chain подтверждения конвертируем в стейблкоин. Убираем волатильность ETH/BTC, остаётся только depeg риск стейблкоина.

Хеджирование через фьючерсы — для крупных сумм (>$50k) открываем short на фьючерсном рынке той же биржи одновременно с получением крипты. Нейтрализует курсовой риск до фиатного вывода.

Accept-at-rate модель — фиксируем курс на момент создания инвойса (с коротким TTL, например 15 минут), принимаем оплату в этот период. Если клиент платит позже — пересчитываем.

interface Invoice {
  id: string;
  cryptoAmount: bigint;
  fiatAmount: number;
  lockedRate: number;
  expiresAt: Date; // now + 15 min
  status: "pending" | "paid" | "expired" | "converting" | "settled";
}

Обработка ошибок и edge cases

Biржевой downtime: биржи уходят на maintenance. Нужен fallback на альтернативную биржу или временная пауза с queue накоплением.

Частичное исполнение ордера: для неликвидных пар ордер может исполниться частично. Воркер должен отслеживать pending ордера и додавать остаток.

Задержка банковского перевода: SWIFT/SEPA — не real-time. Внутренний статус awaiting_bank_settlement с таймаутом и алертом если деньги не пришли через N дней.

KYC/AML проверки: биржи могут заморозить вывод при подозрительной активности. Мониторинг статуса withdrawal, алерты на pending > 24h.

Стек и инфраструктура

• Воркеры: Node.js с BullMQ для очередей (retry logic, delayed jobs, priority queues)
• База данных: PostgreSQL с immutable ledger таблицей всех конвертаций
• Secrets: приватные ключи биржевых API в AWS KMS или HashiCorp Vault
• Мониторинг: Grafana с алертами на Failed conversions rate, биржевой баланс, время settlement
• Reconciliation: ежедневная сверка сумм между on-chain подтверждениями и фиатными выводами

Срок разработки: 1–2 недели. Меньше занимает сам код, больше — интеграция с конкретными биржевыми API и fiat-провайдерами, получение API-доступа у них, тестирование end-to-end с реальными транзакциями.