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.

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.

Pricing (Tentative)

Free Tier: 100 requests/day (for hobbyists, students)
Basic: ₹499/month — 10,000 requests/day
Pro: ₹1,999/month — 100,000 requests/day + webhooks
Enterprise: Custom pricing for unlimited requests + SLA

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

Get Early Access

Want to be among the first to use the PriceToday API?

Email us at api@pricetoday.in with:

Your name and company
Intended use case
Expected request volume

We'll notify you as soon as the API is ready for beta testing.

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