Agent API TokenAddy

Everything on this page works with plain HTTP + JSON from any language or agent framework. No SDKs, no keys to buy.

Resolve a name free · no auth

curl https://tokenaddy.com/resolve/alice
curl https://tokenaddy.com/resolve/vitalik.eth        # ENS passthrough, no blockchain scanning
curl "https://tokenaddy.com/resolve/vitalik.eth?all=1" # side-by-side TokenAddy + ENS + DNS TXT

Animal Tier + human-readable age free · no auth

curl https://tokenaddy.com/tier/alice
# {"name":"alice","tier":"Dolphin","emoji":"🐬","balance_eth":12.4,"balance_human":"12.400000 ETH",
#  "age_human":"Created 2.1 years old","wallet":"0x.."}
# Tiers: Shrimp 🦐 <0.05 ETH · Seahorse 🐠 <0.5 · Tuna 🐟 <5 · Dolphin 🐬 <50 · Whale 🐳 ≥50

A note on names

TokenAddy is a lookup service, not a registrar. We don't create names. Get .eth names at app.ens.domains and domains at any registrar — then resolve them here.

Extras

Endpoint	What
`GET /available/<name>`	{"available":true\|false} — checks TokenAddy + ENS
`GET /history/<name>`	last 20 pointer changes (from to)
`GET /whois/<name>`	created/updated timestamps
`GET /.well-known/tokenaddy/<name>`	TXT-style paste-ready record view
`GET /txt/<domain>`, `/dnssec/<domain>`	DNS-over-HTTPS lookups
`GET /qr/<name>`, `/card/<name>`	SVG QR + share card
`GET /claim/quote?address=…`	claim quote for a wallet or token: price, kind, eligibility

Official profiles (claims) paid · one-time

Owners can claim a profile that shows on every lookup: $7.99 for a wallet owner profile, $49.95 for a token contract profile ("Claimed by Creator"). Quote first, then the flow verifies ownership with the wallet itself — POST /claim/challenge returns a personal_sign message; TokenAddy never asks for a seed phrase or key.

curl "https://tokenaddy.com/claim/quote?address=0x751d4b0a7A0dA01A9dA29abDD7E9C5f4a7cd64eA"
# {"price":{"usd":7.99},"kind":"wallet","eligible":true,…}

What's included for each price: tokenaddy.com/pricing.

Back to look up