本页为历史拍卖样本，仅反映本站收录范围，不代表当前估值。缺失成交金额显示“未披露”。美元成交价的原币、佣金及换算依据按每条记录标注；历史参考换算不代表实际结算价或当前估值。
价格口径：
price_final_usd 为已记录的美元成交金额（可含小数）；未披露或未成交时为 null，请勿替换为 0。兼容字段 price_final_hkd 为 null，不按当前汇率即时换算。逐条核对与计价依据见 data.source（列表为 data[].source）及 price_policy；列表支持 verified_only=1 仅看已核对。美元成交价的原币、佣金及换算依据按每条记录标注；历史参考换算不代表实际结算价或当前估值。API概览
15
接口总数
可用的API接口数量
4
接口分类
按功能分类的接口组
JSON
响应格式
统一的数据返回格式
请合理控制调用频率；每页最多 100 条
访问限制
每小时请求限制
快速开始
基础URL
https://www.zxnb.com
示例请求
GET https://www.zxnb.com/api/v1/auctions?page=1&limit=20示例响应
{
"success": true,
"data": [
{
"id": 30,
"title": "祖母绿",
"gem_type": "祖母绿",
"carat": 20.8,
"origin": "哥伦比亚",
"price_final_usd": 46153
}
],
"pagination": {
"current_page": 1,
"total_pages": 2,
"total_records": 25
}
}接口分类
拍卖记录
获取宝石拍卖记录数据
-
GET
/api/v1/auctions获取拍卖记录列表 -
GET
/api/v1/auctions/{id}获取单个拍卖详情 -
GET
/api/v1/auctions/latest获取最新拍卖记录 - ... 还有 1 个接口
统计数据
获取各种统计数据
-
GET
/api/v1/stats仅用已核对成交；整体均价、总额及成交率兼容字段返回 null，使用 sample_summary 和 price_groups 查看分母与分组价格。 -
GET
/api/v1/stats/market仅统计已核对且已成交的历史样本；sample_summary 给出各分母，price_groups 按品种、佣金和美元依据分组。meta.updated_at/checked_at 为资料时间，timestamp 仅为响应时间；不提供混算整体均价。 -
GET
/api/v1/stats/trends只用已核对成交。最近三个完整年度，可比条件一致且每年各至少 5 条有效克拉价格样本，才返回 price_trends；不足时为空数组，trend 提供门槛、逐年样本数及缺口。monthly_volume 仅为实际收录的历史月度样本数，不补缺月或推算价格。 - ... 还有 2 个接口
价格排行
获取价格排行数据
-
GET
/api/v1/rankings/top-price仅用已核对且价格依据完整的历史 Lot；默认含佣官方美元，其他佣金和美元依据单独选择。 -
GET
/api/v1/rankings/price-per-carat仅用已核对且价格依据完整的历史 Lot；默认含佣官方美元，其他佣金和美元依据单独选择。
搜索建议
获取搜索建议
-
GET
/api/v1/suggestions获取搜索建议
使用示例
JavaScript 示例
// 获取拍卖记录
fetch("https://www.zxnb.com/api/v1/auctions?page=1&limit=20")
.then(response => response.json())
.then(data => {
console.log("拍卖记录:", data);
if (data.suc...PHP 示例
<?php
// 获取拍卖记录
$url = "https://www.zxnb.com/api/v1/auctions?page=1&limit=20";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
...Python 示例
import requests
import json
# 获取拍卖记录
url = "https://www.zxnb.com/api/v1/auctions"
params = {
"page": 1,
"limit": 20
}
try:
response = requests.get(url, params=para...