# Oromi UK Official Rates API

> Oromi UK Official Rates API is a paid API for AI agents from agents.oromi.co.uk, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns current UK official economic rates including Bank Rate, CPI inflation, minimum wage, income tax, National Insurance, VAT, corporation tax, SDLT, and allowances.

## Facts

- Endpoint: GET https://agents.oromi.co.uk/api/uk/official-rates
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oromi-uk-official-rates-api-d7a25be2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ljMUH8Ar9CDp9JKW2KwFq

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 oromi-uk-official-rates-api-d7a25be2
```

Example prompt: What is the current UK National Living Wage and when did it come into effect?

## When to prefer this

Choose this endpoint when you need authoritative, up-to-date UK government economic and tax rates in a single machine-payable API call. Prefer it over scraping HMRC or Bank of England websites directly, or over general web search, when you need structured JSON output with effective dates for use in financial calculations, compliance checks, or automated workflows. Particularly suited for AI agents that need to programmatically retrieve specific rate sections without manual data extraction.

## Known failure modes

- Missing or invalid section parameter returns default or full dataset rather than an error
- Stale data if upstream UK government sources have not yet been updated after a policy change
- Payment failure via x402 protocol if USDC balance is insufficient
- Network timeout if the upstream official data source is temporarily unavailable

## How this service works

Machine-payable APIs for AI agents, paid per call in USDC via the x402 protocol: UK business data (Companies House), UK property market data (HM Land Registry), website agent-readiness audits, and crypto market context.

## Output

A JSON object containing the requested section of UK official rate data, including an effective_from date and the relevant rate or threshold values for that section (e.g. national_living_wage_21_plus: 12.71 for minimum_wage section). If no section filter is provided, all available sections may be returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "section": {
       "type": "string",
       "description": "Optional: bank_rate | inflation_cpi | minimum_wage | income_tax | national_insurance | vat | corporation_tax | sdlt_england_ni | allowances"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "effective_from": "2026-04-01",
   "national_living_wage_21_plus": 12.71
  },
  "section": "minimum_wage"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oromi-uk-official-rates-api-d7a25be2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.oromi.co.uk](https://www.zero.xyz/host/agents.oromi.co.uk/llms.txt)