Інтеграція з Changelly API

Інтеграція з Changelly API

Changelly — агрегатор обмінників криптовалют. Інтеграція дозволяє встроїти миттєвий обмін криптовалют у своє додаток без необхідності тримати ліквідність. Changelly сам роутить угоди через партнерські біржи.

Підключення до API

Changelly надає REST API v2 з API-key аутентифікацією. Базовий URL: https://api.changelly.com/v2.

import crypto from 'crypto';

class ChangellyClient {
  private apiKey: string;
  private apiSecret: string;
  
  constructor(apiKey: string, apiSecret: string) {
    this.apiKey = apiKey;
    this.apiSecret = apiSecret;
  }
  
  private signRequest(body: object): string {
    const message = JSON.stringify(body);
    return crypto.createHmac('sha512', this.apiSecret).update(message).digest('hex');
  }
  
  async getExchangeAmount(from: string, to: string, amount: string) {
    const body = {
      jsonrpc: '2.0',
      id: Date.now().toString(),
      method: 'getExchangeAmount',
      params: { from, to, amount },
    };
    
    const response = await fetch('https://api.changelly.com/v2', {
      method: 'POST',
      headers: {
        'api-key': this.apiKey,
        'sign': this.signRequest(body),
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(body),
    });
    
    return response.json();
  }
}

Основні виклики API

// Отримання мінімальної суми для обміну
const minAmount = await changelly.request('getMinAmount', { from: 'btc', to: 'eth' });

// Отримання курсу обміну
const rate = await changelly.request('getExchangeAmount', {
  from: 'btc', to: 'eth', amount: '0.1'
});

// Створення транзакції обміну
const transaction = await changelly.request('createTransaction', {
  from: 'btc',
  to: 'eth',
  amount: '0.1',
  address: userEthAddress,  // адреса отримання
  refundAddress: userBtcAddress,  // адреса повернення при помилці
});

// Відстеження статусу
const status = await changelly.request('getTransactions', {
  id: transaction.result.id
});

Workflow обміну

1. Отримати курс → показати користувачу
2. Користувач підтверджує → createTransaction → отримуємо депозитний адрес
3. Користувач відправляє криптовалюту на депозитний адрес
4. Polling статусу кожні 30–60 сек: waiting → confirming → exchanging → sending → finished
5. При failed — показуємо інформацію про повернення

Інтеграція Changelly API у існуючому додаток: 1 тиждень включаючи UI для вибору пар та відображення статусу.