Documentation

Embeddable Risk Badge

Show a live rug pull risk score anywhere — GitHub READMEs, websites, project pages, or documentation.

Preview

Live badge (DAI on Ethereum):

ChainRaven risk score badge preview

Updates automatically every 5 minutes. Links to the full token report.

Quick Start

Replace TOKEN_ADDRESS with your token's contract address and CHAIN with the network name.

HTMLhtml
<a href="https://www.chainraven.com/token/TOKEN_ADDRESS?chain=CHAIN">
  <img
    src="https://www.chainraven.com/api/scanner/badge/TOKEN_ADDRESS?chain=CHAIN"
    alt="ChainRaven Risk Score"
    width="340"
    height="100"
  />
</a>
Markdown (GitHub README)markdown
[![ChainRaven Risk Score](https://www.chainraven.com/api/scanner/badge/TOKEN_ADDRESS?chain=CHAIN)](https://www.chainraven.com/token/TOKEN_ADDRESS?chain=CHAIN)
React / JSXjsx
<a href="https://www.chainraven.com/token/TOKEN_ADDRESS?chain=CHAIN">
  <img
    src="https://www.chainraven.com/api/scanner/badge/TOKEN_ADDRESS?chain=CHAIN"
    alt="ChainRaven Risk Score"
    width={340}
    height={100}
  />
</a>

Supported Chains

Chainchain= value
Ethereumethereum
Basebase
Polygonpolygon
Arbitrumarbitrum
Optimismoptimism
Solanasolana

Default chain is ethereum if the parameter is omitted.

How It Works

  • 1The badge is a live SVG image served from ChainRaven's CDN.
  • 2It shows the latest risk score, risk level, and top detected signals for the token.
  • 3The badge is cached for 5 minutes and automatically reflects any updated scan results.
  • 4Clicking the badge links to the full token risk report on ChainRaven.
  • 5CORS headers are set to * — the badge can be embedded anywhere.
  • 6If the token hasn't been scanned yet, the badge will display "NOT SCANNED". Scan it first at /scanner.

Ready to scan your token?

Scan any ERC-20 or Solana token in seconds. Free, no account required.

Scan a Token →