10 tools expose this connector's capabilities to your AI agent.
Prices update every 5 minutes.
USE WHEN:
- User asks specifically about Brent oil price
- User needs the international crude oil benchmark
- User wants to check European/global oil prices
- User asks "what is Brent price"
EXAMPLES:
- "What is Brent price?" → call with no params
- "Current Brent crude oil price" → call with no params
- "Brent oil benchmark" → call with no params
Get current Brent crude oil price
USE WHEN:
- User wants to explore what commodities are available
- User needs to find commodity codes for querying prices
- User is exploring the API capabilities for the first time
- User asks what energy commodities are supported
AVAILABLE COMMODITY TYPES:
- Crude Oil: WTI_USD, BRENT_CRUDE_USD
- Refined Products: DIESEL_USD, GASOLINE_USD, HEATING_OIL_USD, JET_FUEL_USD
- Natural Gas: NATURAL_GAS_USD
- Coal: COAL_USD
- And 40+ more energy commodities
EXAMPLES:
- "What commodities are available?" → call with no params
- "Show me all commodity codes" → call with no params
- "List all energy products" → call with no params
List all available energy commodities in OilPriceAPI
Important for tracking transportation fuel costs and refined product margins.
USE WHEN:
- User asks about diesel fuel prices
- User needs refined product pricing
- User wants to track diesel vs crude crack spreads
- User asks "what is diesel price"
EXAMPLES:
- "What is diesel price?" → call with no params
- "Current ULSD diesel price" → call with no params
- "US diesel fuel cost" → call with no params
Get current US Diesel (Ultra Low Sulfur) price
Requires a paid OilPriceAPI subscription.
USE WHEN:
- User asks about historical oil prices for a specific period
- User wants long-term trend analysis or backtesting
- User asks for prices from specific dates
EXAMPLES:
- "WTI prices for Q1 2026" → commodity_code="WTI_USD", start_date="2026-01-01", end_date="2026-03-31"
- "Brent crude last year" → commodity_code="BRENT_CRUDE_USD", start_date="2025-01-01", end_date="2025-12-31"
Get historical price data for a custom date range
Prices are updated every 5 minutes for oil, gas, and refined products.
USE WHEN:
- User asks about current oil prices
- User needs the latest commodity prices
- User wants to check current WTI or Brent prices
- User asks what is the price of oil/gas/coal right now
PARAMETERS:
- commodity_code (OPTIONAL): Specific commodity code (e.g. "WTI_USD", "BRENT_CRUDE_USD")
EXAMPLES:
- "What is current oil price?" → call with commodity_code="WTI_USD"
- "Latest Brent crude price" → call with commodity_code="BRENT_CRUDE_USD"
- "Show all latest energy prices" → call with no params
Get the latest spot prices for energy commodities
Prices update every 5 minutes.
USE WHEN:
- User asks about natural gas prices
- User needs the US natural gas benchmark
- User wants to check Henry Hub prices
- User asks "what is natural gas price"
EXAMPLES:
- "What is natural gas price?" → call with no params
- "Current Henry Hub gas price" → call with no params
- "US natural gas benchmark" → call with no params
Get current US Natural Gas (Henry Hub) price
Perfect for tracking intraday price movements and volatility.
USE WHEN:
- User asks about oil price movements today
- User needs hourly price data for the last day
- User wants to track intraday volatility
- User asks how prices changed in the last 24 hours
PARAMETERS:
- commodity_code (OPTIONAL): Specific commodity code
EXAMPLES:
- "Show WTI price movements today" → call with commodity_code="WTI_USD"
- "Hourly natural gas prices last 24h" → call with commodity_code="NATURAL_GAS_USD"
- "Brent crude intraday prices" → call with commodity_code="BRENT_CRUDE_USD"
Get hourly prices data for the last 24 hours
Great for monthly trend analysis and medium-term price tracking.
USE WHEN:
- User asks about oil price trends this month
- User needs daily prices for the last 30 days
- User wants to track monthly price movements
- User asks how prices changed over the past month
PARAMETERS:
- commodity_code (OPTIONAL): Specific commodity code
EXAMPLES:
- "WTI price trends this month" → call with commodity_code="WTI_USD"
- "Monthly natural gas prices" → call with commodity_code="NATURAL_GAS_USD"
- "Brent crude last 30 days" → call with commodity_code="BRENT_CRUDE_USD"
Get daily price data for the last 30 days
Ideal for weekly trend analysis and short-term price tracking.
USE WHEN:
- User asks about oil price trends this week
- User needs daily prices for the last week
- User wants to track weekly price movements
- User asks how prices changed over the past week
PARAMETERS:
- commodity_code (OPTIONAL): Specific commodity code
EXAMPLES:
- "WTI price trends this week" → call with commodity_code="WTI_USD"
- "Weekly natural gas prices" → call with commodity_code="NATURAL_GAS_USD"
- "Brent crude last 7 days" → call with commodity_code="BRENT_CRUDE_USD"
Get daily price data for the last 7 days
Prices update every 5 minutes.
USE WHEN:
- User asks specifically about WTI oil price
- User needs the US crude oil benchmark
- User wants to check American oil prices
- User asks "what is WTI price"
EXAMPLES:
- "What is WTI price?" → call with no params
- "Current WTI crude oil price" → call with no params
- "West Texas Intermediate price" → call with no params
Get current WTI (West Texas Intermediate) crude oil price