Subscription Plans & History Limits
Subscription Plans & Historical Access Limits
GridMap enforces deterministic rate limits and dataset retention boundaries based on your subscription tier. Every request—whether initiated via the interactive web documentation ("Send Request") or programmatically using an API Key (x-api-key)—consumes 1 credit against your active plan quota.
| Plan Tier | Monthly / Yearly Price | Rate Limits | 15-Min Intervals | Hourly | Daily | Macro (Mo/Yr) | API Keys |
|---|---|---|---|---|---|---|---|
FreeFREE | $0 / ₹0 | 5 req/min 100 req/day | 7 Days | 30 Days | 90 Days | 24 Mo / 5 Yr | 1 Key |
DeveloperPOPULAR | $19.00/mo ₹1,499/mo | 30 req/min 5,000 req/day | 90 Days | 365 Days | 1095 Days | 60 Mo / 10 Yr | 3 Keys |
Pro | $49.00/mo ₹3,999/mo | Unlimited | Full History (2012 – Present) | Full History | Full History | Full History | 10 Keys |
Plan Tier Breakdowns & Target Use Cases
Free Tier
$0 / Free Sandbox
Essential sandbox telemetry for prototyping, validation, and learning the GridMap API schemas.
- 5 requests / min (100 / day)
- 7 days 15-min interval history
- 30 days hourly aggregations
- 90 days daily summaries
- 1 production API key
- Community email support
Developer Tier
$19.00/mo (₹1,499)
Designed for independent energy analysts, automated cron pipelines, and systematic algorithmic models.
- 30 requests / min (5,000 / day)
- 90 days 15-min interval history
- 1 Year hourly aggregations
- 3 Years daily historical summaries
- 3 active API keys
- Standard developer support
Pro Tier
$49.00/mo (₹3,999)
Enterprise-grade market telemetry with unlimited rate limits and full historical depth back to market inception.
- Unlimited requests / min & day
- Full 15-min history (2012 – Present)
- Full hourly, daily, monthly history
- 10 active API keys with custom labels
- Priority SLA & dedicated channel
Architecture: How Rate Limits, Expired Plans & History Restrictions Work
1. Rate Limiting & Expired Plan Handling
Every endpoint monitors request volume and subscription validity through deterministic checks:
POST /api/v1/subscription/me/ with { "plan_code": "free" }:{
"detail": "Your Developer plan expired on 2026-11-16. Please renew your subscription or switch to the Free plan in your dashboard to continue using the API."
}2. Historical Retention & Date Filtering (HTTP 400)
When you filter by date, start_date, end_date, year, or month older than your plan allows, the API returns 400 Bad Request with an upgrade message under that parameter key:
{
"date": [
"Your Free plan allows access to historical data from 2026-11-09 onwards. Please upgrade your subscription plan to access older historical data."
]
}