Grails API Documentation

GET /api/v1/names/:name

Get full details for a single ENS name, including vote data (if authenticated), listing and offer data from OpenSea, and ENS metadata. If the name is not in the database, the API fetches it from The Graph and imports it.

Metadata is auto-refreshed from The Graph when stale. Name views are tracked asynchronously.

Authentication: Optional (includes user’s vote data when authenticated)

Cache: None

Path Parameters

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

Sample Request


curl https://api.grails.app/api/v1/names/example.eth

Response


// 200 OK
{
  "success": true,
  "data": {
    "id": 1313948,
    "name": "brantly.eth",
    "token_id": "47192814855232171824620094590612668126513223473283784600320596656451859494352",
    "owner": "0x983110309620d911731ac0932219af06091b6744",
    "expiry_date": "2041-05-02T21:07:12.000Z",
    "registration_date": "2020-02-04T02:23:59.000Z",
    "creation_date": "2017-06-15T02:40:38.000Z",
    "last_sale_date": null,
    "last_sale_price": null,
    "last_sale_currency": null,
    "last_sale_price_usd": null,
    "metadata": {
      "url": "https://ethid.org/",
      "avatar": "https://euc.li/brantly.eth",
      "header": "https://euc.li/brantly.eth/h",
      "description": "Catholic, husband, father | building ...",
      "com.twitter": "brantlymillegan",
      "com.github": "brantlymillegan",
      "org.telegram": "brantlymillegan",
      "location": "USA",
      "chains": [
        { "coinType": 0, "chainName": "Bitcoin", "address": "bc1q..." },
        { "coinType": 60, "chainName": "Ethereum", "address": "0x9831..." }
      ]
    },
    "metadata_updated_at": "2026-04-09T14:50:33.712Z",
    "clubs": ["prepunks"],
    "club_ranks": [{ "club": "prepunks", "rank": 64435 }],
    "has_numbers": false,
    "has_emoji": false,
    "listings": [
      // Active listings array (empty if none)
      {
        "id": 100,
        "price": "250000000000000000",
        "currency_address": "0x0000000000000000000000000000000000000000",
        "status": "active",
        "seller_address": "0x1234...",
        "order_hash": "0xabc...",
        "order_data": { "..." : "..." },
        "expires_at": null,
        "created_at": "2026-04-01T00:00:00.000Z",
        "source": "grails",
        "broker_address": null,
        "broker_fee_bps": null
      }
    ],
    "upvotes": 0,
    "downvotes": 0,
    "net_score": 0,
    "user_vote": null, // only present when authenticated
    "watchers_count": 0,
    "is_user_watching": false,
    "watchlist_record_id": null,
    "highest_offer_wei": null,
    "highest_offer_currency": null,
    "highest_offer_id": null,
    "view_count": 102
  },
  "meta": {
    "timestamp": "2026-04-09T12:00:00.000Z",
    "version": "1.0.0"
  }
}

Error Responses

Status	Code	Description
404	`NAME_NOT_FOUND`	ENS name not found in database or on-chain