适用场景这个接口能解决什么问题域名交易市场 API 提供 EDNS 交易平台的公开成交数据适用于以下场景域名投资扫货设定用量说明上限、域名长度和后缀定时拉取列表发现心仪短域名后通过自动化通知工具提醒。行业研究分析统计不同后缀的成交均价、活跃度辅助判断市场趋势。估值参考结合历史成交用量说明为待售域名提供市场对标数据。资产监控跟踪特定后缀或关键词域名的出现频率监控市场热度变化。接口能力边界在开发前需要明确几个约束项目说明请求方法GET基础 URLhttps://v1.apizero.cn/api/domain-tradeQPS 限制5 次/秒超过返回 429 Too Many Requests数据来源仅 EDNS 域名交易市场公开数据分页上限每页最多 100 条默认 50 条参数关系所有参数均为 AND 逻辑筛选交集结果数据并非实时流式而是基于服务端缓存快照更新频率请以官方文档为准。请求鉴权与参数详解鉴权方式在 HTTP 请求头中携带 API KeyX-API-Key: 你的 API KeyAPI Key 需从平台获取建议通过环境变量注入避免硬编码。Query 参数表参数名必填类型说明默认值page否number页码从 1 开始1pagesize否number每页返回数量≤10050max_price否number最高用量说明单位元不限max_length否number域名最大字符长度不含后缀不限suffix否string后缀如.com、.cn不限sale_type否string交易类型如一口价、竞价不限参数组合示例查询 5 位以内、用量说明不超过 300的 .com 域名max_price3000max_length5suffix.com查询所有后缀为 .top 的竞价中域名suffix.topsale_type竞价获取第 3 页数据page3pagesize100使用 curl 快速验证建议先通过 curl 确认接口连通性和参数效果。以下示例替换$APIZERO_API_KEY为真实 Keycurl -sS \ -X GET \ -H X-API-Key: $APIZERO_API_KEY \ https://v1.apizero.cn/api/domain-trade?page1pagesize2max_price10000suffix.com返回的 JSON 结构如下已格式化{ code: 0, msg: 成功, data: { count: 2, current_page: 1, total_pages: 1234, list: [ { name: abc.com, price: 5000, sale_type: 一口价 }, { name: example.io, price: 8888, sale_type: 一口价 } ] } }price字段为字符串类型便于高精度显示sale_type为交易类型描述。返回值字段解析外层结构字段类型说明codenumber业务状态码0 表示成功非0 表示业务异常msgstring状态描述成功时为“成功”dataobject核心数据容器data 内部字段字段类型说明countnumber当前页实际返回的记录数current_pagenumber当前页码total_pagesnumber总页数可用于遍历listarray域名交易记录数组list 中每个元素的字段字段类型说明namestring域名全名包含后缀如abc.compricestring交易用量说明元字符串类型sale_typestring交易类型如一口价、竞价注意price使用字符串而非数字是为了避免浮点精度丢失。在代码中建议使用parseFloat或Decimal库处理。常见错误与排查思路HTTP 状态码常见原因解决策略200正常解析 JSON 并检查code字段401API Key 缺失或无效检查X-API-Key请求头是否正确设置429请求频率超限加入延迟≥200ms 间隔或实施指数退避重试500服务端临时异常稍后重试若持续则联系技术支持业务错误通过code体现例如参数格式错误时code为 10001msg包含具体提示。务必同时校验 HTTP 状态码与业务code。工程化封装建议将 curl 原型转化为生产级代码时需要处理以下要点。1. 封装请求函数以 Python 为例使用requests库封装import os import requests API_BASE https://v1.apizero.cn/api/domain-trade API_KEY os.getenv(APIZERO_API_KEY) def fetch_domain_trade(params: dict) - dict: headers {X-API-Key: API_KEY} resp requests.get(API_BASE, paramsparams, headersheaders) resp.raise_for_status() # 非 2xx 时抛出异常 data resp.json() if data.get(code) ! 0: raise ValueError(fAPI error {data[code]}: {data.get(msg)}) return data[data]2. 完整分页遍历由于每页最多 100 条获取全量数据需要逐页拉取。注意控制请求频率import time def get_all_domains(params: dict, max_pages: int None): base_params params.copy() base_params[pagesize] 100 page 1 all_items [] total_pages 1 while page total_pages: base_params[page] page data fetch_domain_trade(base_params) all_items.extend(data[list]) total_pages data[total_pages] if max_pages and page max_pages: break page 1 time.sleep(0.25) # 控制 QPS ≤ 4留余量 return all_items3. 错误重试与退避针对 429 或临时网络波动加入重试逻辑import time def fetch_with_retry(params: dict, retries: int 3): for attempt in range(retries): try: return fetch_domain_trade(params) except (requests.exceptions.RequestException, ValueError) as e: if attempt retries - 1: raise wait 2 ** attempt print(fRetry {attempt1} after {wait}s: {e}) time.sleep(wait)4. 参数校验与默认值在入口处统一校验参数合法性例如pagesize超过 100 时截断为 100。suffix缺少点号时自动补全如输入com转为.com。整数参数传错格式时提前告警。5. 日志与监控生产环境中建议记录每次调用的耗时、请求 URL、返回状态码、返回记录数便于排查异常和观察数据趋势import logging logger logging.getLogger(__name__) def fetch_domain_trade_with_log(params): start time.time() result fetch_domain_trade(params) elapsed time.time() - start logger.info(fFetched page {params.get(page)} in {elapsed:.2f}s, count{result[count]}) return result参考文档接口文档页https://apizero.cn/aidocs/domain-trade原始 Markdown 文档https://apizero.cn/aidocs/domain-trade/raw.md