Optional reorder

The idea

This is the discovery path made hands-on. You hand TrustGate a list, you get a read per item, and then you decide how far to take it. The default is to show trust without touching your order. Reordering is a separate, deliberate step you opt into.

Score the list

POST /api/batch with up to 40 addresses. Free. Open CORS. No x402.

Badge and flag, in your order

The default and least invasive move. Render a trust badge and any flags next to each item, in the exact order your feed already has.

Reorder, only if you choose

Optional and explicit. Pass the scored list to reorderByTrust, or set data-trustgate-reorder="on" on the discovery script.

Reordering is never automatic. TrustGate will not rearrange your feed on its own. The helper hands you a reordered list and stops there. Applying it is your call, every time.

Live batch endpoint

POST https://www.trustgated.xyz/api/batch
Content-Type: application/json

curl -X POST https://www.trustgated.xyz/api/batch \
  -H "Content-Type: application/json" \
  -d "{\"addresses\":[\"0xTokenA\",\"0xTokenB\",\"0xTokenC\"]}"

[
  {
    "address": "0xtokena",
    "score": 71,
    "tier": "HIGH",
    "confidence": 82,
    "flags": [],
    "state": "graduated"
  },
  {
    "address": "0xtokenb",
    "score": 9,
    "tier": "BLOCKED",
    "confidence": 40,
    "flags": ["HONEYPOT_PATTERN", "EXIT_SYNC"],
    "state": "graduated"
  }
]

Limits: max 40 addresses, 30 requests per minute per IP. Duplicates are collapsed server-side. Invalid or non-token addresses come back with error set rather than failing the whole batch.

Script-tag path

<script src="https://www.trustgated.xyz/widget-discovery.js"></script>
<span data-trustgate-badge="0xTOKENADDRESS"></span>

Search list with optional reorder:

<script
  src="https://www.trustgated.xyz/widget-discovery.js"
  data-trustgate-search="#token-results"
  data-trustgate-reorder="on"
  data-trustgate-flags="on"
></script>

<ul id="token-results">
  <li data-trustgate-row data-address="0xaaa…">Yoshi</li>
  <li data-trustgate-row data-address="0xbbb…">Yoshi</li>
</ul>

After an SPA re-render:

window.TrustGateDiscovery.reorderContainer("#token-results");

Reorder helper

Pure. Never mutates the input. Never auto-applied.

import { reorderByTrust } from "@/lib/discovery/reorder";

const ordered = reorderByTrust(myItems, (item) => item.address, scores);

Ranking:

Higher tier first. VERIFIED and ELITE rise. LOW and BLOCKED sink, still present.
Same tier: graduated outranks mining.
Then higher raw score.
Unscored or error entries sink below all scored ones, keeping their relative order.

Same-ticker helper: rankSameTickerTokens / rankGroupsByTrust ranks within a ticker so rugs sink while staying visible.

Why it is built this way

A discovery feed is a product decision, and it belongs to you. A trust layer that quietly reshuffled it would be taking over the very thing that makes your feed yours. So TrustGate draws the line hard: it will badge, it will flag, it will offer you a trust-ranked version of the list, and it will never impose one.

Badging and flagging are safe to ship as the default everywhere. Reach for reordering when you have decided trust should shape the order, not before.

The discovery product page

The overview and the opt-in ladder in full.

Widget attributes

Both script tags in one guide.

Start Here

Guides

Reference

The idea

Live batch endpoint

Script-tag path

Reorder helper

Why it is built this way

Next

The discovery product page

Widget attributes

​The idea

​Live batch endpoint

​Script-tag path

​Reorder helper

​Why it is built this way

​Next

The discovery product page

Widget attributes

The idea

Live batch endpoint

Script-tag path

Reorder helper

Why it is built this way

Next