# Goldprice — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/goldprice/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/goldprice/get-crypto-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/goldprice/get-current-gold-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/goldprice/get-current-silver-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/goldprice/get-gold-price-by-country \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/goldprice/get-gold-price-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/goldprice/get-gold-price-per-gram \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/goldprice/get-gold-price-performance \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/goldprice/get-gold-stocks-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/goldprice/get-precious-metals-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.