GoldPrice
Harga emas, perak & crypto live + grafik, historis, ETF, saham tambang, berita, dan kalkulator. Sumber data publik goldprice.
Spot
Harga spot emas & perak live (per oz/gram/kg), any currency.
/v1/finance:goldprice/spotParameters
| Name | Type | In | Description |
|---|---|---|---|
| currency | string | query | Kode mata uang ISO (mis. USD, IDR, EUR). Default USD. |
Example response
{"project":"finance:goldprice", "data": {"asOf":"Jun 14th 2026, 01:41:25 am NY", "gold": {"change":112.885,"pricePerKg":135383.74,"pricePerOz":4210.905,"pricePerGram":135.3837,"changePercent":2.7546,"previousClose":4098.02 }, "silver": {"change":3.8419,"pricePerKg":2179.23,"pricePerOz":67.7815,"pricePerGram":2.1792,"changePercent":6.0086,"previousClose":63.9396 },"currency":"USD","timestamp":1781415690581,"goldSilverRatio":62 },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Chart
URL gambar grafik harga (gold/silver, 7d–30y).
/v1/finance:goldprice/chartParameters
| Name | Type | In | Description |
|---|---|---|---|
| metal | enum | query | Logam mulia: gold atau silver. Default gold. One of gold, silver. |
| period | enum | query | Rentang waktu chart. Pilihan: 7d, 30d, 6m, 1y, 2y, 5y, 10y, 15y, 20y, 30y. Default 7d. One of 7d, 30d, 6m, 1y, 2y, 5y, 10y, 15y, 20y, 30y. |
| currency | string | query | Kode mata uang ISO 3-huruf (USD, EUR, GBP, IDR, JPY, dll). Default USD. |
Example response
{"project":"finance:goldprice", "data": {"metal":"gold","period":"7d","currency":"USD","imageUrl":"https://charts.goldprice.org/charts/history/gold_7_day_o_USD_x.png","verified":true, "availablePeriods": [ "7d", "30d", "6m", "1y", "2y", "5y", "10y", "15y" ] },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Crypto
Harga cryptocurrency live (BTC/ETH/SOL/dll) + market cap.
/v1/finance:goldprice/cryptoParameters
| Name | Type | In | Description |
|---|---|---|---|
| ids | string | query | Daftar id koin dipisah koma (mis. bitcoin,ethereum,solana,ripple,dogecoin). Default "bitcoin,ethereum,solana,ripple,dogecoin". Max 50 koin. |
| currency | enum | query | Mata uang harga: usd, idr, eur, gbp, jpy, sgd, aud, btc, eth. Default usd. One of usd, idr, eur, gbp, jpy, sgd, aud, btc, eth. |
Example response
{"project":"finance:goldprice", "data": {"count":3, "items": [ {"id":"bitcoin","ath":126080,"name":"Bitcoin","rank":1,"image":"https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400","price":64328,"low24h":63486,"symbol":"BTC","high24h":64633,"change24h":777.02,"marketCap":1288787081171,"volume24h":18113239771,"lastUpdated":"2026-06-14T05:41:38.195Z","totalSupply":20042446,"athChangePercent":-48.98,"changePercent24h":1.22,"circulatingSupply":20042437 }, {"id":"ethereum","ath":4946.05,"name":"Ethereum","rank":2,"image":"https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628","price":1676.5,"low24h":1662.23,"symbol":"ETH","high24h":1688.12,"change24h":12.19,"marketCap":202192671812,"volume24h":6621220095,"lastUpdated":"2026-06-14T05:41:37.677Z","totalSupply":120684209.1147544,"athChangePercent":-66.1,"changePercent24h":0.73,"circulatingSupply":120684209.1147544 }, {"id":"solana","ath":293.31,"name":"Solana","rank":7,"image":"https://coin-images.coingecko.com/coins/images/4128/large/solana.png?1718769756","price":68.17,"low24h":66.64,"symbol":"SOL","high24h":69.36,"change24h":1.42,"marketCap":39519480119,"volume24h":1665123302,"lastUpdated":"2026-06-14T05:41:37.417Z","totalSupply":628303502.7848742,"athChangePercent":-76.76,"changePercent24h":2.13,"circulatingSupply":579823662.913511 } ],"currency":"USD" },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
News
Daftar berita pasar emas/perak.
/v1/finance:goldprice/newsParameters
| Name | Type | In | Description |
|---|---|---|---|
| page | number | query | Nomor halaman, default 1. |
| count | number | query | Item per halaman, default 20 (max 50). |
| category | string | query | Filter opsional (keyword pada judul/slug, mis. 'fed' atau 'inflation'). |
Example response
{"project":"finance:goldprice", "data": {"page":1,"count":5, "items": [ {"url":"https://goldprice.org/news/gold-pulls-back-inflation-pressure-reprices-fed-path","slug":"gold-pulls-back-inflation-pressure-reprices-fed-path","image":"https://goldprice.org/sites/default/files/styles/blog_hero_375/public/blog_hero_images/Gold-Price-Recap1_6.jpg?itok=rvvHfSPF","title":"Gold Pulls Back as Inflation Pressure Reprices the Fed Path","author":"Matthew Bolden","publishedAt":"2026-06-12T14:31:49-04:00" }, {"url":"https://goldprice.org/news/jobs-shock-knocks-gold-below-4400-fed-cut-hopes-fade","slug":"jobs-shock-knocks-gold-below-4400-fed-cut-hopes-fade","image":"https://goldprice.org/sites/default/files/styles/blog_hero_375/public/blog_hero_images/Gold-Price-Recap1_5.jpg?itok=hGQiYGdB","title":"Jobs Shock Knocks Gold Below $4,400 as Fed Cut Hopes Fade","author":"Matthew Bolden","publishedAt":"2026-06-05T13:42:18-04:00" }, {"url":"https://goldprice.org/news/de-escalation-headlines-weigh-on-gold-ahead-of-memorial-day","slug":"de-escalation-headlines-weigh-on-gold-ahead-of-memorial-day","image":"https://goldprice.org/sites/default/files/styles/blog_hero_375/public/blog_hero_images/Gold-Price-Recap%20%281%29_12.jpg?itok=fYRM7OWK","title":"De-Escalation Headlines Weigh on Gold Ahead of Memorial Day","author":"Matthew Bolden","publishedAt":"2026-05-22T15:47:47-04:00" } ],"hasMore":false },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Article
Isi artikel berita (input slug dari endpoint news).
/v1/finance:goldprice/article/:slugParameters
| Name | Type | In | Description |
|---|---|---|---|
| slug | string | path | Slug artikel (atau full URL goldprice.org/news/...). Required. |
Example response
{"project":"finance:goldprice", "data": {"url":"https://goldprice.org/news/gold-pulls-back-inflation-pressure-reprices-fed-path","slug":"gold-pulls-back-inflation-pressure-reprices-fed-path","image":"https://goldprice.org/sites/default/files/styles/blog_hero/public/blog_hero_images/Gold-Price-Recap1_6.jpg?itok=qLiud1Ae","title":"Gold Pulls Back as Inflation Pressure Reprices the Fed Path","author":"Matthew Bolden","source":"goldprice.org","contentText":"Happy Friday, traders. Welcome to our weekly market wrap, where we take a look back at these last five trading days with a focus on the market news, economic data, and headlines th…","publishedAt":"2026-06-12T14:31:49-04:00", "relatedSlugs": [ "jobs-shock-knocks-gold-below-4400-fed-cut-hopes-fade", "de-escalation-headlines-weigh-on-gold-ahead-of-memorial-day", "gold-falls-toward-4550-fed-cut-hopes-fade" ] },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Performance
Performa harga historis multi-periode (USD/GBP, EOD).
/v1/finance:goldprice/performanceParameters
| Name | Type | In | Description |
|---|---|---|---|
| metal | enum | query | Logam: gold (XAU) atau silver (XAG). Default gold. One of gold, silver. |
| range | enum | query | Panjang deret yang ditarik. Nilai yang diterima upstream persis lima ini — 3M, YTD, 2Y dan MAX ditolak dengan "Unknown range". Default 10Y supaya semua periode di bawah bisa dihitung. One of 1M, 6M, 1Y, 5Y, 10Y. |
Example response
{"project":"finance:goldprice", "data": {"asOf":"2026-05-01","note":"Performa dihitung dari data penutupan harian (EOD) sumber; bukan harga spot live. `asOf` adalah tanggal data terakhir yang tersedia.","metal":"gold","source":"historical-eod","symbol":"XAU","current":4636.9, "periods": [ {"label":"1M","changeAbs":-102.1,"priceThen":4739,"changePercent":-2.15,"priceThenDate":"2026-04-01" }, {"label":"3M","changeAbs":-344.95,"priceThen":4981.85,"changePercent":-6.92,"priceThenDate":"2026-01-30" }, {"label":"6M","changeAbs":625.4,"priceThen":4011.5,"changePercent":15.59,"priceThenDate":"2025-10-31" }, {"label":"YTD","changeAbs":269.1,"priceThen":4367.8,"changePercent":6.16,"priceThenDate":"2025-12-30" }, {"label":"1Y","changeAbs":1422.15,"priceThen":3214.75,"changePercent":44.24,"priceThenDate":"2025-05-01" }, {"label":"2Y","changeAbs":2334.55,"priceThen":2302.35,"changePercent":101.4,"priceThenDate":"2024-05-01" }, {"label":"5Y","changeAbs":2869.25,"priceThen":1767.65,"changePercent":162.32,"priceThenDate":"2021-04-30" } ],"chartUrl":"https://goldprice.org/charts/gold-price-performance-USD_x.png","currency":"USD" },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
ETFs
Daftar ETF emas/perak (name, country, ticker via enrich).
/v1/finance:goldprice/etfsParameters
| Name | Type | In | Description |
|---|---|---|---|
| metal | enum | query | Logam: gold atau silver. One of gold, silver. |
| page | number | query | Halaman (1,2,3). Default 1. |
| limit | number | query | Item per halaman (default 50, max 100). |
| country | string | query | Filter negara (mis. "United States", "Canada"). Opsional. |
| enrich | enum | query | true = ambil ticker+exchange dari halaman detail (lebih lambat). Default false. One of true, false. |
Example response
{"project":"finance:goldprice", "data": {"page":1,"count":31, "items": [ {"name":"BMO Junior Gold Index ETF","slug":"bmo-junior-gold-index-etf","country":"Canada","detailUrl":"https://goldprice.org/gold-etfs/bmo-junior-gold-index-etf" }, {"name":"Credit Suisse X-Links Gold Shares Covered Call ETN","slug":"credit-suisse-x-links-gold-shares-covered-call-etn","country":"United States","detailUrl":"https://goldprice.org/gold-etfs/credit-suisse-x-links-gold-shares-covered-call-etn" }, {"name":"DB Gold Double Long Exchange Traded Notes","slug":"db-gold-double-long-exchange-traded-notes","country":"United States","detailUrl":"https://goldprice.org/gold-etfs/db-gold-double-long-exchange-traded-notes" }, {"name":"DB Gold Double Short Exchange Traded Notes","slug":"db-gold-double-short-exchange-traded-notes","country":"United States","detailUrl":"https://goldprice.org/gold-etfs/db-gold-double-short-exchange-traded-notes" }, {"name":"Direxion Daily Gold Miners Bear 3X Shares","slug":"direxion-daily-gold-miners-bear-3x-shares","country":"United States","detailUrl":"https://goldprice.org/gold-etfs/direxion-daily-gold-miners-bear-3x-shares" }, {"name":"Direxion Daily Gold Miners Bull 3X Shares","slug":"direxion-daily-gold-miners-bull-3x-shares","country":"United States","detailUrl":"https://goldprice.org/gold-etfs/direxion-daily-gold-miners-bull-3x-shares" }, {"name":"Direxion Daily Gold Miners Index Bear 1X Shares","slug":"direxion-daily-gold-miners-index-bear-1x-shares","country":"United States","detailUrl":"https://goldprice.org/gold-etfs/direxion-daily-gold-miners-index-bear-1x-shares" }, {"name":"Direxion Daily Junior Gold Index Bear 3X Shares","slug":"direxion-daily-junior-gold-index-bear-3x-shares","country":"United States","detailUrl":"https://goldprice.org/gold-etfs/direxion-daily-junior-gold-index-bear-3x-shares" } ],"limit":50,"metal":"gold","total":31,"dataset":"etfs","hasMore":false,"enriched":false },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Stocks
Daftar saham tambang emas/perak.
/v1/finance:goldprice/stocksParameters
| Name | Type | In | Description |
|---|---|---|---|
| metal | enum | query | Logam: gold atau silver. One of gold, silver. |
| page | number | query | Halaman (1,2,3). Default 1. |
| limit | number | query | Item per halaman (default 50, max 100). |
| country | string | query | Filter negara (mis. "United States", "Canada"). Opsional. |
| enrich | enum | query | true = ambil ticker+exchange dari halaman detail (lebih lambat). Default false. One of true, false. |
Example response
{"project":"finance:goldprice", "data": {"page":1,"count":50, "items": [ {"name":"African Gold Group","slug":"african-gold-group","country":"United States","detailUrl":"https://goldprice.org/gold-stocks/african-gold-group" }, {"name":"African Gold Group TSXV","slug":"african-gold-group-tsxv","country":"Canada","detailUrl":"https://goldprice.org/gold-stocks/african-gold-group-tsxv" }, {"name":"Agnico-Eagle Mines","slug":"agnico-eagle-mines","country":"United States","detailUrl":"https://goldprice.org/gold-stocks/agnico-eagle-mines" }, {"name":"Agnico-Eagle Mines TSX","slug":"agnico-eagle-mines-tsx","country":"Canada","detailUrl":"https://goldprice.org/gold-stocks/agnico-eagle-mines-tsx" }, {"name":"Alacer Gold","slug":"alacer-gold","country":"United States","detailUrl":"https://goldprice.org/gold-stocks/alacer-gold" }, {"name":"Alacer Gold TSX","slug":"alacer-gold-tsx","country":"Canada","detailUrl":"https://goldprice.org/gold-stocks/alacer-gold-tsx" }, {"name":"Alamos Gold","slug":"alamos-gold","country":"United States","detailUrl":"https://goldprice.org/gold-stocks/alamos-gold" }, {"name":"Alamos Gold TSX","slug":"alamos-gold-tsx","country":"Canada","detailUrl":"https://goldprice.org/gold-stocks/alamos-gold-tsx" } ],"limit":50,"metal":"gold","total":264,"dataset":"stocks","hasMore":true,"enriched":false },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Exchanges
Panduan beli emas per negara.
/v1/finance:goldprice/exchangesParameters
| Name | Type | In | Description |
|---|---|---|---|
| country | string | query | Country slug (canada, singapore, switzerland, united-kingdom, united-states). Aliases like usa/uk accepted. |
Example response
{"project":"finance:goldprice", "data": {"note":"Halaman upstream berupa panduan membeli emas (prose), bukan daftar dealer/exchange ber-rating. `items` berisi tautan sumber/produk yang ada pada panduan.","count":4, "guide": [ "If you are looking to buy gold in the United States, you have numerous choices when it comes to where you purchase your gold. Local coin and bullion shops and online gold and silve…", "Local coin and bullion shops may carry various types of gold bullion bars and coins, as well as numismatics and collectibles. Such shops may, however, carry smaller inventories and…", "Online precious metals dealers tend to offer a much wider variety of bullion coins and bars, as well as numismatics and collectibles. Online coin and bullion dealers tend to have s…" ], "items": [ {"url":"https://goldprice.org/gold-prices/Gold-Bars.htm","name":"gold bullion bars" }, {"url":"https://goldprice.org/gold-bars/1-oz.htm","name":"1 ounce gold bar" }, {"url":"https://goldprice.org/gold-prices/1003-Gold-Coins/1001-American-Gold-Eagle.htm","name":"American Gold Eagle coins" } ],"metal":"gold","title":"USA","country":"united-states" },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Convert
Kalkulator nilai emas/perak (weight×spot, unit+purity).
/v1/finance:goldprice/convertParameters
| Name | Type | In | Description |
|---|---|---|---|
| metal | enum | query | Logam mulia yang dihitung: gold atau silver. Default gold. One of gold, silver. |
| weight | number | query | Berat logam (harus > 0), satuannya ditentukan param `unit`. Required. |
| unit | enum | query | Satuan berat: oz (troy ounce), gram, kg, tola, tael (HK). Default gram. One of oz, gram, kg, tola, tael. |
| currency | string | query | Mata uang nilai output (kode ISO 3 huruf, mis. USD, IDR, EUR). Default USD. |
| purity | number | query | Kemurnian logam 0..1 (mis. 0.999 fine, 0.75 untuk 18k emas). Default 1. |
Example response
{"project":"finance:goldprice", "data": {"asOf":"2026-06-14T05:41:48.763Z","unit":"gram","metal":"gold","purity":1,"weight":10,"currency":"USD","pricePerOz":4210.905,"totalValue":1353.84,"pricePerGram":135.383739 },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:goldprice", "spot", { currency: "USD" });
GoldPrice
Harga emas, perak & crypto live + grafik, historis, ETF, saham tambang, berita, dan kalkulator. Sumber data publik goldprice.
Harga spot emas & perak live (per oz/gram/kg), any currency.
/v1/…goldprice/spotTry it
Parameters
currency
string · query · optional
Kode mata uang ISO (mis. USD, IDR, EUR). Default USD.
Example response
{"project":"finance:goldprice", "data": {"asOf":"Jun 14th 2026, 01:41:25 am NY", "gold": {"change":112.885,"pricePerKg":135383.74,"pricePerOz":4210.905,"pricePerGram":135.3837,"changePercent":2.7546,"previousClose":4098.02 }, "silver": {"change":3.8419,"pricePerKg":2179.23,"pricePerOz":67.7815,"pricePerGram":2.1792,"changePercent":6.0086,"previousClose":63.9396 },"currency":"USD","timestamp":1781415690581,"goldSilverRatio":62 },"timestamp":"2026-06-14T06:24:09Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:goldprice", "spot", { currency: "USD" });