# three.ws Market Gas Price Oracle

> three.ws Market Gas Price 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 Ethereum gas price tiers and estimated USD costs for common on-chain actions like DEX swaps, used for fee estimation in the three.ws micropayment agent platform.

## Facts

- Endpoint: GET https://three.ws/api/x402/market-gas?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-market-gas-price-oracle-4608d316
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KJqF0-sas-CgvCxTbPDzR

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-market-gas-price-oracle-4608d316
```

Example prompt: What are the current Ethereum gas price tiers and how much would a standard DEX swap cost in USD right now on three.ws?

## When to prefer this

Use this endpoint when you need real-time Ethereum gas price data and USD cost estimates for on-chain actions within the three.ws agent/micropayment ecosystem. Prefer it when already integrated with three.ws x402 payment infrastructure and needing fee transparency for embedded agent interactions or pre-transaction cost checks.

## Known failure modes

- Payment not included — endpoint requires $0.001 USDC via x402 protocol, returns 402 if unpaid
- Network or oracle unavailability may return 503 or stale data
- Malformed properties filter returns 400 or empty tier list
- ETH price oracle lag may cause temporarily inaccurate USD estimates

## 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 containing one or more gas price tiers (e.g. 'standard'), each with a gas price in gwei, ETH price in USD, and a list of common on-chain actions (e.g. DEX swap) with their gas units, estimated USD cost, and a human-readable label.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tiers": [
   {
    "key": "standard",
    "actions": [
     {
      "gas": 150000,
      "key": "swap",
      "usd": 3.12,
      "label": "DEX swap"
     }
    ],
    "gas_price_gwei": 6.4
   }
  ],
  "eth_price_usd": 3251.7
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-market-gas-price-oracle-4608d316/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)