📋 Базовые понятия

Запросы к серверу осуществляются по протоколу HTTPS, используя методы GET и POST. Полезная нагрузка в запросах передается:

• Как часть пути запроса для простых GET запросов
• В формате JSON для POST запросов

Хост для API запросов

https://api.payscrow-cascade.io

Во всех запросах должны присутствовать следующие заголовки:

Заголовок	Значение	Описание
Content-Type	application/json	Формат данных запроса
X-API-Key	API-KEY	Ключ API, например be2f7293-3921-4300-85be-7c83adbb2c15

Ограничения на количество запросов

Максимальное число запросов с одного IP адреса - 15 запросов в секунду. При превышении лимита числа запросов будет возвращаться код 429, Too Many Requests.

Формат даты и времени

Все значения даты и времени в запросах и ответах передаются со стандартом UTC в следующем формате - "ГГГГ-ММ-ДД ЧЧ:ММ:СС".

Пример - "2024-01-01 00:00:00"

Опциональные поля

Если значение поля равно null, это поле можно не указывать в запросе.

📅 Фильтры диапазона даты и времени

• Максимальный диапазон: 90 дней
• Максимальная давность данных: 365 дней
• Обязательное условие: при указании start_date обязательно указывать end_date и наоборот
• Если оба поля null: возвращаются данные за последние 24 часа
• При несоблюдении условий: возвращается ошибка валидации (код 422)

HTTP Коды ответов

Успешные ответы:

• 200 - Запрос прошел успешно
• 201 - Запрос прошел успешно, был создан ресурс, возвращенный в теле ответа

Ошибки клиента:

• 400 - Ошибка валидации / некорректный запрос
• 401 - Неверный / отсутствующий API ключ
• 402 - Недостаточный баланс для осуществления Sell ордера
• 403 - Операция не авторизована
• 422 - Ошибка валидации входных данных
• 429 - Лимит запросов / блокировка антифродом

Серверные ошибки:

• 500 - Нет трейдеров / внутренняя ошибка сервера

Особенности кода 422

В случае кода 422, поле message содержит детальное объяснение причин, по которым запрос не может быть выполнен, несмотря на корректный синтаксис.