Oil price API: your usage
Your usageYour plan, your calls today and your limits; does not count against them.
PlansEvery plan
CostNever counted
ReturnsYour key
UpdatedLive
What it is for
Your plan, the calls counted today and this month, your limits, and how fresh and how far back your plan reads.
This call never counts against your quota, so it is safe to make before a batch.
Good for
- Calls left before a batch
- Usage in your own tools
- Your plan after an upgrade
Parameters
This endpoint takes no parameters: your key is all it needs.
Try it runs against the live API with your key
No key yet? Get a free one; it is saved in this browser for every page.
The answer 200, application/json
| Field | Type | What it holds | Example |
|---|---|---|---|
plan | string | Your plan | "Free key" |
calls_today | integer | Calls counted today (UTC) | 12 |
calls_month | integer | Calls counted this month | 214 |
limits | object | Calls a day, calls a minute, and when the day resets | {"calls_a_day":50,"calls_a_minute":10... |
reads | object | How fresh and how far back your plan reads | {"prices_up_to":"the end of yesterday... |
Example answer real, from what we hold now; long lists cut to three
GET /v1/usage{ "data": { "plan": "Free key", "calls_today": 12, "calls_month": 214, "limits": { "calls_a_day": 50, "calls_a_minute": 10, "day_resets_at": "2026-10-30T00:00:00Z" }, "reads": { "prices_up_to": "the end of yesterday (UTC)", "history_from": "2026-09-29" } }, "meta": [] }
Errors every error has the same shape
| HTTP | Code | When | What to do |
|---|---|---|---|
| 401 | unauthorized | No key, or not a valid one | Send your key in the X-API-Key header; your account page shows it. |
Dates and times are UTC. A point's date is the day its price took effect, or the first day of its week or month for weekly and monthly series. Conversions use each day's own rate, so a converted series moves with both the price and the exchange rate.