HostHostDeFi › Features › Safety Badge
A safety badge your readers can check, not just trust
The HostDeFi Safety Badge embeds a token's graded on-chain risk score — A+ through F — on your own page, as a shields-style SVG, a compact card, or raw JSON. Free, keyless, and honest when a token hasn't been graded.
Most token pages ask for trust the same way: a logo wall and a promise. The badge inverts that — it shows the token's stored HostDeFi grade, computed openly from on-chain data, and the whole thing is a link: one click takes a reader to the full risk read behind the letter, where they can verify the authority flags, the liquidity depth and the holder shape themselves. A badge that can't be checked is decoration; this one is a citation.
Three ways to embed it
The badge builder at /integrate writes the snippet for you — paste a contract address, copy the markup, done. Underneath, every format is the same data at a different weight:
| Format | What it is | Where it fits |
|---|---|---|
| SVG shield | A 141×20 shields-style image — the letter grade and score. One <img> tag, zero JavaScript. | READMEs, forum posts, doc sites, anywhere an image loads. |
| Card (iframe) | A 420×72 strip: grade, mint/freeze authority flags and liquidity figure, all linked to the report. | Token pages and dashboards that want the evidence inline, not just the letter. |
| JSON | /api/token/<chain>/<address>.json — the grade, score and underlying fields, keyless and CORS-open. | Your own UI — render the grade however your design needs it. |
<a href="https://hostdefi.com/t/solana/<MINT>?via=badge">
<img src="https://hostdefi.com/api/badge/solana/<MINT>.svg"
alt="HostDeFi safety grade" height="20">
</a>What the grade actually is
The badge does not re-scan a contract on every page view — it serves the token's stored grade out of the graded corpus, recomputed on the weekly data run. That corpus grade is deterministic: mint and freeze authority posture, liquidity depth read against the token's own market cap, holder base and creator-wallet stake, scored on the open methodology ladder from A+ down to F. Because it's a stored snapshot, the badge is also honest about its limits — a token that isn't in the corpus gets a "not graded" shield, never a charitable guess.
Chains covered today: Solana, Ethereum, Base, BNB Chain, Arbitrum and Monad — the same set the scanner grades. On Solana the click-through URL can drop the chain segment (/t/<mint>); every other chain keeps it.
Who embeds it, and why it works
- Token teams — a graded shield on your docs or landing page answers "is this legit?" with data instead of adjectives, and the click-through is the whole audit trail. Teams that earned a good grade are exactly the ones who want it checked.
- Blogs, dashboards and listing pages — every token you mention carries its score inline, so a reader can spot the F before they ape. The badge does the warning work your article can't.
- Tooling and bots — the JSON endpoint is the same grade for your own renderer; the free API covers live scans when you need more than the stored snapshot.
Attribution is honest by construction: the ?via=badge marker on the click-through counts badge traffic as badge traffic — it never fakes a referral, and there are no cookies or trackers riding the image. Privacy for the reader, a clean number for you.
The rules, all three of them
- Free for any site, commercial or not.
- Don't alter the badge to imply a rating the corpus didn't give — the whole value is that it can't be bought or edited.
- A grade is an on-chain risk read, not financial advice and not a promise about price.
The honest limit: a badge shows the stored grade as of its last weekly refresh — a dated snapshot, not a live audit. Contract state can change between runs, so a badge tells your readers what the data said, and the scanner tells them what it says now. Both matter; the badge links straight through to the second.
Putting a badge on a token?
Scan it first — the badge prints whatever the data says. Know the grade before you display it.
Frequently asked
Which chains does the badge cover?
Solana, Ethereum, Base, BNB Chain, Arbitrum and Monad — every chain the graded corpus covers. A token that isn't in the corpus renders an honest "not graded" shield rather than an invented score.
Does the badge need an API key or JavaScript?
Neither. The SVG shield is a plain img tag — it renders in READMEs, forums and anywhere images are allowed. The iframe card and the JSON endpoint are equally keyless; the API is CORS-open by design.
How fresh is the grade a badge shows?
The badge serves the token's stored grade — a snapshot recomputed on the weekly data run, not a live re-scan of the contract that second. The click-through page carries the same snapshot with its as-of date, and the free scanner is one tap away for a fresh read.
Can I pick which grade it shows?
No — and that is the point. The badge renders whatever the corpus graded that token, A+ or F. The usage rules exist to keep it that way: don't alter the badge to imply a rating the data didn't produce.
Does the badge track my visitors?
No trackers, no cookies, no per-reader fingerprinting. The only counters are aggregate serve/click counts (the via parameter on the link tells a badge click from any other visit) — your readers stay anonymous.
What does it cost?
Nothing — free for any site, commercial or not, with no request cap that a normal page would ever hit. If you need the grade inside your own UI rather than our pixels, the JSON endpoint is the same price: free.