История курсов

Получение истории всех зафиксированных курсов

GET /api/v1/rates/history

cURL

curl -X GET "https://loveandpay.io/api/v1/rates/history?base=USDT&quote=RUB&limit=10" \
  -H "X-Api-Key: lc_ваш_ключ"

200

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "baseCurrency": "USDT",
      "quoteCurrency": "RUB",
      "rate": 92.50,
      "validFrom": "2026-01-25T00:00:00.000Z",
      "validTo": null,
      "isActive": true,
      "notes": "Фиксация на январь 2026",
      "fixedAt": "2026-01-25T10:30:00.000Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "baseCurrency": "USDT",
      "quoteCurrency": "RUB",
      "rate": 91.00,
      "validFrom": "2026-01-20T00:00:00.000Z",
      "validTo": "2026-01-25T00:00:00.000Z",
      "isActive": false,
      "notes": null,
      "fixedAt": "2026-01-20T09:00:00.000Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "baseCurrency": "USDT",
      "quoteCurrency": "RUB",
      "rate": 90.25,
      "validFrom": "2026-01-15T00:00:00.000Z",
      "validTo": "2026-01-20T00:00:00.000Z",
      "isActive": false,
      "notes": "Корректировка курса",
      "fixedAt": "2026-01-15T08:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 15,
    "limit": 10,
    "offset": 0,
    "pages": 2
  },
  "requestId": "req_xyz789"
}

Возвращает историю всех зафиксированных курсов с пагинацией.

Заголовки

X-Api-Key · string · required

Ваш API ключ

Query параметры

base · string · default: "USDT"

Базовая валюта

quote · string · default: "RUB"

Котируемая валюта

limit · number · default: "30"

Количество записей (максимум 100)

offset · number · default: "0"

Смещение для пагинации

200

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "baseCurrency": "USDT",
      "quoteCurrency": "RUB",
      "rate": 92.50,
      "validFrom": "2026-01-25T00:00:00.000Z",
      "validTo": null,
      "isActive": true,
      "notes": "Фиксация на январь 2026",
      "fixedAt": "2026-01-25T10:30:00.000Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "baseCurrency": "USDT",
      "quoteCurrency": "RUB",
      "rate": 91.00,
      "validFrom": "2026-01-20T00:00:00.000Z",
      "validTo": "2026-01-25T00:00:00.000Z",
      "isActive": false,
      "notes": null,
      "fixedAt": "2026-01-20T09:00:00.000Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "baseCurrency": "USDT",
      "quoteCurrency": "RUB",
      "rate": 90.25,
      "validFrom": "2026-01-15T00:00:00.000Z",
      "validTo": "2026-01-20T00:00:00.000Z",
      "isActive": false,
      "notes": "Корректировка курса",
      "fixedAt": "2026-01-15T08:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 15,
    "limit": 10,
    "offset": 0,
    "pages": 2
  },
  "requestId": "req_xyz789"
}

cURL

curl -X GET "https://loveandpay.io/api/v1/rates/history?base=USDT&quote=RUB&limit=10" \
  -H "X-Api-Key: lc_ваш_ключ"

---

Описание полей

Поле	Описание
id	UUID записи курса
baseCurrency	Базовая валюта
quoteCurrency	Котируемая валюта
rate	Значение курса
validFrom	Начало действия курса
validTo	Окончание действия (null = бессрочно)
isActive	Текущий активный курс
notes	Заметки к фиксации
fixedAt	Дата/время фиксации

---

API v2 (с HMAC-подписью)

Для повышенной безопасности используйте API v2 с HMAC-подписью.

Дополнительные заголовки

Заголовок	Описание
X-Api-Key	Ваш API ключ
X-Timestamp	Unix timestamp в миллисекундах
X-Signature	HMAC-SHA256 подпись

Пример с HMAC

const crypto = require('crypto');

function generateSignature(secretKey, method, path, timestamp, body = '') {
  const bodyHash = body
    ? crypto.createHash('sha256').update(body).digest('hex')
    : '';

  const message = `${method}${path}${timestamp}${bodyHash}`;

  return crypto
    .createHmac('sha256', secretKey)
    .update(message)
    .digest('hex');
}

// Использование
const timestamp = Date.now().toString();
const signature = generateSignature(
  'ваш_hmac_secret',
  'GET',
  '/api/v2/rates',
  timestamp
);

const response = await fetch('https://loveandpay.io/api/v2/rates?base=USDT&quote=RUB', {
  headers: {
    'X-Api-Key': 'lc_ваш_ключ',
    'X-Timestamp': timestamp,
    'X-Signature': signature
  }
});

cURL с HMAC

TIMESTAMP=$(date +%s000)
SIGNATURE=$(echo -n "GET/api/v2/rates${TIMESTAMP}" | openssl dgst -sha256 -hmac "ваш_hmac_secret" | cut -d' ' -f2)

curl -X GET "https://loveandpay.io/api/v2/rates?base=USDT&quote=RUB" \
  -H "X-Api-Key: lc_ваш_ключ" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Signature: ${SIGNATURE}"