Verified by Signet badge
GET/api/v1/badge/{handle}.svg
A self-contained SVG badge for a README or portfolio. verified: the handle is bound on this deployment's network, with how many contracts its wallets deployed (N+ when the count is a lower bound); with ?contract=, only when that contract's attribution check passes. not-verified: the handle is bound but did not deploy ?contract=. not-found: no such handle. unavailable: Signet could not check (grey). Always 200 image/svg+xml so an embed never breaks; the state is in X-Signet-Badge-State. A verified badge means the handle is bound in the registry; it does not vouch for contract quality.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| handle | path | string | Handle (case-insensitive). An invalid handle renders not-found. |
| style? | query | "flat" | "plain" | flat (colour by state, the default) or plain (one colour family). |
| contract? | query | string | A C... contract ID: the badge shows it as deployed only when the handle deployed it. |
Example request
curl -s "https://signet-web-pearl.vercel.app/api/v1/badge/alice.svg"@signet/sdk has no method for this endpoint; use the URL directly.
Responses
200 · The badge, in every state.
Body: image/svg+xml
Headers: Cache-Control, ETag, X-Signet-Badge-State