{"uid":"cap_UWGb9BpvyucY1P_HOI5Gk","slug":"alphapipeline-funding-apr-matrix-66192f86","name":"AlphaPipeline Funding APR Matrix","description":"Annualizes the current perpetual funding rate into an APR, flags which side (SHORT or LONG perp) currently collects funding, and computes carry-trade breakeven days against an assumed round-trip trading cost. Pure calculation on top of funding-rate data. Paid in USDC on Base.","url":"https://alphapipeline-eu.onrender.com/v1/derivatives/funding-apr-matrix?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Ticker symbol, e.g. BTC, ETH, or BTCUSDT."},"assumed_round_trip_cost_pct":{"type":"number","description":"Combined entry+exit trading fee percentage across both the spot and perpetual legs. Defaults to 0.2."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"FundingAprMatrixResponse","required":["generated_at","symbol","assumed_round_trip_cost_pct","data_source"],"properties":{"notice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notice","default":null},"symbol":{"type":"string","title":"Symbol"},"data_source":{"type":"string","title":"Data Source"},"generated_at":{"type":"object","title":"TimestampPair","required":["utc","kst"],"properties":{"kst":{"type":"string","title":"Kst"},"utc":{"type":"string","title":"Utc"}}},"breakeven_days":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Breakeven Days","default":null},"periods_per_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Periods Per Year","default":null},"annualized_rate_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Annualized Rate Pct","default":null},"funding_collector_side":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Funding Collector Side","default":null},"funding_interval_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Funding Interval Hours","default":null},"funding_rate_percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Funding Rate Percentage","default":null},"daily_funding_income_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Daily Funding Income Pct","default":null},"assumed_round_trip_cost_pct":{"type":"number","title":"Assumed Round Trip Cost Pct"}}}}}}},"responseSchema":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_FB59QBqt6GXT3GCKQd1cO","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":"Annualizes a perpetual futures funding rate into APR, identifies which side collects funding (LONG or SHORT), and computes carry-trade breakeven days given a round-trip trading cost assumption.","exampleAgentPrompt":"What's the annualized funding APR for BTC perpetuals right now, which side is collecting — longs or shorts — and how many days to break even on a carry trade assuming a 0.2% round-trip cost?","exampleUseCases":[{"title":"BTC carry trade profitability check","prompt":"I'm thinking about running a BTC cash-and-carry trade. What's the current annualized funding APR, which side collects, and how many days before the trade breaks even if I assume 0.25% total round-trip fees?"},{"title":"ETH funding yield monitoring","prompt":"What's the annualized funding rate on ETH perps right now, and is the funding flowing to longs or shorts? Also give me the daily income percentage."},{"title":"SOL perp funding regime assessment","prompt":"Check the funding APR matrix for SOL — I want to know the annualized rate, who's collecting funding, and how long it takes to break even assuming a 0.15% round-trip trading cost."}],"resultDescription":"Returns a JSON object containing: the annualized funding rate as a percentage (APR), the funding collector side (LONG or SHORT), daily funding income percentage, funding rate percentage per interval, funding interval in hours, number of funding periods per year, breakeven days against the assumed round-trip cost, timestamps in UTC and KST, the data source, and an optional notice field.","failureModes":["Unknown or unsupported symbol returns null fields or an error response","Funding rate data unavailable from Bybit and Binance fallback also fails — fields return null","Invalid assumed_round_trip_cost_pct (e.g. negative value) may produce nonsensical breakeven_days","Rate limit or upstream outage on the render.com host causes timeout or 5xx","Payment not included or insufficient USDC results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a ready-made, single-call annualized funding yield calculation with carry-trade breakeven analysis — rather than pulling raw funding rates and doing the annualization math yourself. It is especially useful for agents performing pre-trade carry-trade feasibility checks, comparing funding regimes across assets, or surfacing which market side currently earns yield on perpetual positions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:35:24.013Z","isFirstParty":false,"canonicalSlug":"alphapipeline-funding-apr-matrix-66192f86"}