Вступ
Noytrix API — це шар аналітики крипто-ризиків для гаманців, бірж, Telegram-ботів, браузерних розширень, дашбордів і внутрішніх security-інструментів. Він допомагає виявляти скам-посилання, ризикові потоки гаманців, підозрілі контракти, ризики токенів і фішинг-патерни до взаємодії користувача з небезпечною інфраструктурою.
Швидкий старт
curl -X POST https://api.noytrixapp.com/v1/scan \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{"input":"https://example.com","lang":"en"}'
Авторизація
Кожен запит має містити приватний API ключ. Ніколи не показуй цей ключ у frontend-коді.
x-api-key: YOUR_API_KEY
або
Authorization: Bearer YOUR_API_KEY
Ендпоінти
GET /v1/me
POST /v1/scan
/v1/me перевіряє статус ключа, тариф і використання. /v1/scan перевіряє URL, домени, гаманці, контракти, токени й текст.
Схема запиту
{
"input": "https://example.com",
"lang": "en"
}
- input — URL, домен, гаманець, контракт, токен, тікер, текст або transaction data.
- lang — мова відповіді: en, ru або uk.
Схема відповіді
{
"ok": true,
"kind": "url",
"score": 30,
"level": "suspicious",
"verdict_en": "Suspicious",
"sources": [],
"evidence": [],
"what_can_happen": "The interaction may be risky.",
"worst_case": "A malicious flow may lead to fund loss.",
"api": {
"version": "v1",
"plan": "starter",
"usage": {
"month": "2026-05",
"used": 1,
"limit": 10000,
"left": 9999
}
}
}
Verdict levels
- safe — сильний ризик не виявлено.
- suspicious — є попереджувальні сигнали.
- danger — виявлено високоризикову поведінку.
- critical — підтверджений або серйозний скам-ризик.
Source statuses
- clean — джерело не виявило ризик.
- malicious — джерело підтвердило небезпеку.
- no_data — фінальний результат недоступний.
- invalid_key — ключ провайдера не налаштований.
- timeout — джерело не відповіло вчасно.
- error — джерело повернуло помилку.
Коди помилок
{
"ok": false,
"error": "invalid_api_key",
"message": "Invalid API key."
}
- missing_api_key — заголовок API ключа відсутній.
- invalid_api_key — ключ не існує.
- api_key_inactive — ключ відключено.
- api_key_expired — строк дії ключа минув.
- monthly_limit_exceeded — місячний ліміт вичерпано.
- rate_limit_exceeded — занадто багато запитів за хвилину.
- missing_input — у тілі запиту немає input.
Ліміти запитів
Starter: 10 000 запитів / місяць · 60 запитів / хвилину
Growth: 100 000 запитів / місяць · 180 запитів / хвилину
Scale: 500 000 запитів / місяць · 600 запитів / хвилину
Кожна успішна відповідь містить поточне використання всередині api.usage.
SDK приклади
// JavaScript
const res = await fetch("https://api.noytrixapp.com/v1/scan", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-api-key": process.env.NOYTRIX_API_KEY
},
body: JSON.stringify({ input: "https://example.com", lang: "en" })
});
const data = await res.json();
# Python
import os, requests
res = requests.post(
"https://api.noytrixapp.com/v1/scan",
headers={"x-api-key": os.getenv("NOYTRIX_API_KEY")},
json={"input": "https://example.com", "lang": "en"}
)
data = res.json()
Найкращі практики безпеки
- Зберігай API ключі тільки на backend або в серверному середовищі.
- Не розкривай API ключі в браузерних застосунках, мобільних збірках або публічних репозиторіях.
- Використовуй власний backend як proxy, якщо потрібно викликати Noytrix із frontend-продукту.
- Одразу змінюй скомпрометовані ключі.
- Використовуй моніторинг використання, щоб знаходити неочікувані сплески запитів.