Live metal rates API
A simple JSON API over HTTPS. Indicative spot prices, refreshed every 60 seconds.
Getting started
- Create your account at liveratesapi.amarsoft.cloud/account and start the free trial or choose a plan.
- Copy your key when it is shown (it is shown once). If you lose it, make a new one from your account.
- Send your first request:
curl "https://rates.amarcp.ae/v1/latest?metals=gold¤cy=AED&unit=gram" \ -H "Authorization: Bearer amr_xxxx_your_key"
Base URL: https://rates.amarcp.ae
Want to be sure your key works? Test it here.
Authentication
Every request carries your key in the header: Authorization: Bearer amr_<prefix>_<secret>. Never put the key in the URL or in code that runs in your customers' browser; call the API from your server.
GET/v1/latest
Latest price for one or more metals.
| Param | Values | Default |
|---|---|---|
metals | gold, silver, platinum, palladium (comma list) | gold |
currency | AED, SAR, USD, KWD, QAR, BHD, OMR, EUR, GBP, INR | USD |
unit | oz, gram, kg, tola | oz |
{
"as_of": "2026-11-21T09:30:00Z",
"fetched_at": "2026-11-21T09:30:04Z",
"age_seconds": 3,
"stale": false,
"stale_after_seconds": 600,
"market_open": true,
"currency": "AED",
"unit": "gram",
"fx": {"rate_per_usd": 3.6725, "as_of": "2026-11-21T09:30:00Z"},
"rates": {"gold": {
"price": 312.9588, "bid": null, "ask": null, "as_of": "2026-11-21T09:30:00Z",
"day": {"open": 311.2, "high": 314.05, "low": 310.6, "prev_close": 311.0,
"change": 1.9588, "change_pct": 0.63, "since": "2026-11-20T22:00:00Z"},
"karats": {"24": 312.9588, "22": 286.879, "21": 273.8389, "18": 234.7191}
}}
}
day: the current trading session (opens 22:00 UTC Sun–Thu; over the weekend it stays the Friday session). Same currency and unit as price.karats(gold only): 24K price × k/24 for 24, 22, 21 and 18.- Prices are 24K / fine metal.
fxis null for USD.
GET/v1/history
Prices over a time range (Pro and Enterprise plans).
| Param | Description |
|---|---|
metal, currency, unit | as in /v1/latest (one metal). |
from | ISO time, required. |
to | ISO time, default now. |
interval | raw (≤ 7 days), hour (≤ 93 days), day (≤ 10 years) |
Each point is the closing tick of its bucket. How far back you can go depends on your plan (history_days).
curl "https://rates.amarcp.ae/v1/history?metal=gold¤cy=AED&unit=gram&from=2026-11-01T00:00:00Z&interval=day" \ -H "Authorization: Bearer $AMR_KEY"
GET/v1/account
Your subscription: plan, starts_at, ends_at, active, monthly_quota, used_this_month, remaining_this_month, quota_resets, metals, history_days, rate_limit_per_min. Not counted against your quota and still answers after expiry.
GET/v1/health
No key. 200 {"status":"ok"} when fresh, 503 when stale. For uptime monitors.
Quota & limits
Every /v1/latest and /v1/history reply carries:
X-Quota-Limit | your monthly quota |
X-Quota-Remaining | left this month |
X-Quota-Reset | when it resets (1st of the month, UTC) |
Over the per-minute limit you get 429 rate_limited with Retry-After. When the monthly quota is used, 429 quota_exceeded until the 1st — or upgrade from your account.
Errors
Error body: {"error": {"code": "...", "message": "..."}}
| HTTP | code | meaning |
|---|---|---|
| 401 | missing_key / invalid_key | no key, unknown or revoked |
| 403 | subscription_expired / not_started | outside your plan's start/end dates |
| 403 | metal_not_in_plan / history_range_not_in_plan | your plan does not include it |
| 403 | history_not_allowed | your plan has no history |
| 400 | bad_metal / bad_currency / bad_unit / bad_range / range_too_long | bad parameters |
| 429 | rate_limited | per-minute limit; see Retry-After |
| 429 | quota_exceeded | monthly quota used; Retry-After = seconds to the 1st |
| 503 | no_data / no_fx | no price available yet |
Stale prices
Prices are indicative, for information and business use, not an offer to trade. · Data sources
