---
title: "金価格 API クイックスタート"
description: "API キーなしで数分以内に最初の金価格リクエストを送信。prices エンドポイントと XAU-USD-SPOT の指定方法、JSON レスポンスの読み方を解説します。"
canonical: "https://goldprice.dev/ja/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/ja/docs/quickstart
