Consume the score

When to use this

Reach for this when the badge is not enough, when you want the read as data and full control over what happens next. Your own badge design. Your own warning copy. Your own rule for what a given tier means in your product.

Which endpoint

You have	Call	Cost
One ERC-20, want a compact badge payload	`GET /api/widget/score/{address}`	Free
Up to 40 tokens, a feed	`POST /api/batch`	Free
One wallet, authoritative	`GET /api/oracle/{address}`	0.001 USDC, x402
One ERC-20, authoritative	`GET /api/oracle/token/{address}`	0.001 USDC, x402
One NFT collection	`GET /api/token-shield/nft/{address}`	Free
A signed, expiring proof	`POST /api/gating/attest`	Free

Base (Arc): https://www.trustgated.xyz. Open CORS on widget, batch, and oracle. Sui coin read (mainnet coin types):

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

Sui wallet rescore trigger (testnet):

POST https://sui.trustgated.xyz/api/score-wallet
{ "address": "0x…" }

GET /api/widget/score/0xTOKEN
Auth    none
Limit   8 req/min/IP (default)

{ "score": 78, "tier": "HIGH", "contractType": "ERC-20" }

Special cases:

{ "score": null, "tier": "VERIFIED", "label": "VERIFIED" }

{ "score": null, "tier": "NTT", "label": "NTT" }

Errors: 400 invalid_address, 429 rate_limited, 502 detection_failed / scoring_unavailable.

Batch score (discovery)

POST /api/batch
Content-Type: application/json
Auth    none
Limit   30 req/min/IP, max 40 addresses

{ "addresses": ["0xabc…", "0xdef…"] }

Response is a JSON array (not { results: [...] }):

[
  {
    "address": "0xabc…",
    "score": 71,
    "tier": "HIGH",
    "confidence": 82,
    "flags": ["COORDINATED_BUY"],
    "state": "graduated"
  }
]

tier is BLOCKED | LOW | MEDIUM | HIGH | ELITE | VERIFIED. An error field marks addresses that are not tokens. Official issuers come back as VERIFIED with score: 100 here — the widget path returns score: null for the same assets. See Optional reorder for ranking. Errors: 400 invalid_json | addresses_required | too_many_addresses | invalid_addresses, 429 rate_limited, 502 batch_failed.

Oracle (wallet)

GET /api/oracle/{wallet}

Unpaid: 402 with payment details. Paid replay: X-Payment header. Hardened 200 body (breakdown stripped):

{
  "address": "0x60C05e2d820CE989E944ED4e7bb33bAEB8705c62",
  "score": 57,
  "tier": "MEDIUM",
  "recommendation": "TIME_LOCKED",
  "confidence": 70,
  "flags": [],
  "summary": "…",
  "publicExplain": {},
  "protocolExplain": {},
  "scoreStability": "stable",
  "directionDrivers": [],
  "snapshotId": "snap_…",
  "scoringVersion": "v1.0",
  "queriedAt": "2026-08-15T10:42:13.094Z",
  "network": "arc-testnet"
}

Contract addresses on the unpaid challenge return 400 with code: "CONTRACT_NOT_WALLET". Full payment dance: Oracle.

Using the read

Map the tier to whatever your product shows — a color, a label, a gate. Use the numeric score where you want finer-grained display. Use flags as the reason line. Use confidence as a “how loud is this” slider. Pin scoringVersion if you gate. Top tiers may come back without a useful number. NTT is not a trust tier. HIGH_ELITE and ELITE are the same top behavioral tier.

This is still the non-invasive model. You are pulling a signal and deciding everything downstream. TrustGate has no opinion about how your product uses it.

Oracle payment flow

x402 challenge, settle, replay.

Full API reference

Every path, including gating and Guard.

Start Here

Guides

Reference

When to use this

Which endpoint

Widget score (single ERC-20)

Batch score (discovery)

Oracle (wallet)

Using the read

Next

Oracle payment flow

Full API reference

​When to use this

​Which endpoint

​Widget score (single ERC-20)

​Batch score (discovery)

​Oracle (wallet)

​Using the read

​Next

Oracle payment flow

Full API reference

When to use this

Which endpoint

Widget score (single ERC-20)

Batch score (discovery)

Oracle (wallet)

Using the read

Next