Get Started with OilPriceAPI

# python -m pip install requests
import math
import os
import requests

key = os.environ.get("OILPRICEAPI_KEY")
if not key:
    raise SystemExit("Set OILPRICEAPI_KEY in your environment before running.")
response = requests.get(
    "https://api.oilpriceapi.com/v1/prices/latest",
    params={"by_code": "WTI_USD"},
    headers={"Authorization": "Token " + key},
    timeout=15,
)
if response.status_code == 401:
    raise SystemExit("API key expired or revoked; create a new key in your account.")
if response.status_code == 429:
    raise SystemExit("Rate limited; wait for your quota window and retry.")
response.raise_for_status()
payload = response.json()
record = payload.get("data") if isinstance(payload, dict) else None
if not isinstance(record, dict) or isinstance(record.get("price"), bool) or not isinstance(record.get("price"), (int, float)) or not math.isfinite(record["price"]):
    raise SystemExit("No valid price returned; do not substitute zero.")
timestamp = record.get("as_of") or record.get("source_timestamp") or record.get("created_at")
if not isinstance(timestamp, str) or not timestamp:
    raise SystemExit("Source timestamp missing; do not use this value.")
print({
    "code": record.get("code"),
    "price": record["price"],
    "currency": record.get("currency"),
    "source_timestamp": timestamp,
})

// Node.js 18+; set OILPRICEAPI_KEY in your environment.
const key = process.env.OILPRICEAPI_KEY;
if (!key) throw new Error("OILPRICEAPI_KEY is required");
const url = "https://api.oilpriceapi.com/v1/prices/latest?by_code=WTI_USD";
const response = await fetch(url, {
  headers: { Authorization: "Token " + key },
  signal: AbortSignal.timeout(15000),
});
if (response.status === 401) throw new Error("API key expired or revoked");
if (response.status === 429) throw new Error("Rate limited; retry after your quota window");
if (!response.ok) throw new Error("Price request failed: HTTP " + response.status);
const record = (await response.json()).data;
if (!record || typeof record.price !== "number" || !Number.isFinite(record.price)) {
  throw new Error("No valid price returned; do not substitute zero");
}
const timestamp = record.as_of || record.source_timestamp || record.created_at;
if (typeof timestamp !== "string" || !timestamp) {
  throw new Error("Source timestamp missing; do not use this value");
}
console.log({
  code: record.code,
  price: record.price,
  currency: record.currency,
  source_timestamp: timestamp,
});

<?php
$key = getenv('OILPRICEAPI_KEY');
if (!$key) { throw new RuntimeException('OILPRICEAPI_KEY is required'); }
$url = 'https://api.oilpriceapi.com/v1/prices/latest?by_code=WTI_USD';
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => ['Authorization: Token ' . $key],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($body === false) { throw new RuntimeException(curl_error($ch)); }
curl_close($ch);
if ($status === 401) { throw new RuntimeException('API key expired or revoked'); }
if ($status === 429) { throw new RuntimeException('Rate limited; retry after your quota window'); }
if ($status !== 200) { throw new RuntimeException('Price request failed: HTTP ' . $status); }
$record = json_decode($body, true, 512, JSON_THROW_ON_ERROR)['data'] ?? null;
if (!is_array($record) || !is_numeric($record['price'] ?? null)) {
    throw new RuntimeException('No valid price returned; do not substitute zero');
}
$timestamp = $record['as_of'] ?? $record['source_timestamp'] ?? $record['created_at'] ?? null;
if (!is_string($timestamp) || !$timestamp) {
    throw new RuntimeException('Source timestamp missing; do not use this value');
}
print_r([
    'code' => $record['code'] ?? null,
    'price' => $record['price'],
    'currency' => $record['currency'] ?? null,
    'source_timestamp' => $timestamp,
]);

require 'json'
require 'net/http'
require 'uri'

key = ENV.fetch('OILPRICEAPI_KEY')
uri = URI('https://api.oilpriceapi.com/v1/prices/latest?by_code=WTI_USD')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Token ' + key
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, open_timeout: 15, read_timeout: 15) do |http|
  http.request(request)
end
raise 'API key expired or revoked' if response.code == '401'
raise 'Rate limited; retry after your quota window' if response.code == '429'
raise 'Price request failed: HTTP ' + response.code unless response.is_a?(Net::HTTPSuccess)
record = JSON.parse(response.body).fetch('data')
raise 'No valid price returned; do not substitute zero' unless record['price'].is_a?(Numeric) && record['price'].finite?
timestamp = record['as_of'] || record['source_timestamp'] || record['created_at']
raise 'Source timestamp missing; do not use this value' unless timestamp.is_a?(String) && !timestamp.empty?
puts({
  code: record['code'], price: record['price'], currency: record['currency'],
  source_timestamp: timestamp
})