API Documentation

🚧 API Coming Soon

We're building a robust API for developers and businesses who need programmatic access to live gold and silver rates.

The public endpoint below works today. A versioned API with authentication and higher rate limits is in progress.

Planned Features

The PriceToday API will provide:

Live IBJA rates - Updated twice daily (12:05 PM & 5:05 PM IST)
Historical data - Daily, weekly, monthly rates going back years
City-wise pricing - Rates for all major Indian cities
International rates - LBMA gold/silver, USD/INR exchange rates
Multiple purities - 24K, 22K, 18K gold; 999, 925 silver
Webhooks - Real-time notifications when rates update

Sample Endpoints (Preview)

GET /api/v1/rates/current

Get current gold and silver rates (PM session).

{
  "data": {
    "gold": {
      "24k": { "rate": 7650, "change": 45, "unit": "per_gram" },
      "22k": { "rate": 7012, "change": 41, "unit": "per_gram" },
      "18k": { "rate": 5738, "change": 34, "unit": "per_gram" }
    },
    "silver": {
      "999": { "rate": 92.50, "change": -0.35, "unit": "per_gram" }
    },
    "timestamp": "2026-02-13T17:05:00+05:30",
    "source": "IBJA"
  }
}

GET /api/v1/rates/city/{city_name}

Get rates for a specific city (Mumbai, Delhi, Chennai, etc.).

GET /api/v1/historical?metal=gold&from=2026-01-01&to=2026-01-31

Get historical rates for a date range.

GET /api/v1/international

Get international gold prices (LBMA), USD/INR, import duty.

Authentication

API requests will require an API key passed in the header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

To ensure fair usage, we'll implement rate limits based on your plan. All responses will include headers:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9856
X-RateLimit-Reset: 1736784000

Support & SLA

Free Tier: Community support (email only)
Basic/Pro: Email support within 24 hours
Enterprise: Priority support + 99.9% uptime SLA

Use Cases

The PriceToday API is ideal for:

Jewellers & Retailers: Display live rates on your website/app
Financial Apps: Show gold prices alongside stocks, mutual funds
News Portals: Embed live bullion rates in business sections
Analytics Tools: Build dashboards tracking precious metals
Chatbots: Provide instant rate quotes via WhatsApp/Telegram
Investment Platforms: Track gold ETF NAVs, SGB prices

All API access is subject to our Terms of Service. Commercial use requires a paid plan.