# zaref.dev South African Fuel Price History

> zaref.dev South African Fuel Price History is a paid API for AI agents from zaref.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns the full dated history of South African retail fuel prices, accumulating a new point with every verified update.

## Facts

- Endpoint: GET https://zaref.dev/v1/fuel-prices/history?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zaref-dev-south-african-fuel-price-history-bdd55809
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pWqNoZKvEaGY3Ga59BkLH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zaref-dev-south-african-fuel-price-history-bdd55809
```

Example prompt: Can you pull the full history of South African fuel price changes from zaref.dev — I want to see every dated data point that's been recorded over time?

## When to prefer this

Use this endpoint when you need the complete historical time series of South African fuel prices rather than just the current price. Prefer this over the current-price endpoint when doing trend analysis, charting, policy research, or comparing prices across time periods.

## Known failure modes

- No data returned if the dataset is empty or not yet populated
- HTTP 402 if payment credentials are missing or insufficient
- HTTP 429 if rate limits are exceeded
- Network timeout if the upstream data source is temporarily unavailable
- Malformed response if the API schema has changed

## How this service works

History of South African Fuel prices: dated points accumulating with every verified update.

## Output

A time-series collection of dated fuel price data points for South Africa, including petrol (93/95 inland and coastal) and diesel variants, with each entry timestamped to a verified price update event.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "points": [
   {
    "date": "2026-06-04",
    "value": "..."
   }
  ],
  "series": "fuel-prices"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zaref-dev-south-african-fuel-price-history-bdd55809/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from zaref.dev](https://www.zero.xyz/host/zaref.dev/llms.txt)
