API Documentation
Base URL: https://www.sentisignal.com/api/v1/metals
Gold API is an informational API for research, reporting, and application experiences. It is not investment advice, not an execution venue, and not an official LBMA fixing.
Price and FX timestamps should be treated as source publication timestamps. Always display the returned date fields when you present values to end users.
Plan Model
Metals API uses the shared public API plan model. Free plans are limited to spot access, one currency per request, and troy_oz. Paid plans unlock historical endpoints, multi-currency requests, and all supported weight units.
| Capability | Free | Paid |
|---|---|---|
| Spot price | Yes | Yes |
| Historical endpoint | No | Yes |
| Currencies per request | 1 | Up to 30 |
| Weight units | troy_oz | troy_oz, gram, kg, tola, tael |
| Intervals | n/a | daily, weekly, monthly, yearly |
Sources and Freshness
| Layer | Current source reality | What to show in your app |
|---|---|---|
| Gold price | Gold responses expose source attribution and price date. The strongest official anchor is NBP-based daily gold pricing. | Show source and price_date. |
| FX conversion | Conversions rely on ECB reference-rate data through the Frankfurter stack. These are daily reference rates, not live trading quotes. | Show fx_source and fx_date. |
| Freshness model | Updates follow source publication cadence. Treat both price and FX layers as daily reference data unless documented otherwise. | Communicate daily refresh cadence and explicit timestamps. |
Authentication
All endpoints (except /currencies) require an API key. Pass it in one of two ways:
# Option 1: Authorization header (recommended) curl -H "Authorization: Bearer YOUR_API_KEY" "https://www.sentisignal.com/api/v1/metals/price?symbol=GOLD" # Option 2: x-api-key header curl -H "x-api-key: YOUR_API_KEY" "https://www.sentisignal.com/api/v1/metals/price?symbol=GOLD"
GET /price
Get the current metal price in one or more currencies.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
symbol |
string | GOLD | GOLD, SILVER, PLATINUM, or PALLADIUM |
currencies |
string | USD | Comma-separated currency codes (e.g., USD,EUR,GBP) |
weight_unit |
string | troy_oz | troy_oz, gram, kg, tola, tael |
Example
curl -H "Authorization: Bearer YOUR_API_KEY" "https://www.sentisignal.com/api/v1/metals/price?symbol=GOLD¤cies=USD,EUR,GBP&weight_unit=gram"
Error Codes
| Code | Message | Description |
|---|---|---|
| 400 | Invalid parameters | Missing or malformed query parameters |
| 401 | Invalid API key | Missing, invalid, expired, or revoked API key |
| 403 | Plan restriction | Historical access, requested currency count, or weight unit is not available on your plan |
| 429 | Rate limit exceeded | Per-minute or monthly limit reached. Check Retry-After header |
| 500 | Server error | Internal error. Contact support if persistent |
Compliance note: gold and FX outputs are intended for informational use. Preserve source attribution, publication dates, and the daily-reference nature of the data when redisplaying responses in your product.