{"uid":"cap_m6373U3u1KGsGtYhJeUmf","slug":"reliable-eth-price-oracle-with-fallback-d1dc0e83","name":"Reliable ETH Price Oracle with Fallback","description":"Reliability: ETH/USD price with retry-with-backoff and last-known-good cache fallback layered on top — sells dependability, not the raw data itself. Optional ?simulateFailureRate=0-1 for demoing the fallback path.","url":"https://lab.paidapis.net/api/reliable-eth-price","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"simulateFailureRate":{"type":"number","description":"0-1, simulates upstream failures to demo the fallback path."}}},"responseSchema":{"type":"object","properties":{"source":{"enum":["live","cache-fallback"],"type":"string"},"attempts":{"type":"integer"},"ethUsdPrice":{"type":"number"},"cacheAgeSeconds":{"type":["number","null"]},"simulateFailureRate":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_htDu_B3Wbqbz3sDoZw_0p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current ETH/USD price with automatic cache-fallback on upstream failures, demonstrating a resilient oracle pattern on Base mainnet via x402 micropayments.","exampleAgentPrompt":"What's the current ETH/USD price? Use the reliable oracle that falls back to cache if live data fails — go ahead and simulate a 30% failure rate so I can see the fallback in action.","exampleUseCases":[{"title":"Live ETH price for portfolio tracker","prompt":"Fetch me the current ETH/USD price using the reliable oracle — I want to know whether it came from a live feed or a cached fallback and how old the cache is."},{"title":"Resilience demo with simulated failures","prompt":"Pull the ETH price but simulate an 80% upstream failure rate so I can see how the fallback cache path works and how many attempts it takes to succeed."},{"title":"DeFi app price feed integration","prompt":"Get me the latest ETH/USD price from the paid oracle endpoint — I need the numeric price and the source field so I know if it's live or cached."}],"resultDescription":"Returns a JSON object with the ETH/USD price as a number, the data source ('live' or 'cache-fallback'), the number of fetch attempts made, the cache age in seconds (null if live), and the simulated failure rate used. Costs $0.01 USDC per call via x402 on Base mainnet.","failureModes":["Payment not provided or invalid x402 header — returns 402 Payment Required","simulateFailureRate set to 1.0 causing all upstream attempts to fail — may return error or max-retry cache fallback","Network timeout to upstream price provider — falls back to cache if available","Cache not yet populated (cold start) with high simulateFailureRate — may return error with no price data"],"whenToPreferThis":"Choose this endpoint when you need an ETH/USD price with explicit resilience semantics — it clearly signals whether the price is live or from cache and how stale the cache is. Prefer it over generic price APIs when you need to demonstrate or test oracle fallback patterns, or when building on x402 micropayment infrastructure on Base mainnet. It is not a production-grade price feed but is ideal for x402 integration testing, educational demos, or prototyping DeFi tooling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:44:45.072Z","isFirstParty":false}