# Goldprice — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track real-time and historical prices for gold, silver, and other precious metals, plus monitor gold performance metrics and view precious metals news. Get current cryptocurrency prices, lookup gold rates by country, and check gold stock prices all in one place.

**Category:** Finance & Markets | **Website:** [goldprice.org/](https://goldprice.org/) | **Docs:** [parse.bot/marketplace/ff8c2c98-8711-4d81-8c66-df38ee0ffa98/goldprice-org-api](https://parse.bot/marketplace/ff8c2c98-8711-4d81-8c66-df38ee0ffa98/goldprice-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_crypto_prices

Retrieve current cryptocurrency prices including rank, name, market cap, price, supply, 24h volume, and 24h percentage change. Data is sourced from GoldPrice.org's cryptocurrency page. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/get_crypto_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_current_gold_price

Retrieve the current live gold spot price in a specified currency. Returns price per troy ounce, change amount, change percent, and timestamp. The price updates in near real-time during market hours (NY time).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | ISO currency code for the price quote. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/get_current_gold_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>"}'
```

### get_current_silver_price

Retrieve the current live silver spot price in a specified currency. Returns price per troy ounce, change amount, change percent, and timestamp. The price updates in near real-time during market hours (NY time).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | ISO currency code for the price quote. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/get_current_silver_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>"}'
```

### get_gold_price_by_country

Retrieve the gold price for a specific country in its local currency. Maps the country name to its local currency and returns the live spot price. Supported countries: australia, brazil, canada, china, europe, hong kong, india, japan, mexico, russia, saudi arabia, singapore, south africa, switzerland, uae, uk, united kingdom, united states, usa.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country name in lowercase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/get_gold_price_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>"}'
```

### get_gold_price_history

Retrieve historical gold price data going back to 1972. Returns an array of date/price entries ordered most recent first. Each entry includes the date string, unix timestamp, and closing price. The dataset can contain thousands of entries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | ISO currency code for historical prices. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/get_gold_price_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>"}'
```

### get_gold_price_per_gram

Retrieve the current gold price per gram and for various karats (24k, 22k, 18k, 14k, 10k). Calculated from the live spot price by dividing by 31.1035 grams per troy ounce and applying karat purity ratios.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | ISO currency code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/get_gold_price_per_gram \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>"}'
```

### get_gold_price_performance

Retrieve gold price performance over multiple time periods (Today, 30 Days, 6 Months, 1 Year, 5 Years, 20 Years). Each period includes the dollar change amount and percentage change. Useful for comparing short-term and long-term gold trends.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | ISO currency code for performance data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/get_gold_price_performance \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>"}'
```

### get_gold_stocks_prices

Retrieve the list of gold mining companies and their country of origin from GoldPrice.org. Returns company name, country, and link to their detail page. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/get_gold_stocks_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_precious_metals_news

Retrieve the latest precious metals news articles from GoldPrice.org. Returns article titles and URLs. Typically returns 10-20 recent articles covering gold market movements, Fed policy impacts, and geopolitical drivers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-goldprice-org-api-ff8c2c98/get_precious_metals_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```