Precio del oro API
Precios en directo de oro, plata, platino, paladio y cobre, tipos de cambio, historial diario y velas, con solicitudes GET sencillas y una clave de API.
Referencia
- URL base
- https://goldapi.dev/api/v1
- Autenticación
- Tu clave en la cabecera X-API-Key
- Formato de respuesta
- JSON
- Plan gratuito
- 100 solicitudes por hora, sin tarjeta
curl --fail-with-body --max-time 10 "https://goldapi.dev/api/v1/price/XAU/USD" \ -H "X-API-Key: $API_KEY"const res = await fetch("https://goldapi.dev/api/v1/price/XAU/USD", { headers: { "X-API-Key": process.env.API_KEY }, signal: AbortSignal.timeout(10_000),});if (!res.ok) throw new Error("HTTP " + res.status);console.log(await res.json());import os, requestsres = requests.get( "https://goldapi.dev/api/v1/price/XAU/USD", headers={"X-API-Key": os.environ["API_KEY"]}, timeout=10,)res.raise_for_status()print(res.json())package mainimport ( "fmt" "io" "net/http" "os" "time")func main() { client := http.Client{Timeout: 10 * time.Second} req, err := http.NewRequest("GET", "https://goldapi.dev/api/v1/price/XAU/USD", nil) if err != nil { panic(err) } req.Header.Set("X-API-Key", os.Getenv("API_KEY")) res, err := client.Do(req) if err != nil { panic(err) } defer res.Body.Close() body, err := io.ReadAll(res.Body) if err != nil { panic(err) } if res.StatusCode != 200 { panic(fmt.Sprintf("HTTP %d: %s", res.StatusCode, body)) } fmt.Println(string(body))}import java.io.IOException;import java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.time.Duration;public class Main { public static void main(String[] args) throws Exception { HttpRequest request = HttpRequest.newBuilder(URI.create("https://goldapi.dev/api/v1/price/XAU/USD")) .header("X-API-Key", System.getenv("API_KEY")) .timeout(Duration.ofSeconds(10)) .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); if (response.statusCode() != 200) throw new IOException("HTTP " + response.statusCode()); System.out.println(response.body()); }}import Foundationvar request = URLRequest(url: URL(string: "https://goldapi.dev/api/v1/price/XAU/USD")!)request.setValue(ProcessInfo.processInfo.environment["API_KEY"], forHTTPHeaderField: "X-API-Key")request.timeoutInterval = 10let (data, response) = try await URLSession.shared.data(for: request)guard (response as? HTTPURLResponse)?.statusCode == 200 else { throw URLError(.badServerResponse) }print(String(data: data, encoding: .utf8)!)$context = stream_context_create(["http" => [ "header" => "X-API-Key: " . getenv("API_KEY"), "timeout" => 10,]]);$body = file_get_contents("https://goldapi.dev/api/v1/price/XAU/USD", false, $context);if ($body === false) throw new RuntimeException("Request failed");echo $body;Respuesta 200
{
"symbol": "XAU",
"name": "Gold",
"currency": "USD",
"unit": "oz",
"price": 4072.1,
"gram": 130.921,
"karat": 24,
"updatedAt": "2026-11-07T02:40:07+02:00"
}
Un endpoint para cada tarea
Datos de metales para tus aplicaciones
Guías prácticas
Preguntas frecuentes
¿La API de precios del oro es gratuita?
Sí. Free incluye 100 solicitudes por hora, precios al contado en tiempo real de oro, plata, cobre, platino y paladio, y tipos de cambio. No se requiere tarjeta de crédito. Free permite el uso comercial con un enlace visible.
¿Es una buena API para datos de precios de materias primas?
Sí. Todos los planes incluyen precios al contado en tiempo real de oro, plata, cobre, platino y paladio, con conversión a otras monedas. Basic, por $8/mes, añade historial diario.
¿Qué fuentes alimentan la API?
Los precios spot vienen de nuestra fuente de datos de mercado. Los precios en otras monedas son el spot en USD × tipos de cambio en directo, y el oro en EGP sigue además el mercado local de Egipto. Cada respuesta incluye la hora de su cálculo.
¿Se permite el uso comercial?
Todos los planes permiten el uso comercial. Free requiere un enlace visible a goldapi.dev junto a los precios. Redistribuir o revender los propios datos requiere un acuerdo aparte: [email protected].