For Agents
Pull real-time and historical prices for WTI, Brent, Natural Gas, and 50+ other commodities through a small REST surface.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Oil Price API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Oil Price API.
Retrieve the latest spot price for WTI, Brent, Natural Gas, or any supported commodity
Pull the past day, week, month, or year of historical prices for a commodity
List all supported commodities with their codes and units
GET STARTED
Use for: I need the latest WTI crude oil spot price, Get last week's Brent crude price history at hourly resolution, Retrieve the past month of Natural Gas prices, Find the price of Heating Oil today
Not supported: Does not execute trades, provide options chains, or stream tick data — use for spot and historical commodity reference prices only.
Oil Price API delivers real-time and historical commodity price data for oil, gas, and related energy products. Seven endpoints cover the latest prices, the past day, week, month, and year for any supported commodity, plus a commodities directory and per-commodity detail. Supports WTI, Brent Crude, Natural Gas, Diesel, Heating Oil, Jet Fuel, Gasoline, Coal, and 50+ other commodities used by trading desks, treasury teams, and analytics tools.
Look up a specific commodity by its code for description and metadata
Feed time-series prices into a treasury or trading dashboard
Trigger alerts when a commodity price crosses a threshold
Patterns agents use Oil Price API for, with concrete tasks.
★ Treasury and procurement price tracking
Procurement and treasury teams pull daily and historical commodity prices to mark exposure and forecast spend. The API exposes named time windows (latest, past_day, past_week, past_month, past_year) so a daily refresh job is a handful of GET calls. Output drops straight into a BI dashboard or spreadsheet.
Fetch the latest WTI, Brent, and Natural Gas prices and append a row to a Google Sheet with the timestamp
Trading-strategy backtesting
Quants pull a year of historical prices to backtest trading strategies on energy commodities. The past_year endpoint returns a clean time series per commodity that can be loaded into pandas with one read_json call. Combined with the commodities listing, a backtest harness can iterate every supported commodity programmatically.
Retrieve past_year prices for WTI and compute a 30-day rolling moving average
Price-threshold alerting
Operations teams alert on price crossings — for example, notifying when Diesel breaks above a hedged threshold or Natural Gas falls below a procurement target. The latest endpoint is cheap to poll on a schedule, and a small comparison rule plus a notification API delivers alerts to Slack or email within seconds.
Poll the latest Diesel price every 15 minutes and post a Slack message when it exceeds a configured threshold
AI agent commodity assistant via Jentic
An AI agent acting as a commodity-research assistant uses Jentic to answer 'what is the WTI spot price right now?' or 'show me Natural Gas over the past month' without storing the API key in its context. The agent searches Jentic for the commodity-price intent, loads the schema, and executes.
Search Jentic for 'latest commodity price', load the schema, and execute it for WTI returning the current spot price
7 endpoints — oil price api delivers real-time and historical commodity price data for oil, gas, and related energy products.
METHOD
PATH
DESCRIPTION
/prices/latest
Latest spot price for a commodity
/prices/past_day
Past 24 hours of prices for a commodity
/prices/past_week
Past 7 days of prices for a commodity
/prices/past_month
Past month of prices for a commodity
/prices/past_year
Past year of prices for a commodity
/commodities
List supported commodities with codes and units
/commodities/{code}
Detail for a specific commodity by code
/prices/latest
Latest spot price for a commodity
/prices/past_day
Past 24 hours of prices for a commodity
/prices/past_week
Past 7 days of prices for a commodity
/prices/past_month
Past month of prices for a commodity
/prices/past_year
Past year of prices for a commodity
Three things that make agents converge on Jentic-routed access.
Credential isolation
Oil Price API tokens are stored encrypted in the Jentic vault. The Authorization header is constructed at request time with a scoped execution token, so the raw API key never appears in the agent's context.
Intent-based discovery
Seven endpoints are easy to enumerate, but agents still need to pick the right time window and commodity code. Jentic's intent search returns the matching endpoint (latest, past_week, etc.) with the by_code parameter prepared.
Time to first call
Direct integration including key provisioning, time-series shaping, and 429 handling: 1-2 hours. Through Jentic: under 15 minutes.
Alternatives and complements available in the Jentic catalogue.
Specific to using Oil Price API through Jentic.
What authentication does the Oil Price API use?
The API uses an API key passed in the Authorization header as 'Token {key}'. Through Jentic, the key is stored encrypted in the vault and the header is constructed at request time, so the raw token never enters the agent's context.
Can I get historical commodity prices with the Oil Price API?
Yes. The /prices/past_day, /prices/past_week, /prices/past_month, and /prices/past_year endpoints return time-series data for a specified commodity code. Pass the by_code query parameter (for example WTI_USD) to scope the request.
What are the rate limits for the Oil Price API?
Limits are tiered by subscription. The free tier supports a small daily request budget intended for development; paid tiers scale to thousands of calls per day. Excess requests return 429. Since prices update on a per-minute basis, cache responses for at least 30-60 seconds in production.
How do I list every supported commodity through Jentic?
Search Jentic for 'list oil commodities', load the schema for GET /commodities, and execute. The response returns commodity codes, names, and units; iterate with /commodities/{code} to fetch individual detail.
Which commodities does the Oil Price API support?
The API covers WTI, Brent Crude, Natural Gas, Diesel, Heating Oil, Jet Fuel, Gasoline, Coal, and roughly 50 other energy and energy-adjacent commodities. Use GET /commodities to enumerate the current list rather than hard-coding codes.
Is the Oil Price API free?
There is a free tier suitable for development with a low daily request cap. Paid tiers add higher request budgets and access to longer historical windows. Pricing is on the OilPriceAPI website; production usage typically requires a paid plan.
/commodities
List supported commodities with codes and units
/commodities/{code}
Detail for a specific commodity by code