Введение
Noytrix API — это слой аналитики крипто-рисков для кошельков, бирж, Telegram-ботов, браузерных расширений, дашбордов и внутренних security-инструментов. Он помогает выявлять скам-ссылки, рискованные wallet-flow, подозрительные контракты, token risks и phishing-паттерны до взаимодействия пользователя с опасной инфраструктурой.
Быстрый старт
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-продукта.
- Сразу меняй скомпрометированные ключи.
- Используй мониторинг использования, чтобы находить неожиданные всплески запросов.