Grails API Documentation

GET /api/v1/sales/:nameOrId/analytics

Get sales analytics for a specific ENS name, including price history, volume, and trends.

Authentication: None

Cache: 60s

Path Parameters

Parameter	Type	Required	Description
`nameOrId`	string	Yes	ENS name (e.g. `example.eth`) or database ID (number)

Sample Request


curl https://api.grails.app/api/v1/sales/example.eth/analytics

Response


// 200 OK
{
  "success": true,
  "data": {
    "total_sales": "5",
    "avg_price_wei": "100000000000000000",
    "min_price_wei": "50000000000000000",
    "max_price_wei": "200000000000000000",
    "first_sale_date": "2025-06-15T12:00:00.000Z",
    "last_sale_date": "2026-04-06T18:00:00.000Z"
  },
  "meta": {
    "timestamp": "2026-04-09T12:00:00.000Z",
    "version": "1.0.0"
  }
}

Error Responses

Status	Code	Description
404	—	ENS name not found
500	—	Failed to fetch analytics