API Reference

Endpoints documentation

Twelve REST endpoints covering spot prices, historical series, crypto, forex, equities and reference lists. Subscribe through RapidAPI or Zyla API Hub and call them directly from any backend or frontend.

Access the API through

Base URL

https://metal-sentinel.p.rapidapi.com

Append the endpoint path, e.g. /api/metal-quote.

Authentication

Send your RapidAPI key in the X-RapidAPI-Key header and metal-sentinel.p.rapidapi.com in the X-RapidAPI-Host header on every request.

Section

Spot prices

Live spot quotes for any supported metal, in any currency.

GET /api/metal-quote

Current spot price for a precious metal in a given currency.

Query parameters

Name Type Required Description
symbol string Required Metal symbol. One of: AU, AG, PT, PD, RH, CU, NI, AL, PB, ZN.
currency string Required ISO 4217 currency code (e.g. USD, EUR) or supported crypto symbol.
timestamp integer Optional Unix timestamp (seconds) for a historical snapshot. Defaults to live.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/metal-quote?symbol=AU&currency=USD" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"
GET /api/gold-price

Gold spot price with karat prices (24k, 18k, 14k, 9k).

Query parameters

Name Type Required Description
currency string Required ISO 4217 currency code.
timestamp integer Optional Unix timestamp (seconds) for a historical snapshot.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/gold-price?currency=EUR" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"
GET /api/silver-price

Silver spot price with fineness grades (999, 958, 925, 900, 800).

Query parameters

Name Type Required Description
currency string Required ISO 4217 currency code.
timestamp integer Optional Unix timestamp (seconds) for a historical snapshot.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/silver-price?currency=USD" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"

Section

Historical

Time-series and point-in-time historical pricing.

GET /api/metal-history

Daily price data for a metal across a configurable date range.

Query parameters

Name Type Required Description
symbol string Required Metal symbol. One of: AU, AG, PT, PD, RH, CU, NI, AL, PB, ZN.
currency string Required ISO 4217 currency code.
startTime integer Required Range start as Unix timestamp (seconds).
endTime integer Required Range end as Unix timestamp (seconds).
limit integer Optional Page size, between 1 and 30. Defaults to 30.
offset integer Optional Page offset, between 1 and 30.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/metal-history?symbol=AU&currency=USD&startTime=1735689600&endTime=1738368000&limit=30" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"
GET /api/historical-points

Point-in-time price snapshots at 30 days, 60 days, 1 year and 5 years before the supplied timestamp.

Query parameters

Name Type Required Description
symbol string Required Metal symbol. One of: AU, AG, PT, PD, RH, CU, NI, AL, PB, ZN.
currency string Required ISO 4217 currency code.
timestamp integer Required Reference Unix timestamp (seconds).

Example

curl "https://metal-sentinel.p.rapidapi.com/api/historical-points?symbol=AG&currency=USD&timestamp=1746000000" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"

Section

Other markets

Crypto, forex and equities to round out your dashboard.

GET /api/crypto-quote

Live cryptocurrency quote with optional 24-hour comparison.

Query parameters

Name Type Required Description
symbol string Required Crypto symbol (e.g. BTC, ETH).
currency string Required Quote currency (e.g. USD, EUR).
timestamp integer Optional Unix timestamp (seconds) for a historical snapshot.
compareToTime string Optional Comparison window for percent change (e.g. 24h).

Example

curl "https://metal-sentinel.p.rapidapi.com/api/crypto-quote?symbol=BTC&currency=USD" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"
GET /api/forex-quote

Real-time foreign exchange rate, optionally converted to a target currency.

Query parameters

Name Type Required Description
symbol string Required Source currency code.
currency string Optional Target currency code. Defaults to USD.
timestamp integer Optional Unix timestamp (seconds) for a historical snapshot.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/forex-quote?symbol=EUR&currency=USD" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"
GET /api/get-stock

Live mining and commodity equities feed.

Query parameters

Name Type Required Description
— — — No parameters. Returns the current mining-stock quote set.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/get-stock" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"

Section

Reference

Lookup endpoints for what the API supports.

GET /api/market-status

Current market open/close status and the next state-transition time.

Query parameters

Name Type Required Description
— — — No parameters.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/market-status" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"
GET /api/allowed-metals

List of supported precious and base metal symbols.

Query parameters

Name Type Required Description
— — — No parameters.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/allowed-metals" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"
GET /api/allowed-currencies

List of supported fiat currency codes.

Query parameters

Name Type Required Description
— — — No parameters.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/allowed-currencies" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"
GET /api/allowed-cryptos

List of supported cryptocurrency symbols.

Query parameters

Name Type Required Description
— — — No parameters.

Example

curl "https://metal-sentinel.p.rapidapi.com/api/allowed-cryptos" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: metal-sentinel.p.rapidapi.com"