{"uid":"cap_pBGACwVsOppRoFXc2WCbW","slug":"insured-eth-usd-price-feed-subscription-4792269c","name":"Insured ETH/USD Price Feed Subscription","description":"Insured data feed: pay a premium for an ETH/USD price snapshot (?premiumUsdc=, ?maxDeviationPct=, ?checkDelaySeconds=). If the real price has drifted more than your insured tolerance by the checkpoint, claim a 2x refund — a real payout for genuinely stale data, not a fabricated failure.","url":"https://lab.paidapis.net/api/insured-feed/subscribe","method":"POST","headers":{},"bodySchema":{"type":"object","required":["premiumUsdc","subscriberAddress"],"properties":{"premiumUsdc":{"type":"number","description":"Premium to pay, up to 5."},"maxDeviationPct":{"type":"number","description":"Insured tolerance in percent (default 1)."},"checkDelaySeconds":{"type":"integer","description":"Seconds until the checkpoint, up to 3600 (default 30)."},"subscriberAddress":{"type":"string","description":"Wallet address eligible for the insurance payout."}}},"responseSchema":{"type":"object","properties":{"status":{"enum":["pending-check","held","claim-eligible","refunded"],"type":"string"},"checkAt":{"type":"string"},"premiumUsdc":{"type":"number"},"subscribedAt":{"type":"string"},"subscriptionId":{"type":"string"},"maxDeviationPct":{"type":"number"},"subscriberAddress":{"type":"string"},"actualDeviationPct":{"type":["number","null"]},"snapshotEthUsdPrice":{"type":"number"},"liveEthUsdPriceAtCheck":{"type":["number","null"]}}},"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_1zEFwFzcCkWMu9cB6BhFO","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":"Creates a price-insurance subscription that snapshots the ETH/USD oracle price and pays out from an escrow to a subscriber wallet if the price deviates beyond a set tolerance at a future checkpoint.","exampleAgentPrompt":"Set up an ETH price insurance subscription for my wallet 0xAbC123... — I want to pay a 2 USDC premium, allow up to 2% deviation, and check the price in 300 seconds to see if I'm eligible for a payout.","exampleUseCases":[{"title":"Short-term ETH price spike protection","prompt":"I'm about to execute a large ETH trade and want insurance in case ETH moves more than 1.5% in the next 10 minutes — subscribe me with a 1 USDC premium and use my wallet 0xDEF456... as the payout address."},{"title":"Overnight price deviation hedge","prompt":"Set up an ETH price insurance for my wallet 0x789GHI... with a 5 USDC premium, a 3% deviation tolerance, and a checkpoint 3600 seconds from now so I'm covered while I sleep."},{"title":"x402 escrow pattern experiment","prompt":"I'm learning how x402 payment-gated insured feeds work — subscribe with a 0.5 USDC premium, default 1% deviation, 30-second delay, and payout address 0xJKL012...."}],"resultDescription":"Returns a subscription record including a unique subscriptionId, the ETH/USD price snapshotted at subscription time, the scheduled checkpoint timestamp, the subscriber wallet address, the premium paid, and the configured deviation tolerance. After the checkpoint, status updates to 'claim-eligible' (deviation exceeded) or 'held'/'refunded', and includes the live ETH/USD price and actual deviation percentage observed.","failureModes":["Missing required fields (premiumUsdc or subscriberAddress) returns a 400 validation error","premiumUsdc exceeding 5 USDC is rejected","checkDelaySeconds exceeding 3600 is rejected","Invalid subscriber wallet address format causes rejection","Payment not included or insufficient USDC via x402 returns HTTP 402","Oracle price unavailable at snapshot time may cause internal error"],"whenToPreferThis":"Choose this endpoint when you want to demonstrate or use an on-chain insurance pattern gated by the x402 micropayment protocol — specifically when the goal is to receive a USDC payout if the ETH/USD price deviates beyond a configurable tolerance at a future checkpoint. Prefer it over generic oracle feeds when you need the escrow-and-payout insurance mechanic, not just price data. Best for DeFi experiments, x402 protocol learning, or lightweight hedging on Base mainnet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:42:57.720Z","isFirstParty":false}