Interactive API Explorer

Execute live requests against our sandbox or production clusters. Inspect headers, test validation schemas, and export working cURL commands for all 1,100+ endpoints.

Environment

Bearer Token

GET

Daily Terminal Rack Prices

Rate Limit: 300 req / minAuth Required

Fetch real-time daily terminal rack prices across all Mexican and Texas distribution hubs (Monterrey, Tuxpan, Cadereyta, Houston).

GET

https://sandbox.cantarell-os.tech/api/v1/prices/daily-rack?terminal=MTY&fuel_type=REGULAR&currency=MXN

Query Parameters

terminalstringoptional

Filter by terminal code (e.g., MTY, TUX, CAD, HOU)

fuel_typestringoptional

REGULAR, PREMIUM, or DIESEL

currencystringoptional

MXN or USD

Response Body

{
  "ok": true,
  "data": {
    "timestamp": "2026-09-02T23:15:00Z",
    "terminal": "MTY - Cadereyta / Monterrey Hub",
    "currency": "MXN",
    "prices": [
      {
        "fuel_type": "REGULAR_87",
        "rack_price_per_liter": 22.45,
        "sat_ieps_applied": 6.1752,
        "vat_percentage": 16,
        "delivered_estimate": 23.85,
        "valid_until": "2026-09-03T05:59:59Z"
      },
      {
        "fuel_type": "PREMIUM_91",
        "rack_price_per_liter": 24.89,
        "sat_ieps_applied": 5.2146,
        "vat_percentage": 16,
        "delivered_estimate": 26.35,
        "valid_until": "2026-09-03T05:59:59Z"
      },
      {
        "fuel_type": "DIESEL_ULSD",
        "rack_price_per_liter": 24.12,
        "sat_ieps_applied": 6.7865,
        "vat_percentage": 16,
        "delivered_estimate": 25.55,
        "valid_until": "2026-09-03T05:59:59Z"
      }
    ],
    "meta": {
      "source": "Cantarell Spot Price Aggregator v4.2",
      "regulatory_stamp": "CRE-PR-2026-0982"
    }
  }
}

API Reference

Curated examples with copy-paste snippets

Quickstart Guides

Get started in 5 minutes with working code

Webhooks

30+ event types with HMAC-SHA256 signing