Interactive API Explorer

About the Interactive API Explorer

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

Coverage Note

The explorer covers the core API plus the documented 2026 endpoint families for prices, futures, marine/bunker fuels, spreads, indicators, alerts, webhooks, account workflows, benchmarks, and aviation fuel. Some newer entries use compact response descriptions; the narrative API pages remain the source for detailed examples, entitlement notes, and known backend blockers.

Premium Entitlements

Premium endpoints are included in the explorer, but access depends on your plan, account grants, and any feature flags listed on the narrative page:

Check the endpoint page before building production workflows against gated datasets.

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 Trial: 10,000 requests (7-day trial)
  • Free: 200 requests/month after trial
  • Developer: 10,000 requests/month
  • Starter: 50,000 requests/month
  • Professional: 100,000 requests/month
  • Scale: 1,000,000 requests/month

All plans share the same sustained rate limit of 60 requests per rolling 60-second window per API key.

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://docs.oilpriceapi.com/openapi.yaml
    • Use with Insomnia: Import → From URL → https://docs.oilpriceapi.com/openapi.yaml

Need Help?

Last Updated: