OilPriceAPI Documentation
GitHub
GitHub
  • Interactive Explorer

    • Interactive API Explorer
  • Price Data

    • API Reference
    • Get Latest Prices
    • Historical Prices
  • Commodities

    • List Commodities
    • Get Commodity Details
  • Marine Fuels

    • List Marine Fuel Ports
    • Get Port Details with Prices
  • Premium Endpoints

    • All Prices API - One Call, All Commodities
    • Cushing Oil Storage Intelligence API
    • Drilling Intelligence API
    • Marine Fuels API
    • ICE Brent Futures API

Interactive API Explorer

About the Interactive API Explorer

This interactive documentation is automatically generated from our OpenAPI specification and provides:

Premium Endpoints

Some premium endpoints are not yet included in the Swagger specification but are fully documented:

  • All Prices API - Get 40+ commodities in one call
  • Cushing Storage - Real-time storage intelligence
  • ICE Brent Futures - Complete futures curve data
  • Marine Fuels Pricing - Global bunker prices

These endpoints are being added to the Swagger specification soon.

This interactive documentation provides:

  • Live Testing: Test API endpoints directly from your browser
  • Request Examples: See exactly how to format your API requests
  • Response Schemas: Understand the structure of API responses
  • Authentication: Test with your actual API key
  • Parameter Details: Complete information about query parameters and request bodies

Quick Start

  1. Click the Authorize button and enter your API key
  2. Browse available endpoints organized by category
  3. Click on any endpoint to see details
  4. Click Try it out to test the endpoint
  5. Fill in parameters and click Execute
  6. View the actual API response

Authentication

All API endpoints require authentication using your API key:

Authorization: Token YOUR_API_KEY

Rate Limits

Please be aware of rate limits when testing:

  • Free tier: 1,000 requests/month
  • Hobby: 10,000 requests/month
  • Professional: 100,000 requests/month

Troubleshooting

If the Interactive API Explorer doesn't load:

  1. Check JavaScript is enabled in your browser
  2. Try refreshing the page (Ctrl/Cmd + Shift + R for hard refresh)
  3. Alternative Options:
    • Download the OpenAPI Specification
    • Import into Swagger Editor
    • Use with Postman: File → Import → Link → https://api.oilpriceapi.com/swagger.json
    • Use with Insomnia: Import → From URL → https://api.oilpriceapi.com/swagger.json

Need Help?

  • Sign up for a free API key
  • View pricing plans
  • Contact support