Skip to main content

​
What it is

Discovery is TrustGate for many things at once. Instead of reading a single token, you hand it a whole list — a launchpad feed, a trending page, a set of search results — and it returns a read for each one. That lets a discovery surface do something it usually cannot: account for trust, not just hype and recency. The batch path is live.
Open CORS. Free local scoring. No x402. Max 40 addresses per request. Rate limit 30 requests per minute per IP. Reference UI: trustgated.xyz/discovery is a kit demo (sample tickers, not a live DEX). The batch endpoint and widgets are what you integrate. A live partner DEX embed is still the Phase 2b exit, not a claim this page makes.

​
The problem it fixes

Most discovery feeds rank by the loudest signals. What is new, what is pumping, what is being talked about. None of that tells a user whether the thing is safe, and a risky token sits in the feed looking exactly like a healthy one. Discovery adds the missing dimension.

​
What you get back

One object per address:
  • Tiers: BLOCKED | LOW | MEDIUM | HIGH | ELITE | VERIFIED. HIGH_ELITE from other surfaces is mapped to ELITE.
  • ELITE and VERIFIED are meant to show the tier only, no number.
  • LOW and BLOCKED are meant to be deprioritized — marked, never hidden.
  • state is graduated or mining. A mining token’s score describes the deployer, not the token. Label it that way.
  • error is set when the address could not be scored as a token (not_a_token, invalid_address, fetch_failed, score_failed).

​
How far you take it

Your feed is yours. There is a ladder of involvement, and you choose the rung.
1

Badge it

The lightest touch. Show a trust badge next to each item in your existing feed, in your existing order. Nothing about your ranking changes.
2

Flag it

Surface the plain-language flags too. Still your order, now with warnings where they matter. Off by default on the discovery widget so rows stay compact.
3

Reorder it

The most involved, and entirely optional. Call reorderByTrust or set data-trustgate-reorder="on" on the discovery script. This is never automatic.
Reordering is opt-in and explicit. The default is non-invasive: badges and flags on top of your own ranking. Nothing reshuffles your feed unless you reach for it yourself.

​
Two ways in

Script tag. Load widget-discovery.js, mark slots with data-trustgate-badge="0x...", or mark a results list with data-trustgate-row and data-address. React kit. Import scoreBatch, TrustBadge, TrustFlags, and optionally reorderByTrust / rankSameTickerTokens from the TrustGate frontend library. Partners embedding from outside can copy those helpers — they are pure. Full walkthrough: Optional reorder.

​
You stay in control

Discovery is a signal layer, full stop. It scores the list and offers you components and a helper to use as much or as little as you want. The feed stays your product. The ranking stays your decision.

​
Who it is for

Launchpads that want their feed to reward real projects over manufactured ones. Aggregators and token lists. Search and trending surfaces. Anywhere people discover tokens in bulk.

Optional reorder

Live batch endpoint, script attributes, and the reorder helper.

API reference

POST /api/batch request and error codes.