GET /api/v1/trending/watchlist
Trending names ranked by watchlist additions in the period.
Authentication: Optional
Cache: None
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
period | string | 24h | Time period: 24h or 7d |
limit | number | 20 | Results to return (1-100) |
Trending Metrics
| Field | Type | Description |
|---|---|---|
period_additions | number | Watchlist additions in the period |
total_watchers | number | Total current watchers |
Sample Request
curl "https://api.grails.app/api/v1/trending/watchlist?period=7d&limit=10"Response
// 200 OK
{
"success": true,
"data": {
"names": [
{
// ... standard SearchResult fields (id, name, token_id, owner, etc.)
"trending_metrics": {
"period": "7d",
"period_additions": 25,
"total_watchers": 120
}
}
],
"meta": { "period": "7d", "type": "watchlist", "limit": 10 }
},
"meta": {
"timestamp": "2026-04-07T12:00:00.000Z",
"version": "1.0.0"
}
}Last updated on