{"uid":"cap__xOUv_zcEG3F4lznAyx_H","slug":"merkl-stable-yield-ranking-api-c917bbb8","name":"Merkl Stable Yield Ranking API","description":"Exact EVM address, calldata, Uniswap V2/V3 and impermanent-loss math. Pay per call in USDC on Base via x402.","url":"https://golf-evm-math.x402-evm-math.workers.dev/merkl-stable?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","stamp":"data from echo, updated 2026-10-22 22:50 UTC","campaigns":[{"rank":1,"apr_pct":37.2,"tvl_usd":262752,"campaign":"Supply USDC vault","protocol":"Hyperdrive","days_left":160,"net_apr_pct":37.1}],"data_from":"echo"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_42kk44yaOeQbykkGe_-aj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live-ranked list of stablecoin yield opportunities on Base from Merkl reward campaigns, sorted by net APR after gas, filtered to TVL ≥ $100k, refreshed every 2 hours.","exampleAgentPrompt":"What are the top stablecoin yield opportunities on Base right now? I want to see the best net APR from Merkl campaigns, ranked, with TVL above $100k.","exampleUseCases":[{"title":"Yield farming allocation decision","prompt":"Show me the top 5 stablecoin yield campaigns on Base by net APR right now — I want to see which Merkl protocols are offering the best returns before I deploy capital."},{"title":"Daily DeFi yield briefing","prompt":"Give me a quick rundown of today's best stable APY opportunities on Base from Merkl, including how many days are left in each campaign and what the TVL looks like."},{"title":"Yield monitoring for portfolio agent","prompt":"Check the current Merkl stablecoin yield rankings on Base and alert me if any campaign is offering a net APR above 20% with at least 30 days remaining."}],"resultDescription":"A JSON object containing the chain name, a timestamp of the last data refresh, and an array of ranked stablecoin yield campaigns. Each campaign entry includes its rank, gross APR percentage, net APR percentage (after gas), TVL in USD, protocol name, campaign name, and days remaining in the campaign. Data is sourced from Merkl and refreshed every 2 hours.","failureModes":["Stale data if Merkl upstream is delayed beyond the 2-hour refresh window","Empty campaign array if no campaigns currently meet the TVL ≥ $100k threshold on Base","Payment failure (402) if USDC micropayment is not correctly submitted via x402 protocol","Rate limiting or worker timeout on the Cloudflare edge if traffic spikes","Partial data if Merkl API returns incomplete campaign information during refresh"],"whenToPreferThis":"Choose this endpoint when you need a pre-filtered, pre-ranked, gas-adjusted stablecoin yield snapshot specifically on Base from Merkl campaigns — it saves you from querying Merkl directly and applying TVL filters and net APR calculations yourself. Ideal for yield farming agents that need a quick, actionable ranking without raw data wrangling. Prefer this over generic DeFi aggregators when you specifically want Merkl reward campaign data on Base with a freshness guarantee of 2 hours.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:41:10.263Z","isFirstParty":false,"canonicalSlug":"merkl-stable-yield-ranking-api-c917bbb8"}