{"uid":"cap_Pn5sH1gh9IQgZ-CsszrVx","slug":"carrylens-perpetual-funding-pulse-60389990","name":"CarryLens Perpetual Funding Pulse","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/pulse","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":{"caveat":"Funding can change; caller-supplied costs are not an execution quote.","assumptions":{"notionalUsd":10000,"holdingHours":168,"totalCostBps":20},"markets_screened":200,"benchmark_markets":[{"coin":"BTC","basis_bps":2.1,"change_24h_pct":1.2,"funding_annualized_pct":8.4}],"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}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_I67QbHbp2NYH6A6VwXLRR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top 3 cost-adjusted cross-venue perpetual funding carry spreads with net funding projections, break-even time, and liquidity tiers for BTC, ETH, and SOL.","exampleAgentPrompt":"Pull the top cross-venue perp carry spreads for a $25,000 notional position held for 48 hours with 8 bps all-in costs so I can see the projected net funding and break-even time for each opportunity.","exampleUseCases":null,"resultDescription":"A JSON object containing the caller's assumptions (notional, holding hours, cost bps) and an array of the top 3 cross-venue perpetual funding carry spread opportunities, each with the venue pair, gross funding dollars, projected net funding after supplied costs, break-even time in hours, liquidity tier classification, and BTC/ETH/SOL funding rate context.","failureModes":["notionalUsd outside 100–100,000,000 range returns validation error","holdingHours outside 1–2160 returns validation error","totalCostBps outside 0–2000 returns validation error","malformed numeric string for any query param returns 400","upstream funding rate data unavailable returns 503 or stale data warning","payment of $0.003 USDC not settled returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when a trading agent needs real-time, cost-adjusted ranking of cross-venue perpetual funding carry trades — specifically when the agent has a known notional size, holding period, and all-in fee estimate and wants to identify the top actionable spread opportunities with break-even analysis rather than raw funding rate data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:33:11.358Z","isFirstParty":false}