Discovery
Discovery endpoints answer one question: what is getting attention right now?
They return counts and contract or token identifiers, not tweet text and not sentiment. Use them to build the universe your agent should inspect next.
Contract Address Discovery
Telegram trending contract addresses and Twitter trending contract addresses are strongest when read together.
| Appears where | What it means |
|---|---|
| Telegram, not yet Twitter | Early circulation. |
| Both Telegram and Twitter | The move is already running. |
| Twitter, fading on Telegram | Late or losing freshness. |
Telegram CAs - Use this to see contract addresses circulating before they reach broader Twitter visibility. This can replace a fragile group-scraping or watchlist-maintenance setup.
Twitter CAs - Use this to confirm whether a Telegram lead has crossed into the broader surface. Mention counts help an agent avoid spending cycles on dead tickers.
Trending Tokens
Trending tokens returns tokens ranked by mention activity over a selected window.
Use it to:
- Pick today's universe: start each run from live attention instead of a hardcoded ticker list.
- See rotation: compare a short window against a longer one to separate heating-up tokens from already-peaked ones.
- Let the threshold filter:
minMentionsgives your agent a practical significance floor.
/v2/aggregations/trending-tokens is experimental and under active development. Use it for discovery, but avoid treating its exact behavior as a permanent production contract.
Next Step
After discovery, use Top Mentions to inspect amplification quality, Token News to check for catalysts, or Chat to ask for interpretation.