--- name: api.slamai.dev description: api.slamai.dev provides two token discovery endpoints for Ethereum and Base: one ranks tokens by active-wallet growth over a chosen time window, and the other surfaces the most recently minted tokens sorted by first-mint timestamp. Both return contract-level metadata including price, FDV, liquidity, and mint details. host: api.slamai.dev --- # api.slamai.dev This host serves agents focused on early-stage token discovery on Ethereum and Base. It covers two distinct discovery angles: momentum (which tokens are gaining active wallets) and recency (which tokens were just deployed). It does not provide price history, order books, or trade execution — it is a screening and discovery layer, not a trading or analytics platform. ## When to use this host Use this host when an agent needs to screen for trending or newly deployed tokens on Ethereum or Base, particularly for early-signal detection or launch monitoring. Do not use it for historical OHLCV data, order book depth, or swap execution — use a dedicated price-history API (e.g. CoinGecko, Dune) or a DEX aggregator instead. It is also not suitable for chains other than Ethereum or Base; for Solana or other ecosystems, route to a chain-specific discovery API. ## Capabilities ### Token Discovery Surfaces tokens on Ethereum or Base either by active-wallet momentum or by recency of first mint, enabling agents to screen for trending or newly launched tokens with supporting market metadata. - **`fetch-trending-tokens`** — Returns a ranked list of trending blockchain tokens on Ethereum or Base, ordered by active-wallet growth over a chosen time window, with price, FDV, liquidity, and mint data. - **`fetch-newest-minted-tokens`** — Returns the most recently minted tokens on Ethereum or Base, sorted by first-mint timestamp, with contract address, price, liquidity, FDV, and mint transaction details. ## Workflows ### New Token Momentum Screen *Use when an agent needs to find recently minted tokens that are also gaining active-wallet traction, to filter out new launches with no real uptake.* 1. **`fetch-newest-minted-tokens`** — Retrieve the latest token launches on a given chain, capturing contract addresses and mint timestamps. 2. **`fetch-trending-tokens`** — Retrieve the current trending tokens ranked by active-wallet growth, then cross-reference with the newly minted list to identify tokens that are both new and gaining momentum. ## Skill reference ### `fetch-trending-tokens` **Token Trend Radar** — Returns a ranked list of trending blockchain tokens on Ethereum or Base, ordered by active-wallet growth over a chosen time window, with price, FDV, liquidity, and mint data. *Use when:* Use when an agent needs to identify which tokens are gaining the most active-wallet traction on Ethereum or Base over a short-to-medium time window (5 min to 1 day), such as for trend detection, token screening, or market monitoring. *Not for:* Do not use for historical price series, order book data, or swap execution; use a dedicated price-history or DEX API instead. Not suitable for chains other than Ethereum or Base. **Inputs:** - `blockchain` (string, required) — The blockchain to query. Must be 'ethereum' or 'base'. - `num` (integer) — Maximum number of trending tokens to return. Maximum allowed value is 250. - `category` (string) — Filters results to a specific token subset. Currently only 'virtuals' is supported on Base. - `activity_window` (string) — Time window over which active-wallet growth is measured. Allowed values: '5min', '15min', '1h', '3h', '6h', '1d'. - `estimate_cost` (boolean) — When true, returns only the SLAM token cost estimate for the call without returning token data. **Returns:** Returns slam cost, chain name, block number, UTC timestamp, and a tokens array with rank, name, symbol, address, current USD price, price change percentages, FDV, liquidity, and first-mint metadata for each trending token. **Example:** `GET https://api.slamai.dev/chain/tokens/trending?blockchain=base&num=10&activity_window=1h` --- ### `fetch-newest-minted-tokens` **Freshly Minted Tokens** — Returns the most recently minted tokens on Ethereum or Base, sorted by first-mint timestamp, with contract address, price, liquidity, FDV, and mint transaction details. *Use when:* Use when an agent needs to discover newly deployed tokens on Ethereum or Base, optionally filtered by category (e.g. 'virtuals') and a recent activity window, to surface the latest token launches. *Not for:* Do not use for trending or top-performing tokens ranked by volume or price change; this endpoint ranks solely by newness (first mint timestamp). **Inputs:** - `blockchain` (string, required) — The blockchain to query. Must be 'ethereum' or 'base'. - `num` (integer) — Maximum number of tokens to return. Max: 1000. - `category` (string) — Filter by token category. Currently only 'virtuals' on Base is supported. - `activity_window` (string) — Length of time over which activity is measured. One of: '5min', '15min', '1h', '3h', '6h', '1d'. - `estimate_cost` (boolean) — When true, returns only the SLAM token cost of this query without executing it. **Returns:** Returns a JSON object with chain, block, utc timestamp, SLAM cost, and a tokens array of up to N newly minted tokens each containing rank, name, symbol, address, USD price data, FDV, liquidity, and first-mint block/timestamp/hash. **Example:** `GET https://api.slamai.dev/chain/tokens/newest?blockchain=base&num=10&activity_window=1h` ---