# ChainRay Gas Oracle

> ChainRay Gas Oracle is a paid API for AI agents from chainray.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns real-time gas price and fee estimates for EVM-compatible blockchain networks, defaulting to Base chain.

## Facts

- Endpoint: GET https://chainray.online/gas-oracle
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainray-online-2f83f7d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3JoZRRArtlHD4CkrY2P1b

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 chainray-online-2f83f7d9
```

Example prompt: What are the current gas prices on Base right now — I need the latest fee estimates before I send a transaction?

## When to prefer this

Use this endpoint when you need real-time gas price data for EVM-compatible chains (especially Base) to inform transaction cost estimation, fee setting, or timing decisions. Prefer this over historical gas endpoints when you need the current moment's gas metrics rather than trends.

## Known failure modes

- Unsupported or unrecognized chain name returns an error or empty response
- Network unavailability causes timeout or 503 error
- Payment failure (insufficient USDC balance) results in 402 response
- Invalid query parameter format returns 400 bad request

## How this service works

The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.

## Output

Returns current gas price metrics for the specified EVM chain, including base fee, priority fee (tip), and overall gas estimates needed to submit and confirm transactions.

## Example request

```json
{
 "query": "{\\\"input\\\": {\\\"type\\\": \\\"http\\\", \\\"method\\\": \\\"GET\\\", \\\"queryParams\\\": {\\\"chain\\\": \\\"base\\\"}}}"
}
```

## 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": {
      "chain": {
       "type": "string",
       "description": "Blockchain network (e.g., base, ethereum, polygon)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainray-online-2f83f7d9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainray.online](https://www.zero.xyz/host/chainray.online/llms.txt)
