Production Go-Live and Plan Fit
Use this guide when moving from a first API call to a production workflow.
Workflow Matrix
| Workflow | Endpoint Starting Point | Plan Dimensions To Check |
|---|---|---|
| Energy software and dashboards | /v1/prices/latest, /v1/prices/batch, widgets | Request volume, display rights, caching, status checks |
| Trading, research, and backtesting | /v1/prices/historical, futures, spreads, indicators | Historical depth, futures access, premium analytics, source timestamps |
| Transport, aviation, marine, procurement | diesel, jet fuel, marine fuels, bunker fuels | Update cadence, region/port coverage, public display, export rights |
First Production Request
curl "https://api.oilpriceapi.com/v1/account" \
-H "Authorization: Token YOUR_API_KEY"
Verify:
- Account plan and subscription status
- Monthly quota remaining
- Entitlements for premium endpoints
- Rate-limit headers on representative endpoint calls
Endpoint Selection
| Need | Use |
|---|---|
| One or a few latest prices | /v1/prices/latest?by_code=... |
| Many latest prices | /v1/prices/batch |
| Custom historical range | /v1/prices/historical |
| Futures curve or contract data | /v1/futures/* |
| Marine fuel prices | /v1/prices/marine-fuels/* |
| Alerts and push workflows | /v1/alerts + /v1/webhooks |
Required Production Checks
- Confirm response timestamps are fresh enough for your workflow.
- Implement retry/backoff only for transient failures.
- Treat
401,403,402, and most400responses as non-retryable. - Cache responses by endpoint, params, currency, and code list.
- Add a fallback for stale or unavailable data.
- Confirm public display or redistribution rights before launch.
Plan Quotas
| Plan | Request Quota | Request Rate Limit |
|---|---|---|
| Free | 50 / day | 60 per rolling 60s |
| Free Trial (7 days) | 10,000 | 60 per rolling 60s |
| Developer | 10,000 / month | 60 per rolling 60s |
| Starter | 50,000 / month | 60 per rolling 60s |
| Professional | 100,000 / month | 60 per rolling 60s |
| Scale | 1,000,000 / month | 60 per rolling 60s |
Current tier limits are machine-readable at GET https://api.oilpriceapi.com/v1/meta/limits (no key required); this table is rendered from it at build time. Read limits from the endpoint rather than hardcoding them.
Upgrade and Support Paths
Use self-serve plans for ordinary internal workflows. Contact support for:
- Enterprise quotas
- Public display or redistribution
- Futures/exchange-derived usage review
- Marine, carbon, aviation, benchmark-close, or premium analytics access
- Written data-rights confirmation