---
title: "Guía inicial de la API del precio del oro"
description: "Envía tu primera solicitud a la API del precio del oro en minutos y sin clave: endpoint prices, símbolo XAU-USD-SPOT y cómo leer la respuesta JSON."
canonical: "https://goldprice.dev/es/docs/quickstart"
---

# Guía inicial de la API del precio del oro

Envía tu primera solicitud de precio en pocos minutos.

## Solicita el precio actual

Usa el endpoint prices con el símbolo XAU-USD-SPOT. Puedes probar esta solicitud sin clave.

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

## Lee la respuesta

El JSON incluye precio, moneda y hora de actualización. La fuente solo aparece con ?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"
    }
  ]
}
```

## Añade una clave API

Envía la clave como token Bearer o en el encabezado X-API-Key. Guarda la clave en el servidor.

```http
Authorization: Bearer YOUR_KEY
```

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