LobsterDomains — AI-Powered Domain Registration with Crypto
Register domain names using cryptocurrency payments. Supports USDC/USDT stablecoins on multiple chains (Ethereum, Arbitrum, Base, Optimism), native ETH, and Bitcoin.
Authentication
Get your API key at https://lobsterdomains.xyz/api-keys (requires Ethereum wallet sign-in).
All requests require a Bearer token:
CODEBLOCK0
Set the environment variable:
CODEBLOCK1
Base URL
CODEBLOCK2
Tools
1. Check Domain Availability
Check if a domain is available and get pricing.
CODEBLOCK3
Parameters:
- -
domain (required): The domain name to check (e.g., example.com)
Response:
CODEBLOCK4
2. Get Current Prices
Retrieve current ETH and BTC prices in USD for payment conversion.
CODEBLOCK5
3. Get TLD Pricing
View pricing for all supported TLDs.
CODEBLOCK6
4. Register a Domain
Complete a domain registration after on-chain payment.
CODEBLOCK7
Request Body:
CODEBLOCK8
Fields:
- -
domain (required): Domain name to register - INLINECODE3 (required): Registration period, 1–10
- INLINECODE4 (required):
USDC, USDT, ETH, or INLINECODE8 - INLINECODE9 (required for stablecoins/ETH):
ethereum, arbitrum, base, or INLINECODE13 - INLINECODE14 (required): On-chain transaction hash proving payment
- INLINECODE15 (required): Registrant contact information with 2-letter country code
- INLINECODE16 (optional): Custom nameservers; defaults to afraid.org
Response:
CODEBLOCK9
Important: The response includes opensrsUsername and opensrsPassword for post-purchase DNS and transfer management. Always present these credentials directly to the user and instruct them to store the credentials securely (e.g., in a password manager). Never persist these credentials in conversation history, logs, or any file. These are sensitive third-party credentials that grant full control over the registered domain.
5. Query Orders
Retrieve order history.
CODEBLOCK10
Returns up to 50 latest orders. Results may include OpenSRS management credentials — always present these to the user directly and remind them to store credentials securely.
Payment Details
Recommended method: USDC or USDT stablecoins (6 decimal places)
Receiving address:
CODEBLOCK11
Supported chains:
- - Ethereum mainnet
- Arbitrum
- Base
- Optimism
Native ETH and Bitcoin are also accepted but require price verification via /api/v1/prices.
Example Workflow
- 1. Check availability: INLINECODE20
- Confirm pricing with the user
- User sends stablecoin payment on their preferred chain
- Capture the transaction hash from the user
- Register:
POST /api/v1/domains/register with tx hash and contact details - Deliver credentials securely — present OpenSRS management details to the user and remind them to save in a password manager
LobsterDomains — 基于加密货币的AI驱动域名注册服务
使用加密货币支付注册域名。支持多种区块链(以太坊、Arbitrum、Base、Optimism)上的USDC/USDT稳定币、原生ETH及比特币。
身份验证
在 https://lobsterdomains.xyz/api-keys 获取您的API密钥(需通过以太坊钱包登录)。
所有请求均需携带Bearer令牌:
Authorization: Bearer ldyourapikeyhere
设置环境变量:
bash
export LOBSTERDOMAINSAPIKEY=ldyourapikeyhere
基础URL
https://lobsterdomains.xyz
工具
1. 检查域名可用性
检查域名是否可注册并获取价格信息。
GET /api/v1/domains/check?domain={domain}
参数:
- - domain(必填):待检查的域名(例如 example.com)
响应:
json
{
available: true,
domain: example.com,
price: 13.50,
currency: USDC
}
2. 获取当前价格
获取当前ETH和BTC的美元价格,用于支付转换。
GET /api/v1/prices
3. 获取TLD定价
查看所有支持顶级域名的定价信息。
GET https://lobsterdomains.xyz/pricing
4. 注册域名
完成链上支付后进行域名注册。
POST /api/v1/domains/register
请求体:
json
{
domain: example.com,
years: 1,
currency: USDC,
chain: base,
txHash: 0x...,
contact: {
firstName: Jane,
lastName: Doe,
organization: Example Inc,
email: jane@example.com,
phone: +1.5551234567,
address: 123 Main St,
city: San Francisco,
state: CA,
postalCode: 94105,
country: US
},
nameservers: [ns1.example.com, ns2.example.com]
}
字段说明:
- - domain(必填):待注册的域名
- years(必填):注册年限,1–10年
- currency(必填):USDC、USDT、ETH 或 BTC
- chain(稳定币/ETH必填):ethereum、arbitrum、base 或 optimism
- txHash(必填):证明已支付的链上交易哈希
- contact(必填):注册人联系信息,需包含两位字母国家代码
- nameservers(可选):自定义域名服务器;默认为 afraid.org
响应:
json
{
orderId: abc123,
domain: example.com,
status: registered,
opensrsUsername: ...,
opensrsPassword: ...,
managementUrl: https://...
}
重要提示: 响应中包含用于购买后DNS和转移管理的opensrsUsername和opensrsPassword。请务必直接向用户展示这些凭据,并指示用户安全存储(例如使用密码管理器)。切勿将这些凭据保留在对话历史、日志或任何文件中。这些是敏感的第三方凭据,可对已注册域名拥有完全控制权。
5. 查询订单
检索订单历史记录。
GET /api/v1/orders
GET /api/v1/orders?domain={domain}
最多返回50条最新订单。结果可能包含OpenSRS管理凭据——请始终直接向用户展示这些信息,并提醒用户安全存储凭据。
支付详情
推荐方式: USDC或USDT稳定币(6位小数)
收款地址:
0x8939E62298779F5fE1b2acda675B5e85CfD594ab
支持的区块链:
- - 以太坊主网
- Arbitrum
- Base
- Optimism
也接受原生ETH和比特币,但需通过 /api/v1/prices 进行价格验证。
工作流程示例
- 1. 检查可用性: GET /api/v1/domains/check?domain=coolstartup.com
- 与用户确认价格
- 用户在其偏好的链上发送稳定币支付
- 获取用户的交易哈希
- 注册: POST /api/v1/domains/register,附带交易哈希和联系详情
- 安全交付凭据 — 向用户展示OpenSRS管理详情,并提醒用户保存至密码管理器