# BullionVault — 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.

> Access live precious metal prices for gold, silver, platinum, and palladium, view historical price charts, monitor the latest trades, and retrieve market news from BullionVault. Daily audit reports provide a transparent view of platform-wide holdings by vault location.

**Category:** Finance & Markets | **Website:** [bullionvault.com/](https://bullionvault.com/) | **Docs:** [parse.bot/marketplace/929a4e84-c221-4be6-b8ad-73f35502b806/bullionvault-com-api](https://parse.bot/marketplace/929a4e84-c221-4be6-b8ad-73f35502b806/bullionvault-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/bullionvault/`
**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 all live prices

Fetch the full live market order book for all metals (Gold, Silver, Platinum, Palladium) across all vaults and currencies. Each pitch contains buy and sell price arrays with quantity, limit price, and value. The weightUnit is KG and prices are per-kilogram. Updates every few seconds during market hours.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bullionvault/get-all-live-prices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get daily audit

Fetch BullionVault's daily holdings audit. Returns tabular data showing total metal holdings by vault location (Zurich, London, New York, Toronto, Singapore) and a detailed breakdown by client nickname initial (A-Z, 0-9) across vault locations. Values are in kilograms.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bullionvault/get-daily-audit \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get gold news

Fetch the latest gold and precious metals news articles from BullionVault's news section. Returns article titles and links. Typically returns 20-30 recent articles covering price analysis, market fundamentals, and investor indices.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bullionvault/get-gold-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get latest trades

Fetch the most recent trades executed on the BullionVault platform. Returns trade details including market name (e.g. 'London gold', 'Zurich silver'), quantity in kg, price per kg with currency symbol, and execution time.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bullionvault/get-latest-trades \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get live gold price

Fetch live gold price data filtered to AUX-prefixed securities across all vaults. Returns buy and sell pitches for gold in USD, GBP, and EUR with quantity and limit price per kilogram.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bullionvault/get-live-gold-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get live silver price

Fetch live silver price data filtered to AGX-prefixed securities across all vaults. Returns buy and sell pitches for silver in USD, GBP, and EUR with quantity and limit price per kilogram.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bullionvault/get-live-silver-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get price chart data

Fetch historical price chart data for a metal in a given currency at a specified time interval. Returns a time series of price points (high, low, latest) plus the current latest price. Not all metal/currency/time_scale combinations may have data available upstream; unsupported combinations return an upstream error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `currency` | string | No | Currency for price valuation: USD, GBP, EUR. |
| `metal` | string | No | Metal to query prices for: GOLD, SILVER, PLATINUM, PALLADIUM. |
| `time_scale` | string | No | Time interval in seconds between data points. Verified working value: 3600 (1 hour). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bullionvault/get-price-chart-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>","metal":"<string>","time_scale":"<string>"}'
```

## Next steps

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