The .fomo resolver API

GET /api/resolve/{domain}

Resolve a domain

Returns the address a domain points at, plus its owner. With or without the TLD: alice and alice.fomo are equivalent. Addresses are lowercase 0x hex. Cache headers included. 404 when unregistered.

{
  "name": "alice.fomo",
  "tld": "fomo",
  "owner": "0x8f2a…c41d",
  "target": "0x93b7…7e02",
  "records": {},
  "registeredAt": "2026-08-16T11:02:44.180Z"
}

GET /api/check?name={name}

Check availability

Validates the name and reports availability. Always 200; read the available flag. A free result is a snapshot, not a hold — the database decides the winner at reservation time.

{
  "available": true,
  "normalized": "alice",
  "tld": "fomo",
  "priceEth": "0.01",
  "priceWei": "10000000000000000"
}

GET /api/domains?limit=50&offset=0&q=

List the registry

Every confirmed domain, newest first. limit caps at 100; q is a case-insensitive substring filter.

{
  "tld": "fomo",
  "total": 128,
  "limit": 50,
  "offset": 0,
  "domains": [ { "name": "alice", "fqdn": "alice.fomo", … } ]
}

GET /api/wallet/{address}

Domains by wallet

Reverse lookup: everything a 0x address owns, newest first. Case-insensitive. Lists by owner, not target. Served no-store.

{
  "owner": "0x8f2a…c41d",
  "tld": "fomo",
  "count": 2,
  "names": [ { "name": "alice", "fqdn": "alice.fomo", … } ]
}

POST /api/register/reserve

Reserve a name

Body: { name, wallet }. Requires a wallet session (Sign in with Ethereum via the site) matching wallet. Inserts a pending row with a fresh reservation reference and a ten-minute expiry. A unique index decides races: the loser gets 409 NAME_UNAVAILABLE. Send memo as the transaction's calldata (UTF-8 hex) and wei as its value.

{
  "reservationId": "…",
  "memo": "fomo:reg:alice:1a2b3c4d",
  "treasury": "0xf09e…5ae8",
  "wei": "10000000000000000",
  "expiresAt": "…"
}

POST /api/register/confirm

Confirm payment

Body: { reservationId, txHash }. The server fetches the transaction itself and verifies: the receipt succeeded, the recipient is the treasury, the value covers the price, the calldata is exactly the reservation reference, and the sender is the reserving wallet. 425 TX_NOT_FOUND is retryable while the transaction is still pending.

{
  "ok": true,
  "fqdn": "alice.fomo",
  "owner": "0x8f2a…c41d",
  "txHash": "0x7d3e…",
  "registeredAt": "…"
}