# three.ws Gas Oracle

> three.ws Gas Oracle is a paid API for AI agents from three.ws, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-23).

Returns current gas price estimates across Base, Solana, and Ethereum networks, including tiered gas prices, base fees, and priority fees.

## Facts

- Endpoint: GET https://three.ws/api/x402/gas-oracle?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-gas-oracle-af742e27
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ppxCu4ZrT4GVVUnwB1rJA

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 three-ws-gas-oracle-af742e27
```

Example prompt: What are the current gas prices on Base, Ethereum, and Solana right now — give me the standard tier gas price in gwei and the current base fee for each?

## When to prefer this

Use this endpoint when you need real-time, multi-chain gas price data covering Base, Ethereum, and Solana in a single call. Prefer it over chain-specific RPC gas estimation when you want cross-chain comparison, tiered estimates (standard priority), and Solana percentile breakdowns without writing custom RPC logic. The $0.001 USDC per-call cost is negligible for agents that need reliable, normalized gas data.

## Known failure modes

- Network or upstream oracle unavailability returns an error or stale timestamp
- Payment of $0.001 USDC not provided or rejected via x402 protocol results in 402 Payment Required
- Malformed response if underlying gas oracle data sources are temporarily unavailable
- Rate limiting if too many requests are made in a short window

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

A JSON object with a timestamp and per-network gas data: for Base and Ethereum, tiered gas prices (standard key, gas_price_gwei, priority_fee_gwei) and base_fee_gwei; for Solana, base_fee_lamports and priority_fee_micro_lamports broken down by p25, p50, and p90 percentiles.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-07-11T10:00:00Z",
  "base": {
   "tiers": [
    {
     "key": "standard",
     "gas_price_gwei": 0.016,
     "priority_fee_gwei": 0.004
    }
   ],
   "base_fee_gwei": 0.012
  },
  "solana": {
   "base_fee_lamports": 5000,
   "priority_fee_micro_lamports": {
    "p25": 0,
    "p50": 1200,
    "p90": 48000
   }
  },
  "ethereum": {
   "tiers": [
    {
     "key": "standard",
     "gas_price_gwei": 5,
     "priority_fee_gwei": 0.8
    }
   ],
   "base_fee_gwei": 4.2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-gas-oracle-af742e27/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)
