Get Registration Price

Get the registration price for a specific subname based on name length and type.

Endpoint

GET /api/subnames/{parent}/{name}/price

Authentication

None required — This is a public read endpoint.

Parameters

Parameter	Type	Location	Required	Description
parent	string	path	✅	Parent ENS name (e.g., aboutme.eth)
name	string	path	✅	Subname label to price (e.g., alice)

Response

{
  "parent": "aboutme.eth",
  "name": "mycoolname",
  "fullName": "mycoolname.aboutme.eth",
  "available": true,
  "pricing": {
    "price": 0.97,
    "priceFormatted": "$0.97",
    "tier": "standard",
    "reason": "Standard name",
    "currency": "USDC",
    "network": "Base"
  },
  "timestamp": "2024-02-10T14:30:00.000Z"
}

Pricing Tiers

Tier	Price/Year	Name Length	Examples
ultraPremium	$97.00	1-2 characters	a, xy
ultraShort	$19.97	3 characters	abc, dev
dictionary	$9.97	Common words (4+)	crypto, alpha, gold
short	$4.97	4 characters	code, hash
standard	$0.97	5+ characters	alice, developer
reserved	N/A	Reserved names	admin, support

Free First Registration

Your first registration is FREE (one per wallet + one per IP address). Additional registrations require payment at the listed prices.

Dictionary Words

Common English words and Web3-specific terms have a premium ($9.97) regardless of length:

Common words: the, be, have, do, say, get, make, go, know, take, see, come, think, look, want, give, use, find, tell, ask, work, seem, feel, try, leave, call...

Web3 terms: crypto, bitcoin, ethereum, wallet, token, nft, defi, web3, meta, alpha, prime, elite, vip, gold, diamond...

Examples

cURL

# Standard name (5+ chars)
curl "https://api.web3identity.com/api/subnames/aboutme.eth/developer/price"
# Response: $0.97 (standard)

# Short name (4 chars)
curl "https://api.web3identity.com/api/subnames/aboutme.eth/code/price"
# Response: $4.97 (short)

# Dictionary word
curl "https://api.web3identity.com/api/subnames/aboutme.eth/crypto/price"
# Response: $9.97 (dictionary)

# Ultra short (3 chars)
curl "https://api.web3identity.com/api/subnames/aboutme.eth/abc/price"
# Response: $19.97 (ultraShort)

# Premium (1-2 chars)
curl "https://api.web3identity.com/api/subnames/aboutme.eth/ab/price"
# Response: $97.00 (ultraPremium)

JavaScript

async function getPrice(parent, name) {
  const response = await fetch(
    `https://api.web3identity.com/api/subnames/${parent}/${name}/price`
  );
  return response.json();
}

// Get price before registration
const priceInfo = await getPrice('aboutme.eth', 'mycoolname');

if (priceInfo.available) {
  console.log(`Price: ${priceInfo.pricing.priceFormatted}/year`);
  console.log(`Tier: ${priceInfo.pricing.tier}`);
  console.log(`Reason: ${priceInfo.pricing.reason}`);
} else {
  console.log('Name is already taken');
}

Price Comparison Function

async function comparePrices(parent, names) {
  const results = await Promise.all(
    names.map(name => getPrice(parent, name))
  );
  
  return results
    .sort((a, b) => a.pricing.price - b.pricing.price)
    .map(r => ({
      name: r.name,
      price: r.pricing.priceFormatted,
      tier: r.pricing.tier,
      available: r.available
    }));
}

// Find cheapest available name
const options = await comparePrices('aboutme.eth', [
  'alice', 'bob', 'alice123', 'a', 'crypto'
]);
console.table(options);

Error Responses

Status	Code	Description
400	BAD_REQUEST	Invalid name format
429	RATE_LIMITED	Rate limit exceeded
500	PRICING_ERROR	Internal server error

Related Endpoints

• Check Availability — Availability + pricing in one call
• Get Renewal Price — Price for renewing existing name
• Purchase — Register with x402 payment