---
title: "黄金价格 API 快速入门"
description: "无需 API 密钥，几分钟内发送第一个黄金价格请求：介绍 prices 端点、XAU-USD-SPOT 代码的用法，以及如何读取 JSON 响应。"
canonical: "https://goldprice.dev/zh/docs/quickstart"
---

# 黄金价格 API 快速入门

几分钟内发送第一个价格请求。

## 请求最新价格

使用 prices 端点并传入 XAU-USD-SPOT。此请求无需密钥即可试用。

```bash
curl "https://api.goldprice.dev/v1/prices?symbol=XAU-USD-SPOT"
```

## 读取响应

JSON 包含价格、货币和更新时间。只有指定 ?include=sources 时才会显示数据源。

```json
{
  "symbols": [
    {
      "symbol": "XAU",
      "quote_currency": "USD",
      "unit": "troy_ounce",
      "contract_type": "spot",
      "price": "4012.75",
      "is_stale": false,
      "computed_at": "2026-10-23T07:00:18.221118+00:00"
    }
  ]
}
```

## 添加 API 密钥

通过 Bearer 令牌或 X-API-Key 请求头发送密钥。请将密钥保存在服务器上。

```http
Authorization: Bearer YOUR_KEY
```

Source: https://goldprice.dev/zh/docs/quickstart
