{"uid":"cap_jdInx5L7GxLtkPt4P31fK","slug":"carrylens-perpetual-funding-screen-api-d632d0e8","name":"CarryLens Perpetual Funding Screen API","description":"Live, cost-aware cross-venue perpetual-funding screens for trading agents. x402 payment; no API key or account.","url":"https://carry-lens-api.netlify.app/v1/perps/report?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":{"notionalUsd":{"type":"string","pattern":"^(?:\\d+(?:\\.\\d*)?|\\.\\d+)$","description":"Matched USD notional on each hedged leg (100 to 100000000)."},"holdingHours":{"type":"string","pattern":"^(?:\\d+(?:\\.\\d*)?|\\.\\d+)$","description":"Expected holding period in hours (1 to 2160)."},"totalCostBps":{"type":"string","pattern":"^(?:\\d+(?:\\.\\d*)?|\\.\\d+)$","description":"All-in entry and planned-exit fees plus slippage in bps (0 to 2000)."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["assumptions","top_cross_venue_carry_spreads"],"properties":{"assumptions":{"type":"object"},"top_cross_venue_carry_spreads":{"type":"array"}}}}}}},"responseSchema":{"type":"json","example":{"risk_flags":["no_systemic_threshold_breach_detected"],"assumptions":{"notionalUsd":10000,"holdingHours":168,"totalCostBps":20},"market_regime":{"label":"balanced","stress_score_0_to_100":18.5,"advancing_market_share_pct":54.2},"top_cross_venue_carry_spreads":[{"coin":"BTC","longVenue":"HlPerp","costScreen":"passes","shortVenue":"BinPerp","executionTier":"high","projectedEconomics":{"breakEvenHours":14.1,"grossFundingUsd":237.81,"netAnnualizedPct":113.57,"assumedTotalCostUsd":20,"projectedNetYieldPct":2.1781,"projectedNetFundingUsd":217.81},"grossSpreadAnnualizedPct":12.4}],"hyperliquid_funding_persistence_24h":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_V6WhaCRoZGoU28xNsi_xl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live, cost-aware cross-venue perpetual futures funding rate spreads and carry trade economics for trading agents, ranked by projected net yield.","exampleAgentPrompt":"Pull the best cross-venue perpetual carry spreads right now for a $10,000 notional held for 168 hours, assuming 20 bps all-in costs, and show me which pairs have the highest net annualized yield.","exampleUseCases":[{"title":"Delta-neutral carry trade screening","prompt":"Screen all perp pairs for cross-venue funding carry opportunities on a $50,000 notional, 72-hour hold, with 15 bps total costs — rank them by net annualized yield so I can pick the best delta-neutral trade."},{"title":"Break-even timing for short hold","prompt":"I'm planning to hold a cross-venue perp carry position for just 8 hours with $5,000 notional and 30 bps in costs — which coins will break even fast enough to be worth it?"},{"title":"Market regime check before execution","prompt":"Before I put on any funding carry trades today, tell me the current market regime stress score and whether there are any systemic risk flags I should know about, using a $25,000 notional and 10 bps assumed costs."}],"resultDescription":"Returns a ranked list of cross-venue perpetual funding carry spreads with projected economics (gross funding USD, net annualized %, breakeven hours, net yield %, net funding USD, assumed costs), plus a market regime label and stress score, risk flags, and Hyperliquid 24h funding persistence data — all computed against the supplied notional, holding period, and cost assumptions.","failureModes":["Missing or malformed 'notionalUsd' pattern (must be numeric string 100–100000000) returns validation error","'holdingHours' out of range (must be 1–2160) causes rejection","'totalCostBps' exceeding 2000 is rejected","Payment failure via x402 (insufficient USDC balance or missing payment header) blocks the response","No carry spreads returned when funding rates are too compressed to pass cost screen"],"whenToPreferThis":"Choose this endpoint when an AI trading agent needs live, cost-adjusted cross-venue perpetual funding rate comparisons ready for immediate trade sizing — especially when the agent needs projected net economics (not just raw rates), market regime context, and risk flags in a single call, without needing an API key or account. Prefer this over generic market data APIs when the goal is actionable carry trade screening with fee/slippage modeling built in.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:37:51.339Z","isFirstParty":false,"canonicalSlug":"carrylens-perpetual-funding-screen-api-d632d0e8"}