Публічний API v1

Отримуйте дані Vartovii Trust Score програмно через наш Публічний API.

Огляд

Публічний API надає доступ до даних Trust Score як для компаній, так і для криптопроєктів з обмеженням швидкості запитів.

План	Обмеження швидкості	Можливості
Безкоштовний	10 запитів/день	Базові дані Trust Score
Pro	Безлімітний	Повні дані + Історичні (Незабаром)

Базовий URL

https://sentryanalytic.com/api/v1

Аутентифікація

Наразі безкоштовний рівень не вимагає аутентифікації. Аутентифікація за допомогою API ключа для рівня Pro буде доступна незабаром.

Кінцеві точки

Отримати Trust Score компанії

GET /api/v1/trust-score/{company}

Параметри:

• company (string): Назва компанії для пошуку

Відповідь:

{
  "company": "Google",
  "trust_score": 85,
  "risk_level": "LOW",
  "total_reviews": 15234,
  "last_updated": "2026-01-18T10:30:00Z",
  "api_version": "v1"
}

Отримати Trust Score криптопроєкту

GET /api/v1/crypto/{slug}

Параметри:

• slug (string): slug проєкту, сумісний з CoinGecko

Відповідь:

{
  "name": "Bitcoin",
  "symbol": "BTC",
  "slug": "bitcoin",
  "trust_score": 92,
  "risk_level": "LOW",
  "price_usd": 98500.5,
  "market_cap": 1950000000000,
  "commits_last_30d": 145,
  "active_devs": 28,
  "api_version": "v1"
}

Пошук сутностей

GET /api/v1/search?q={query}&type={type}

Параметри:

• q (string, required): Пошуковий запит (мін. 2 символи)
• type (string, optional): all | crypto | company (за замовчуванням: all)

Відповідь:

{
  "query": "google",
  "count": 3,
  "results": [
    {
      "type": "company",
      "name": "Google",
      "trust_score": 85,
      "risk_level": "LOW"
    },
    {
      "type": "crypto",
      "name": "Golem",
      "symbol": "GLM",
      "trust_score": 68,
      "risk_level": "MEDIUM"
    }
  ],
  "api_version": "v1"
}

Стан API

GET /api/v1/health

Повертає стан API та документацію.

Обмеження швидкості запитів

При перевищенні ліміту швидкості запитів ви отримаєте:

HTTP/1.1 429 Too Many Requests

{
  "detail": "Rate limit exceeded: 10 per 1 day"
}

Відповіді з помилками

Статус	Опис
200	Успіх
404	Сутність не знайдено
429	Перевищено ліміт швидкості запитів
500	Помилка сервера

Приклад використання

cURL

curl https://sentryanalytic.com/api/v1/crypto/bitcoin

Python

import requests

response = requests.get(
    "https://sentryanalytic.com/api/v1/trust-score/google"
)
data = response.json()
print(f"Trust Score: {data['trust_score']}/100")

JavaScript

const response = await fetch(
  "https://sentryanalytic.com/api/v1/crypto/ethereum",
);
const data = await response.json();
console.log(`Risk Level: ${data.risk_level}`);

Незабаром

• API Keys: Персональні API ключі для вищих лімітів швидкості запитів
• Webhooks: Сповіщення в реальному часі про зміни оцінок
• Historical Data: Доступ до історії Trust Score
• Bulk Queries: Кілька сутностей в одному запиті