Grails API Documentation

GET /api/v1/listings/name/:name

Get all active listings for a specific ENS name, ordered by most recently created.

Authentication: None

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/listings/name/example.eth

Response


// 200 OK
{
  "success": true,
  "data": [
    {
      "id": 42,
      "ens_name_id": 1,
      "seller_address": "0xabcd...",
      "price_wei": "100000000000000000",
      "currency_address": "0x0000000000000000000000000000000000000000",
      "order_hash": "0x1234...",
      "order_data": { ... },
      "status": "active",
      "source": "grails",
      "created_at": "2026-04-01T00:00:00.000Z",
      "updated_at": "2026-04-01T00:00:00.000Z",
      "expires_at": null,
      "last_validated_at": null,
      "unfunded_at": null,
      "unfunded_reason": null,
      "broker_address": null,
      "broker_fee_bps": null,
      // Joined from ens_names
      "ens_name": "example.eth",
      "token_id": "12345...",
      "current_owner": "0xabcd...",
      "name_expiry_date": "2027-01-15T00:00:00.000Z",
      "registration_date": "2023-01-15T00:00:00.000Z",
      "last_sale_date": null
    }
  ],
  "meta": {
    "timestamp": "2026-04-07T12:00:00.000Z",
    "version": "1.0.0"
  }
}

Error Responses

Status	Code	Description
404	`LISTING_NOT_FOUND`	No active listing found for this name