Grails API Documentation

GET /api/v1/activity/:name

Get the activity history for a specific ENS name, including transfers, sales, listings, and offers.

Authentication: None

Cache: 15s

Path Parameters

Parameter	Type	Required	Description
`name`	string	Yes	ENS name (e.g. `example.eth`)

Query Parameters

Parameter	Type	Default	Description
`page`	number	`1`	Page number
`limit`	number	`50`	Results per page
`event_type`	string or string[]	—	Filter by event type(s) (repeatable)
`platform`	string	—	Filter by platform

Sample Request


curl "https://api.grails.app/api/v1/activity/example.eth?event_type=sale&limit=10"

Response


// 200 OK
{
  "success": true,
  "data": {
    "results": [
      {
        "id": 1,
        "ens_name_id": 42,
        "event_type": "sale",
        "actor_address": "0xabcd...",
        "counterparty_address": "0x1234...",
        "platform": "grails",
        "chain_id": 1,
        "price_wei": "100000000000000000",
        "currency_address": "0x0000...0000",
        "transaction_hash": "0xdef...",
        "block_number": 12345678,
        "metadata": { ... },
        "created_at": "2026-04-07T18:00:00.000Z",
        "name": "example.eth",
        "token_id": "12345...",
        "clubs": ["999"]
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 25,
      "totalPages": 3,
      "hasNext": true,
      "hasPrev": false
    }
  },
  "meta": {
    "timestamp": "2026-04-08T00:00:00.000Z",
    "version": "1.0.0"
  }
}

Error Responses

Status	Code	Description
404	`ENS_NAME_NOT_FOUND`	ENS name not found
500	`INTERNAL_ERROR`	Failed to fetch activity