一次 HTTP 调用，发现理想域名

每次查询仅需 $0.002。无需 API 密钥，无需注册，无频率限制。

告诉你的 🦞 智能体： curl https://finddomain.io/skill.md

通过 x402 在 Base 链上结算

几分钟内即可为你的智能体或 SaaS 添加域名发现功能。每次调用独立计价和结算 — 无配额，无账单面板。

工作原理

1
安装 SDK
```
npm install @x402/fetch @x402/evm viem
```
2
设置钱包密钥
只需一个环境变量：PRIVATE_KEY。这是唯一的配置。
3
调用 fetch()
支付自动完成。你将收到包含域名建议或可用性状态的 JSON 响应。

价格

端点	价格	返回内容
`GET /suggest?query=…`	$0.002	算法域名建议（词干提取、IDN 标准化）
`GET /status?domain=…&scope=estimate`	$0.003	域名可用性估算（基于 DNS，无注册局查询）
`GET /status?domain=…`	$0.010	精确的注册局级别可用性查询

价格以 Base 主网上的 USDC 计（ERC-20，eip155:8453）。$0.002 = 2,000 原子单位。

参数

端点	参数	说明
`/suggest`	`query` *	搜索词
	`defaults`	逗号分隔的默认域区（如 `com,io,co`）
	`keywords`	逗号分隔的关键词种子（如 `food,kitchen`）
	`location`	两位国家代码，用于地理相关域区（如 `de`）
	`vendor`	注册商域名，用于筛选支持的域区（如 `dnsimple.com`）
`/status`	`domain` *	要查询的完整域名（如 `tea.com`）
`/status`	`scope`	设为 `estimate` 以使用 DNS 查询（$0.003 而非 $0.010）

* 必填

GET /suggest?query=tea

{
  "results": [
    { "domain": "tea.com", "subdomain": "tea.", "zone": "com" },
    { "domain": "tea.house", "subdomain": "tea.", "zone": "house" },
    { "domain": "tea.cafe", "subdomain": "tea.", "zone": "cafe" }
  ]
}

GET /status?domain=tea.com

{
  "domain": "tea.com",
  "zone": "com",
  "status": "active",
  "tags": "generic"
}

建议结果不包含可用性信息 — 使用 /status 查询特定域名。

快速开始

import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, {
  signer: privateKeyToAccount(process.env.PRIVATE_KEY),
});
const fetch = wrapFetchWithPayment(globalThis.fetch, client);

// 域名建议
const suggestions = await fetch("https://finddomain.io/suggest?query=tea");
console.log(await suggestions.json());

// 精确可用性查询
const status = await fetch("https://finddomain.io/status?domain=tea.com");
console.log(await status.json());

@x402/fetch 自动处理 402 → 签名 → 重试流程。安装：npm install @x402/fetch @x402/evm viem

import os
from x402.client import Client
from eth_account import Account

account = Account.from_key(os.environ["PRIVATE_KEY"])
client = Client(account)

# 域名建议
suggestions = client.get("https://finddomain.io/suggest", params={"query": "tea"})
print(suggestions.json())

# 精确可用性查询
status = client.get("https://finddomain.io/status", params={"domain": "tea.com"})
print(status.json())

x402 Python SDK 自动处理支付。安装：pip install x402

智能体集成

finddomain.io 专为 AI 智能体打造。任何拥有 x402 兼容钱包并在 Base 上持有 USDC 的智能体都可以自主调用 API — 无需用户交互，无需管理 API 密钥。

curl https://finddomain.io/skill.md

技能文件记录了所有端点、x402 支付流程、示例响应和错误处理。

什么是 x402？

x402 是基于 402 Payment Required HTTP 状态码的开放支付协议。当客户端调用受保护的端点时，服务器返回包含价格和支付地址的机器可读 PAYMENT-REQUIRED 头部。客户端签署 USDC 授权（EIP-3009，无 Gas 费）并重试请求。服务器验证后在链上结算，然后返回资源。无需账户，无需 API 密钥 — 支付即认证。

了解更多：x402.org