Give your AI one key. It handles your domains.

The NameOcean API lets any program, or any AI assistant, do what you do in the dashboard: search and register domains, change nameservers, edit DNS records, issue SSL certificates, open ports and bind domains to your servers.

Copy your key

Open Dashboard → API Key and copy it.

Give it to your AI

Paste the prompt below into Claude, ChatGPT or Cursor together with your key.

Ask in plain words

"Point blog.example.com to 203.0.113.10 and turn on SSL."

Prompt for your AI assistant

You can manage my domains with the NameOcean API. Read https://nameocean.net/llms.txt for how it works. My API key is: [paste your key here]. Always ask me before anything that costs money.

Your key gives full access to your account. Only share it with tools you trust, and create a new key from the dashboard if it leaks.

Authentication

Send your key in the Authorization header of every request. Responses are JSON. The limit is 120 requests per minute.

curl

$ curl https://nameocean.net/api/v1/account \
    -H "Authorization: Bearer $NAMEOCEAN_API_KEY"

{"email": "you@example.com", "credit": "42.00", "currency": "USD", "domains": 3, "dns_zones": 3}

Endpoints

Base URL: https://nameocean.net/api/v1/

Domenlar

GET	/domains/check?name=example.com	Availability and price
GET	/domains	List your domains
POST	/domains	Register a domain, paid from your balance `{"name", "years"}`
GET	/domains/{name}	Details, nameservers, SSL status
PATCH	/domains/{name}	Auto renew and transfer lock `{"auto_renew", "locked"}`
PUT	/domains/{name}/nameservers	`{"nameservers": [...]}` yoki `"nameocean"`
POST	/domains/{name}/renew	Renew one year (within 60 days of expiry)
GET	/domains/{name}/auth-code	Transfer code

DNS

GET	/dns	List DNS zones
POST	/dns	Create a zone for a domain registered elsewhere `{"name"}`
GET	/dns/{zone}/records	List records
POST	/dns/{zone}/records	Add a record: A, CNAME, MX, TXT, SRV, PTR, REDIRECT
PATCH	/dns/{zone}/records/{type}/{id}	Change a record
DELETE	/dns/{zone}/records/{type}/{id}	Delete a record

SSL

GET	/ssl/{zone}	Status, expiry date and download link
POST	/ssl/{zone}	Issue a free wildcard certificate
PATCH	/ssl/{zone}	Auto renew `{"auto_renew"}`

App servers

{server} is the server id or its default domain, such as 3f9a1c2e.nameocean.org.

GET	/servers	Your servers with SSH, git remote, ports and domains
GET	/servers/{server}	One server
GET	/servers/{server}/ports	Open ports
POST	/servers/{server}/ports	Open a TCP or UDP port `{"port", "protocol"}`
DELETE	/servers/{server}/ports/{id}	Close a port
GET	/servers/{server}/domains	Bound domains and their status
POST	/servers/{server}/domains	Bind a domain or subdomain with HTTPS `{"domain"}`
DELETE	/servers/{server}/domains/{id}	Unbind a domain

Example: new domain with HTTPS

bash

# 1. Check the price
curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY"

# 2. Register (charges your balance)
curl -X POST https://nameocean.net/api/v1/domains -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"name": "kahvebot.com", "years": 1}'

# 3. Point it to your server
curl -X POST https://nameocean.net/api/v1/dns/kahvebot.com/records -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" -d '{"type": "A", "hostname": "@", "ip": "203.0.113.10", "ttl": "5m"}'

# 4. Free wildcard SSL
curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"

The full reference for AI agents, with every field and record type, is at nameocean.net/llms.txt. GET /api/v1/ also describes itself.

Get your API key llms.txt