Real-time gas price tiers via x402-paid API on Base (USDC), part of the DeFi Shield security suite.
What it does
The DeFi Shield Gas Oracle endpoint (`/api/mev/gas-oracle`) returns real-time gas price tier data, intended for autonomous AI agents and DeFi applications that need current gas estimates before submitting on-chain transactions. It is one of 69 paid endpoints in the DeFi Shield suite, which covers DeFi intelligence, wallet analysis, MEV protection, NFT analytics, cross-chain data, and more.
Payment is handled via the x402 protocol: callers include an x402 payment header with each POST request, and the facilitator verifies USDC payment on Base before the endpoint processes the request. The gas oracle is priced at $0.05 per call. Free GET-based endpoint discovery is available on every endpoint path, and a health/discovery endpoint at `/api/health` lists all endpoints with pricing.
Documentation beyond the landing page is sparse — the `/docs`, `/pricing`, and `/README` paths all return 404. No OpenAPI spec or detailed request/response schema was found. The x402 challenge was confirmed live (HTTP 402 on POST), but the challenge body was empty, so exact payment parameters (token address, network, facilitator address) could not be verified from the probe alone. The landing page states USDC on Base is the settlement currency.
Capabilities
Use cases
- —AI agents estimating optimal gas fees before submitting DeFi transactions
- —Trading bots choosing gas price tiers to balance speed vs. cost
- —Autonomous agents monitoring gas conditions to time transaction submissions
- —DeFi dashboards displaying current gas price tiers
Fit
Best for
- —Autonomous AI agents needing per-call gas price data with x402 micropayments
- —DeFi trading bots that require real-time gas tier information
- —Developers building on Base who want pay-per-request gas oracles
Not for
- —Applications needing free or high-volume gas data (per-call cost adds up)
- —Users who need detailed historical gas analytics rather than real-time snapshots
- —Non-crypto applications with no x402 payment infrastructure
Quick start
# Free discovery (GET)
curl https://defi-shield-hazel.vercel.app/api/mev/gas-oracle
# Paid request (POST, requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/mev/gas-oracle \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>"Endpoint
Quality
The endpoint is confirmed live via a 402 challenge on POST, and the landing page provides pricing and a brief description. However, the x402 challenge body was empty (no payment parameters captured), no OpenAPI schema exists, no request/response examples are documented, and all doc pages return 404. Effectively a stub with confirmed liveness.
Warnings
- —x402 challenge body was empty — exact payment parameters (token address, facilitator, amount in base units) could not be verified from probe
- —No OpenAPI spec or detailed API documentation found; /docs returns 404
- —No request or response schema available — input parameters and output format are unknown
- —Pricing ($0.05/call in USDC on Base) is sourced only from the landing page, not from the x402 challenge itself
Citations
- —Gas oracle endpoint is priced at $0.05 per call, paid in USDC via x402 on Basehttps://defi-shield-hazel.vercel.app
- —DeFi Shield offers 69 paid API endpoints across 11 categorieshttps://defi-shield-hazel.vercel.app
- —Free endpoint discovery is available via GET on every endpoint pathhttps://defi-shield-hazel.vercel.app
- —x402 challenge returned HTTP 402 on POST confirming the endpoint is livehttps://defi-shield-hazel.vercel.app/api/mev/gas-oracle