Discover Trending Tokens
Discovers trending tokens by combining DEX Screener boost signals and Codex trending scores. Merges, deduplicates, and ranks tokens using a composite score that rewards multi-source presence, volume, and buy pressure. Ideal for: building token roulettes, finding early alpha, automated portfolio rotation.
Catalog action Blockchain Data
Discovers trending tokens by combining DEX Screener boost signals and Codex trending scores. Merges, deduplicates, and ranks tokens using a composite score that rewards multi-source presence, volume, and buy pressure. Ideal for: building token roulettes, finding early alpha, automated portfolio rotation.
At a Glance
| Field | Value |
|---|---|
| Action ID | discover-trending-tokens |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | trending, dex, onchain, defi, token, market |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
chainId | string | No | Chain to discover tokens on. Common values: 'base', 'ethereum', 'bsc', 'polygon', 'arbitrum', 'optimism'. Default: 'base' |
minLiquidity | number | No | Minimum liquidity in USD to filter out illiquid tokens. Default: 10000 |
minVolume24 | number | No | Minimum 24-hour trading volume in USD. Default: 5000 |
excludeScams | boolean | No | Exclude tokens flagged as potential scams. Default: true |
limit | number | No | Maximum number of tokens to return (1-100). Default: 20 |
sources | string | No | Data sources to query. 'both' merges DEX Screener and Codex, or use a single source. Default: 'both' |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
tokens | array | Yes | Discovered tokens ranked by composite score |
metadata | object | Yes | Query metadata and diagnostics |
Examples
json{ "type": "discover-trending-tokens", "payload": { "chainId": "base", "minLiquidity": 10000, "minVolume24": 5000, "excludeScams": true, "limit": 20 }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/discover-trending-tokens/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "chainId": "base", "minLiquidity": 10000, "minVolume24": 5000, "excludeScams": true, "limit": 20 }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.