Vartovii Public API v1

Welcome to the Vartovii Intelligence API. Use our API to integrate Trust Scores, Crypto Forensics, and Employer Reputation data directly into your applications.

Base URL

https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1

Authentication

Currently, the API is in Public Beta.

• Free Tier: No API Key required. Limited to 10 requests per day per IP.
• Pro Tier: API Key required (Coming Soon). Unlimited requests.

Endpoints

1. Check Service Health

Verify API availability and get endpoint information.

GET /api/v1/health

Response:

{
  "status": "healthy",
  "api_version": "v1",
  "rate_limits": {
    "free_tier": "10 requests/day",
    "pro_tier": "Unlimited (coming soon)"
  },
  "endpoints": [
    "/api/v1/trust-score/{company}",
    "/api/v1/crypto/{slug}",
    "/api/v1/search"
  ]
}

---

2. Get Company Trust Score

Get aggregated reputation data and Trust Score for any company.

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

Parameters:

• company: Name or slug of the company (e.g., "google", "bmw", "microsoft")

Example Request:

curl https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/trust-score/bmw

Response:

{
  "company": "BMW",
  "trust_score": 37.1,
  "risk_level": "CRITICAL",
  "total_reviews": 5621,
  "avg_rating": 3.97,
  "last_updated": "2026-01-28T20:37:52.865897",
  "api_version": "v1"
}

Risk Levels:

• LOW - Trust Score ≥ 70
• MEDIUM - Trust Score 50-69
• HIGH - Trust Score 40-49
• CRITICAL - Trust Score < 40

---

3. Crypto Project Analysis

Get comprehensive Trust Score and metrics for crypto projects.

GET /api/v1/crypto/{slug}

Parameters:

• slug: Token symbol or slug (e.g., "bitcoin", "ethereum", "solana")

Example Request:

curl https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/crypto/bitcoin

Response:

{
  "name": "Bitcoin",
  "symbol": "BTC",
  "slug": "bitcoin",
  "trust_score": 87.0,
  "risk_level": "LOW",
  "price_usd": 89141.0,
  "market_cap": 1781914953851.0,
  "fdv": 1781916648348.0,
  "commits_last_30d": 500.0,
  "active_devs": 52.0,
  "last_updated": "2026-01-24T21:17:52.270273",
  "api_version": "v1"
}

---

4. Search

Unified search across companies and crypto projects.

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

Parameters:

• q (required): Search query (minimum 2 characters)
• type (optional): Filter by type - all, crypto, or company (default: all)

Example Request:

# Search all entities
curl "https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/search?q=google"

# Search only crypto projects
curl "https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/search?q=bit&type=crypto"

Response:

{
  "query": "google",
  "count": 1,
  "results": [
    {
      "type": "company",
      "name": "Google",
      "trust_score": 76.5,
      "risk_level": "MEDIUM"
    }
  ],
  "api_version": "v1"
}

---

Rate Limiting

Tier	Limit	HTTP Header
Free (Public Beta)	10 requests / day / IP	X-RateLimit-Limit: 10
Pro (Coming Soon)	Unlimited	API Key required

Rate Limit Headers:

• X-RateLimit-Limit - Maximum requests allowed
• X-RateLimit-Remaining - Requests remaining in current window
• X-RateLimit-Reset - Time when limit resets (Unix timestamp)

Error Response (429):

{
  "error": "Rate limit exceeded",
  "message": "10 per 1 day"
}

---

Error Codes

Code	Description
200	Success
404	Entity not found
429	Rate limit exceeded
500	Internal server error

---

Support

For higher rate limits or Pro tier access, contact:

• Email: support@sentryanalytic.com
• Documentation: https://vartovii.cloud/docs

---

Last Updated: January 28, 2026