---
title: "البدء السريع مع API أسعار الذهب"
description: "أرسل أول طلب لسعر الذهب خلال دقائق ومن دون مفتاح API: نقطة النهاية prices والرمز XAU-USD-SPOT وطريقة قراءة استجابة JSON من goldprice.dev."
canonical: "https://goldprice.dev/ar/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/ar/docs/quickstart
