{"uid":"cap_fgdqYG_cQlkbdOzpfXB8v","slug":"perpetual-funding-carry-cost-calculator-b2a440e5","name":"Perpetual Funding Carry Cost Calculator","description":"Pay-per-call analytics on live perpetual-futures microstructure: what it costs to execute a size, what it costs to hold a position, and how much liquidity a market really has. USDC via x402 on Base, no account and no API key. Each response states the limit of its own instrument rather than implying none.","url":"https://x402.presenceoperations.com/services/carry-cost?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["market","notional"],"properties":{"side":{"enum":["LONG","SHORT"],"type":"string","default":"LONG","description":"which side of the funding you are on; the two answers have opposite signs, so anything outside LONG or SHORT is refused rather than read as the default"},"hours":{"type":"number","default":"8","maximum":720,"minimum":1,"description":"the holding horizon to project over; bounded because funding resets hourly and a projection past a month is a number with the shape of an answer and none of the content"},"market":{"type":"string","pattern":"^[A-Z0-9]{1,16}-PERP$","description":"the perpetual market to price the carry of, upper-cased before matching, for example BTC-PERP"},"notional":{"type":"number","maximum":100000000,"minimum":1,"description":"the position size to price the funding on, in quote currency"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object"}}},"responseSchema":{"type":"json","example":{"side":"","hours":0,"detail":"","market":"","notional":0,"direction":"","markPrice":"","assumption":"","observedAt":"","oraclePrice":"","openInterest":"","fundingPerHour":"","basisBasisPoints":0,"hourlyFundingRate":"","annualisedRateBasisPoints":0,"projectedFundingOverHorizon":""}},"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_7x8CbtdYFw0qkOShwc6eX","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":"Returns the projected funding cost of holding a perpetual futures position over a specified horizon, including hourly funding rate, mark-to-oracle basis, open interest, and annualized rate.","exampleAgentPrompt":"What's the carry cost to hold a $50,000 long position on BTC-PERP over the next 48 hours — give me the projected funding, the hourly rate, and the mark-to-oracle basis?","exampleUseCases":[{"title":"Overnight position funding check","prompt":"I'm holding a $25,000 long on ETH-PERP and I want to know how much funding I'll pay if I keep it open for the next 24 hours — what's the projected carry cost and the annualized rate?"},{"title":"Short-side funding income estimate","prompt":"I'm considering shorting $100,000 notional of SOL-PERP for 72 hours. How much funding would I collect or pay, and what's the current mark-to-oracle basis?"},{"title":"Week-long carry cost comparison","prompt":"Can you tell me the 168-hour projected funding cost for a $10,000 long on BTC-PERP, including the hourly funding rate and what assumption is being used for the projection?"}],"resultDescription":"A JSON object containing: the market and side you queried, the observed hourly funding rate and its annualized equivalent in basis points, the projected total funding cost over your specified horizon in quote currency, the current mark price and oracle price, the basis between them in basis points, total open interest on the market, a plain-English description of the assumption behind the projection, and the timestamp of observation.","failureModes":["Invalid market symbol format (must match ^[A-Z0-9]{1,16}-PERP$) returns an error","Side value outside LONG or SHORT is refused rather than defaulted","Hours value outside 1-720 range is rejected","Notional outside $1-$100,000,000 range is rejected","Market not found or not actively traded returns an error","402 Payment Required if x402 payment header is missing or insufficient"],"whenToPreferThis":"Use this endpoint when you need a precise, signed, horizon-specific carry cost for a perpetual futures position — not just a raw funding rate. It is uniquely valuable because it explicitly states the projection assumption, provides the mark-to-oracle basis, and scopes the answer to your actual notional and side, rather than returning a generic rate you must interpret yourself. Prefer it over raw exchange funding rate APIs when the agent needs a decision-ready cost figure rather than a raw rate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:42:15.251Z","isFirstParty":false,"canonicalSlug":"perpetual-funding-carry-cost-calculator-b2a440e5"}