GET /api/v1/trending/offers
Trending names ranked by offer 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_offers | number | Offers received in the period |
highest_offer | string | Highest offer amount in wei |
avg_offer | string | Average offer amount in wei |
unique_bidders | number | Distinct bidder addresses |
Sample Request
curl "https://api.grails.app/api/v1/trending/offers?period=24h&limit=10"Response
// 200 OK
{
"success": true,
"data": {
"names": [
{
// ... standard SearchResult fields (id, name, token_id, owner, etc.)
"trending_metrics": {
"period": "24h",
"period_offers": 8,
"highest_offer": "200000000000000000",
"avg_offer": "120000000000000000",
"unique_bidders": 6
}
}
],
"meta": { "period": "24h", "type": "offers", "limit": 10 }
},
"meta": {
"timestamp": "2026-04-07T12:00:00.000Z",
"version": "1.0.0"
}
}Last updated on