Our WordPress plugin is live.

Get it

API Reference

Endpoints documentation

Twelve REST endpoints covering spot prices, historical series, crypto, forex, equities and reference lists. Authenticate via RapidAPI and call them directly from any backend or frontend.

Base URL

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

Authentication

Send your RapidAPI key in the X-RapidAPI-Key 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

GET /api/metal-quote?symbol=AU&currency=USD
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

GET /api/gold-price?currency=EUR
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

GET /api/silver-price?currency=USD

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

GET /api/metal-history?symbol=AU&currency=USD&startTime=1735689600&endTime=1738368000&limit=30
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

GET /api/historical-points?symbol=AG&currency=USD&timestamp=1746000000

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

GET /api/crypto-quote?symbol=BTC&currency=USD
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

GET /api/forex-quote?symbol=EUR&currency=USD
GET /api/get-stock

Live mining and commodity equities feed sourced from Kitco.

Query parameters

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

Example

GET /api/get-stock

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

GET /api/market-status
GET /api/allowed-metals

List of supported precious and base metal symbols.

Query parameters

Name Type Required Description
No parameters.

Example

GET /api/allowed-metals
GET /api/allowed-currencies

List of supported fiat currency codes.

Query parameters

Name Type Required Description
No parameters.

Example

GET /api/allowed-currencies
GET /api/allowed-cryptos

List of supported cryptocurrency symbols.

Query parameters

Name Type Required Description
No parameters.

Example

GET /api/allowed-cryptos