Aroai
Get started

Market data · Australia

Read Australian state fuel prices

Preview: Find current retail fuel prices across NSW, Queensland and Western Australia by suburb, postcode or radius.

Use Aroai for freeConnect your client

Tool ID

au_fuel_price

Preview: Find current retail fuel prices across NSW, Queensland and Western Australia by suburb, postcode or radius.

PreviewAustraliaMarket data1 credit
ServerAustralia
Information categoryState public fuel price feeds
Credit behavior1 credit
AccessWorkspace permissions

Inputs and outputs

Published input schema

Use the discovered runtime schema for the workspace you are connected to.

Public catalog
au_fuel_price input schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "enum": [
        "NSW",
        "QLD",
        "WA"
      ]
    },
    "fuel_type": {
      "type": "string",
      "enum": [
        "U91",
        "E10",
        "E85",
        "P95",
        "P98",
        "Diesel",
        "Premium Diesel",
        "LPG"
      ]
    },
    "day": {
      "description": "FuelWatch day in Perth local time; WA only, defaults to today.",
      "type": "string",
      "enum": [
        "today",
        "tomorrow"
      ]
    },
    "suburb": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "postcode": {
      "description": "Australian four-digit postcode; supported in NSW and Queensland.",
      "type": "string",
      "pattern": "^\\d{4}$"
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "radius_km": {
      "type": "number",
      "minimum": 1,
      "maximum": 100
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "state",
    "limit"
  ],
  "additionalProperties": false
}

Published output shape

Tool results return structured data or a stable error object.

Shared Aroai tool output schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "summary": {
          "type": "string"
        },
        "data": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "executionId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "creditsCharged": {
          "type": "number",
          "minimum": 0
        },
        "usage": {
          "type": "object",
          "properties": {
            "credits_charged": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "credits_remaining": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "credits_charged"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "summary",
        "data",
        "creditsCharged"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "usage": {
          "type": "object",
          "properties": {
            "credits_charged": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "credits_remaining": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "credits_charged"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

Source and usage notes

Understand the result boundary

  • Supports NSW FuelCheck, Fuel Prices Queensland and WA FuelWatch.
  • WA prices are declared fixed for 24 hours from 6am AWST; supports 'today' or 'tomorrow'.
  • NSW and Queensland require registered state API credentials in your workspace.
  • Does not cover states outside NSW, QLD and WA.
Explore AU/NZ toolkits

Use this capability

Build on your next business question.

Explore related tools or connect your AI client to get started.

Explore toolsClient setup

Local intelligence. Ready to build.

Put your AI to work.

Create a free workspace and bring local business context into your AI tools.

Use Aroai for freeExplore tools