GET /api/v1/trending/sales
Trending names ranked by sales activity 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_sales | number | Number of sales in the period |
period_volume | string | Total sales volume in wei |
avg_price | string | Average sale price in wei |
max_price | string | Highest sale price in wei |
min_price | string | Lowest sale price in wei |
Sample Request
curl "https://api.grails.app/api/v1/trending/sales?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_sales": 3,
"period_volume": "500000000000000000",
"avg_price": "166666666666666666",
"max_price": "250000000000000000",
"min_price": "100000000000000000"
}
}
],
"meta": { "period": "7d", "type": "sales", "limit": 10 }
},
"meta": {
"timestamp": "2026-04-07T12:00:00.000Z",
"version": "1.0.0"
}
}Last updated on