CYCLOPS LABSDOCS / EXPLORERS & WALLETSFILE Nº D7

Show the scan
where people look.

For block explorers, wallets and trading tools on Robinhood Chain. Put the Cyclops scan of a token next to its address, linked to the full scan.

SCRIPT TAG

Drop it
in.

HTML · SCRIPT
<script src="https://cyclopslabs.dev/explorer.js" data-cyclops-address="0x…" async></script>

The script reads the address from data-cyclops-address (or data-address) on its own tag and inserts a linked badge right after it. It makes no requests of its own: the browser loads one SVG image, so there are no CORS rules to set up, no cookies and no tracking.

data-api and data-site override the API and site origins (defaults https://cyclopslabs.dev/api and https://cyclopslabs.dev).

PLAIN IMAGE

No script
at all.

HTML · LINK + IMAGE
<a href="https://cyclopslabs.dev/scan/0x…" target="_blank" rel="noopener">
  <img src="https://cyclopslabs.dev/api/v1/badge/token/0x….svg" alt="Cyclops scan" height="20">
</a>

The badge shows the scan date and score, or “not scanned yet”. It is cached for ten minutes.

JSON

Build your
own.

SHELL · GET /v1/explorer/{address}
curl https://cyclopslabs.dev/api/v1/explorer/0x…
addressThe address you asked about, lowercased.
kindtoken, wallet or unknown: what Cyclops has on record for it.
scannedtrue when a token scan with a score exists.
score0–100 or null. Higher means more of what the scan looks for was observed.
labelThe score band (Low, Moderate, Risky, High) or null.
observationsUp to three short sentences: the top observations behind the score.
scannedAtISO time of the stored scan, or null.
outcomeFor a Torch launch, how it ended (collapsed, dev_dumped, …) or null while still open.
urlThe scan page on Cyclops. Link here.
badgeAbsolute URL of the SVG badge for this address.
wordingThe sentence to show next to the score.

The lookup only reads what is already stored. It never starts a scan, so it is cheap to call on every page view, and it is cached for a minute. To scan an address that has none, send people to url.

WORDING

Scanned,
not rated.

  • Say “Cyclops scan” or “scanned by Cyclops”. Never present a score as safe, verified or trusted.
  • Keep the link. The badge and score always link to the full scan, where every observation is listed.
  • Show the date. A scan describes the chain when it ran. Holders and trades change.