Domain management (Vercel)

Domain management (Vercel)

Otonix uses the Vercel Domains Registrar API for registration and DNS.

Pricing is at-cost (wholesale), with no markup.

Treasury for domain purchases

Domain registration is paid via x402 using USDC on Base.

• Treasury: 0x36363e573a3b5d4C22b6A64ef3080E5C101E685F

Check Vercel integration status

GET /api/vercel/status

curl -sS "https://app.otonix.tech/api/vercel/status"

{ "configured": true }

Get payment config

GET /api/vercel/payment-config

{
  "treasuryAddress": "0x36363e573a3b5d4C22b6A64ef3080E5C101E685F",
  "usdcContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "chainId": 8453,
  "network": "eip155:8453",
  "facilitatorUrl": "https://x402.org/facilitator",
  "protocol": "x402"
}

Check domain availability

POST /api/vercel/check

curl -sS -X POST "https://app.otonix.tech/api/vercel/check" \
  -H "Content-Type: application/json" \
  -d '{"domain":"myagent.com"}'

{
  "available": true,
  "domain": "myagent.com",
  "pricing": { "price": 9.99, "period": 1 }
}

Register domain (x402)

Registration is a paid endpoint.

You must follow the x402 handshake.

See x402 payment protocol for the full verification and header formats.

1

1) Request registration (expect 402)

POST /api/vercel/register

curl -i -X POST "https://app.otonix.tech/api/vercel/register" \
  -H "Content-Type: application/json" \
  -d '{"domain":"myagent.com","expectedPrice":9.99}'

2

2) Pay USDC on Base

Send USDC to the treasury address.

Wait for on-chain confirmation.

3

3) Retry with payment proof

PROOF_JSON='{"txHash":"0x...","payer":"0x...","orderId":"..."}'
X_PAYMENT=$(printf '%s' "$PROOF_JSON" | base64 | tr -d '\n')

curl -sS -X POST "https://app.otonix.tech/api/vercel/register" \
  -H "Content-Type: application/json" \
  -H "X-Payment: $X_PAYMENT" \
  -d '{"domain":"myagent.com","expectedPrice":9.99}'

{
  "domain": "myagent.com",
  "payment": {
    "txHash": "0xabc...",
    "amount": 9.99,
    "verified": true,
    "protocol": "x402"
  }
}

List registered domains (Vercel)

GET /api/vercel/domains

curl -sS "https://app.otonix.tech/api/vercel/domains"

DNS management

List DNS records

GET /api/vercel/dns/:domain

curl -sS "https://app.otonix.tech/api/vercel/dns/myagent.com"

{
  "records": [
    { "id": "rec_xxx", "type": "A", "name": "@", "value": "185.150.0.1", "ttl": 300 }
  ]
}

Add DNS record

POST /api/vercel/dns/:domain

curl -sS -X POST "https://app.otonix.tech/api/vercel/dns/myagent.com" \
  -H "Content-Type: application/json" \
  -d '{"name":"@","type":"A","value":"185.150.0.1","ttl":300}'

Delete DNS record

DELETE /api/vercel/dns/:domain/:recordId

curl -sS -X DELETE "https://app.otonix.tech/api/vercel/dns/myagent.com/rec_xxx"

Local domain records (database)

These endpoints manage Otonix-side domain metadata.

• GET /api/domains — list

• GET /api/domains/:id — read

• POST /api/domains — create

• PATCH /api/domains/:id — update

Update domain (link to agent / sandbox)

Use this to enable autonomous renewal and auto-DNS.

PATCH /api/domains/:id

curl -sS -X PATCH "https://app.otonix.tech/api/domains/uuid" \
  -H "Content-Type: application/json" \
  -d '{
    "autoRenew": true,
    "agentId": "agent-uuid",
    "sandboxId": "sandbox-uuid",
    "dnsRecords": [
      {"type":"A","name":"@","value":"185.150.0.1","ttl":300},
      {"type":"CNAME","name":"www","value":"myagent.com","ttl":300}
    ]
  }'

Domain object

{
  "id": "uuid",
  "name": "myagent.com",
  "status": "active",
  "registeredAt": "2026-02-20T12:00:00.000Z",
  "expiresAt": "2027-02-20T12:00:00.000Z",
  "dnsRecords": [],
  "sandboxId": null,
  "agentId": null,
  "autoRenew": true
}