本页为历史拍卖样本，仅反映本站收录范围，不代表当前估值。缺失成交金额显示“未披露”。美元成交价的原币、佣金及换算依据按每条记录标注；历史参考换算不代表实际结算价或当前估值。

价格口径：price_final_usd 为已记录的美元成交金额（可含小数）；未披露或未成交时为 null，请勿替换为 0。兼容字段 price_final_hkd 为 null，不按当前汇率即时换算。逐条核对与计价依据见 data.source（列表为 data[].source）及 price_policy；列表支持 verified_only=1 仅看已核对。美元成交价的原币、佣金及换算依据按每条记录标注；历史参考换算不代表实际结算价或当前估值。

API接口列表

完整的API接口列表，包含所有可用的宝石拍卖数据接口

拍卖记录 获取宝石拍卖记录数据

GET /api/v1/auctions

获取拍卖记录列表

参数说明
参数名 类型 必填 默认值 示例值 说明
page integer 否 1 - 页码
limit integer 否 20 - 每页数量（最大100）
gem_name string 否 - - 宝石类型筛选
origin string 否 - - 产地筛选
auction_house string 否 - - 拍卖行筛选
is_sold boolean 否 - - 是否成交筛选
weight_min float 否 - - 最小重量（克拉）
weight_max float 否 - - 最大重量（克拉）
price_min integer 否 - - 最低价格（美元）
price_max integer 否 - - 最高价格（美元）
date_from date 否 - - 开始日期
date_to date 否 - - 结束日期
响应格式
{
    "success": "boolean",
    "data": "array",
    "pagination": "object",
    "meta": "object"
}
在线测试 查看示例
GET /api/v1/auctions/{id}

获取单个拍卖详情

参数说明
参数名 类型 必填 默认值 示例值 说明
id integer 是 - - 拍卖记录ID
响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例
GET /api/v1/auctions/latest

获取最新拍卖记录

参数说明
参数名 类型 必填 默认值 示例值 说明
limit integer 否 10 - 返回数量（最大50）
响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例
GET /api/v1/auctions/search

搜索拍卖记录

参数说明
参数名 类型 必填 默认值 示例值 说明
q string 是 - - 搜索关键词
page integer 否 1 - 页码
limit integer 否 20 - 每页数量
响应格式
{
    "success": "boolean",
    "data": "array",
    "search": "object"
}
在线测试 查看示例

统计数据 获取各种统计数据

GET /api/v1/stats

仅用已核对成交；整体均价、总额及成交率兼容字段返回 null，使用 sample_summary 和 price_groups 查看分母与分组价格。

响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例
GET /api/v1/stats/market

仅统计已核对且已成交的历史样本；sample_summary 给出各分母，price_groups 按品种、佣金和美元依据分组。meta.updated_at/checked_at 为资料时间，timestamp 仅为响应时间；不提供混算整体均价。

参数说明
参数名 类型 必填 默认值 示例值 说明
gem_name string 否 - - 精确筛选宝石品种；省略为全部已核对品种
响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例
GET /api/v1/stats/trends

只用已核对成交。最近三个完整年度，可比条件一致且每年各至少 5 条有效克拉价格样本，才返回 price_trends；不足时为空数组，trend 提供门槛、逐年样本数及缺口。monthly_volume 仅为实际收录的历史月度样本数，不补缺月或推算价格。

参数说明
参数名 类型 必填 默认值 示例值 说明
gem_name string 否 - - 精确筛选宝石品种；审核状态固定为 verified
响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例
GET /api/v1/gemstones

已核对成交样本的品种数量；多价格口径不混算均价。

响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例
GET /api/v1/gemstones/{gemstone}

获取特定宝石类型数据

参数说明
参数名 类型 必填 默认值 示例值 说明
gemstone string 是 - - 宝石类型名称
响应格式
{
    "success": "boolean",
    "data": "object"
}
在线测试 查看示例

价格排行 获取价格排行数据

GET /api/v1/rankings/top-price

仅用已核对且价格依据完整的历史 Lot；默认含佣官方美元，其他佣金和美元依据单独选择。

参数说明
参数名 类型 必填 默认值 示例值 说明
limit integer 否 10 - 返回数量1至50
gem_name string 否 - - 精确品种
price_basis string 否 including_premium - including_premium 或 hammer
usd_basis string 否 official_usd - official_usd 或 historical_fx
响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例
GET /api/v1/rankings/price-per-carat

仅用已核对且价格依据完整的历史 Lot；默认含佣官方美元，其他佣金和美元依据单独选择。

参数说明
参数名 类型 必填 默认值 示例值 说明
limit integer 否 10 - 返回数量1至50
gem_name string 否 - - 精确品种
price_basis string 否 including_premium - including_premium 或 hammer
usd_basis string 否 official_usd - official_usd 或 historical_fx
响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例

搜索建议 获取搜索建议

GET /api/v1/suggestions

获取搜索建议

参数说明
参数名 类型 必填 默认值 示例值 说明
q string 是 - - 搜索关键词
响应格式
{
    "success": "boolean",
    "data": "array"
}
在线测试 查看示例