DOCS Developer API

Build on the truth layer.

These are the exact same endpoints that power this site. They read Robinhood Chain mainnet directly — no fixtures, no replayed data. Free-tier keys are not required yet; fair-use rate limits apply per client.

Overview

The SentryHood API exposes on-chain trust intelligence as JSON. The centerpiece is the scan endpoint: one call returns a composite forensic report for any contract — source audit, launch origin, deployer profile, funding trace and holder concentration — the exact pipeline described in the whitepaper.

Protocol: HTTPS, JSON in/out
Auth: None on public tier (API keys land with B2B launch)
Freshness: Live reads, server-side cached ≤60s
Limits: 20 scan requests / minute / client

Quickstart

Scan the live VIRTUAL token contract:

bash

curl "https://sentryhood.io/api/scan?address=0xc6911796042b15d7Fa4F6CDe69e245DdCd3d9c31"

In JavaScript:

const res = await fetch(
  "https://sentryhood.io/api/scan?address=" + contractAddress
);
const report = await res.json();

if (!res.ok) throw new Error(report.message);
console.log(report.verdict, report.score); // "LOW_RISK" 12

GET /api/scan

Runs the full forensic pipeline for one address and returns a composite report.

Parameters

Name	In	Type	Description
address	query	string	EVM address, 0x + 40 hex chars. Contract or EOA.

Response — 200 OK

Field	Type	Description
verdict	string	LOW_RISK · CAUTION · HIGH_RISK
score	number	0–100, sum of finding weights
flags[]	array	Labeled findings with severity & weight
token	object?	Name, symbol, supply, holders, priceUsd
socials	object	Website, twitter, telegram, verifiedSocials

Scoring Model

The score is a transparent sum, clamped to 0–100. Verdict bands: 0–24 low risk, 25–54 caution, 55+ high risk.