Doma API: register and trade DNS-compliant on-chain domains

Doma Protocol (doma.xyz) bridges traditional DNS registrars and on-chain ownership. Domains stay ICANN/DNS-compliant while gaining tokenized, multi-chain representations — not an alternative root.

API surface: docs.doma.xyz/api-reference (llms.txt). GitHub: github.com/d3-inc. X: @domaprotocol.

Click to zoom

Architecture (three layers)

1. Registrar bridge — APIs for registrars to sync events bidirectionally with Doma Chain
2. Doma Chain — authoritative domain state; cross-chain messaging (docs cite ERC-7786); EVM + SVM-oriented ops
3. On-chain capabilities — tokenization, synthetics, DomainFi on chains including Base, Solana, Avalanche, Ethereum

Registrars keep customer relationship, DNS, and ICANN compliance; Doma is the “integrate once, distribute everywhere” token layer.

API reference map

Auth

# Key from https://app.doma.xyz/account/developers
curl -sS "https://api.doma.xyz/graphql" \
  -H "Content-Type: application/json" \
  -H "Api-Key: $DOMA_API_KEY" \
  -d '{"query":"{ __typename }"}'

# Testnet GraphQL (docs)
# https://api-testnet.doma.xyz/graphql

Higher rate limits: contact Doma support (docs link to D3 service desk). Do not put API keys in client bundles.

Domain registration flow (API + chain)

From Domain Registration. Use this for a new name (primary). Already own a DNS domain? See “How to tokenize a domain” instead.

1. Search & price — availableDomains, domainPricing
2. Registrant handle — upload WHOIS contacts (email verification or privileged pre-verified path)
3. Create order — createOrder returns a backend-signed payment voucher
4. Pay on-chain — pay(voucher, signature) on the Marketplace contract (token + amount + paymentContractAddress from voucher)
5. Track order until name token mints to the paying wallet

You do not EIP-712-sign the voucher yourself — Doma signs it; the wallet only submits payment. Runnable example: d3-inc/doma-register-example (viem + graphql-request).

Prerequisites: funded EVM wallet (gas + USDC or native fee currency per quote); accessible email if using verification path.

Agent surfaces (related docs)

Beyond REST/GraphQL, docs cover agentic commerce: MCP server, AgentRoot skills, Doma CLI, agentic wallet, secondary sales / MPP skills. Use those when the integrator is an agent, not a classic web app.

When to use

Links

• API reference
• Docs home
• App
• d3-inc
• doma-register-example

Summary

Doma’s API reference is how builders register and operate DNS-real domains on-chain: authenticate with Api-Key, drive GraphQL for search/order/WHOIS, pay a signed voucher on Doma chain, then index via subgraph/orderbook. Start on testnet GraphQL + RPC, clone the register example, then expand to marketplace and agent MCP tools.