TokenShield

What it answers

TokenShield is the token lane made into a product. Point it at a token, an NFT collection, or a contract and it tells you whether the thing is what it appears to be, and whether the activity around it is honest. It is the read you want before you buy, before you add liquidity, before you list something, or before you show a token to your own users. The contract being verified does not answer this. A clean audit does not answer this. TokenShield answers it from behavior, the part a scam cannot fake just by publishing tidy source. Live UI: trustgated.xyz/token-shield

Three kinds of subject

TokenShield detects what you pasted and picks a path.

Kind	How it is scored	Payment
ERC-20 token	Upstream token oracle (same authority as the widget’s ERC-20 path)	0.001 USDC via x402 when you query the oracle API. The hosted UI handles payment.
NFT (ERC-721 / ERC-1155)	Local scorer from Arcscan data	Free
Other contract	Local scorer (verification, age, interactors, deployer)	Free
Official issuer token	Short-circuits to `VERIFIED`	Free, no oracle hop

The widget is stricter than TokenShield. The widget only scores ERC-20s and returns NTT for NFTs, other contracts, and wallets. TokenShield will actually score those. NFT and generic-contract responses use a string confidence (HIGH / MEDIUM / LOW), not the 0–100 number the wallet oracle returns.

How a result reads

You get the same shape as any TrustGate read, applied to a token. A tier, from BLOCKED up to ELITE / HIGH_ELITE, as the headline. Any flags that apply, in plain language and as codes: honeypot pattern, coordinated buying, synchronized exit, wash trading, low-quality holder base. And a confidence level plus, on batch, a mining or graduated state, so a brand-new token is not dressed up as a settled bet. See tiers, flags, and confidence and states.

Official issuer tokens come back as VERIFIED rather than a behavioral tier. For something like a known stablecoin, the question is not how it trades, it is whether the asset is authentic.On Arc Testnet the allowlist is Circle’s:

Asset	Address
USDC	`0x3600000000000000000000000000000000000000`
EURC	`0x89b50855aa3be2f677cd6303cec089b5f319d72a`
USYC	`0xe9185f0c5f296ed1797aae4238d26ccabeadb86c`
cirBTC	`0xf0c4a4ce82a5746abaad9425360ab04fbba432bf`

What it looks at

Under the hood it weighs the token signals: who holds it and how they got in, how it actually trades, the standing of the wallet that deployed it, how many independent participants are involved, and whether volume is real and recent. It also weighs temporal behavior: hold duration, exit ratio, wash pairs, honeypot-shaped sell-to-buy, and coordinated long-hold exits. A deployer with real, aged, non-self staking can receive a commitment boost. See Signals and Staking.

Where it lives

Arc (EVM)
Sui

TokenShield runs on trustgated.xyz/token-shield. Paste a contract address. It handles standard tokens and detects NFTs and non-token contracts rather than choking on them.APIs:

GET  /api/oracle/token/{address}     ERC-20 and contracts (x402 for tokens)
GET  /api/token-shield/nft/{address} NFT collections, free
GET  /api/widget/score/{address}     ERC-20 only; NTT otherwise
POST /api/batch                      up to 40 addresses, free local path

TokenShield runs on sui.trustgated.xyz/token-shield. Drop in a coin type (0x2::sui::SUI). This path scores Sui mainnet coins from SuiScan and market signals. It is not the Arc oracle.

GET https://sui.trustgated.xyz/api/coin?type=0x2::sui::SUI

A typical official-asset response:

{
  "coinType": "0x2::sui::SUI",
  "score": 100,
  "tier": "VERIFIED",
  "confidence": "HIGH",
  "verified": true,
  "signals": {
    "ageInDays": 1223,
    "holderCount": 27375892,
    "transferCount": 166493319,
    "liquidityUsd": 17902155.26,
    "deployerScore": 5,
    "deployerTier": "LOW",
    "hasVerifiedMetadata": true,
    "isMintable": false,
    "isFrozen": false
  },
  "flags": [],
  "metadata": { "name": "Sui", "symbol": "SUI", "decimals": 9 },
  "scoredAt": "2026-08-17T22:15:02.260Z",
  "nextRescoreAt": "2026-08-20T22:15:02.260Z"
}

Embed with the Sui widget (data-trustgate-coin). Arc widget.js and POST /api/batch do not accept coin types.

Knowledge Graph toggle

On the hosted Token Shield page you can switch from Behavioral (default) to Knowledge Graph. That second lens is Intuition attestation context. It is platform-only and is not in widget, batch, or public API responses. See Knowledge Graph.

Who it is for

Anyone who puts a token in front of a decision. A trader sizing up a new listing. A DEX or aggregator that wants to warn users before a risky swap. A launchpad that wants to show standing next to each token. A wallet that wants to flag what it is about to let someone hold.

Put it in your product

Drop in the badge

Render a live TokenShield badge on any ERC-20 in your UI with one script tag.

Score a list

Batch-score a feed and optionally reorder it.

Consume the score

Read the tier and flags as data and present them however you like.

API reference

Exact paths and response shapes.

Get Started

How Scoring Works

Products

Networks

What it answers

Three kinds of subject

How a result reads

What it looks at

Where it lives

Knowledge Graph toggle

Who it is for

Put it in your product

Drop in the badge

Score a list

Consume the score

API reference

​What it answers

​Three kinds of subject

​How a result reads

​What it looks at

​Where it lives

​Knowledge Graph toggle

​Who it is for

​Put it in your product

Drop in the badge

Score a list

Consume the score

API reference

What it answers

Three kinds of subject

How a result reads

What it looks at

Where it lives

Knowledge Graph toggle

Who it is for

Put it in your product