# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-bullionvault-com-api-929a4e84/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-bullionvault-com-api-929a4e84/get_all_live_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bullionvault-com-api-929a4e84/get_daily_audit \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bullionvault-com-api-929a4e84/get_gold_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bullionvault-com-api-929a4e84/get_latest_trades \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bullionvault-com-api-929a4e84/get_live_gold_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bullionvault-com-api-929a4e84/get_live_silver_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bullionvault-com-api-929a4e84/get_price_chart_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"<string>","metal":"<string>","time_scale":"<string>"}'
```