{"uid":"cap_O_fALDQ8cRBmlo-2tP2yt","slug":"agent402-perpetual-futures-funding-rate-1a4bb10f","name":"Agent402 Perpetual Futures Funding Rate","description":"Current and historical funding rate for one perpetual futures market, from a live derivatives venue: hourly rate, the 8-hour and annualized equivalents, the mark-vs-oracle premium, and a window of past prints with average, minimum, maximum and the share that were positive. Use it when an agent needs to know what holding a leveraged position costs right now, or wants to detect a funding regime flip before sizing a trade.","url":"https://agent402.tools/api/perp-funding","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"coin":{"type":"string","description":"Perp ticker, e.g. BTC, ETH, SOL (case-insensitive)."},"limit":{"type":"number","description":"Hourly history points to return (default 24, max 500)."}}},"responseSchema":{"type":"json","example":{"coin":"BTC","stats":{"points":24,"avgPer8h":0.0001,"avgAprPct":10.95,"avgHourly":0.0000125,"maxHourly":0.0000125,"minHourly":0.0000125,"positiveSharePct":100},"markPx":77267,"source":"hyperliquid","current":{"per8h":0.0001,"aprPct":10.95,"hourly":0.0000125,"premiumPct":0.0388},"history":[{"time":"2026-08-22T11:00:00.000Z","premium":0.00043,"fundingRate":0.0000125}],"fetchedAt":"2026-08-22T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zgvl99MQwWB_9xi8FMPW6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current and historical funding rates for a specified perpetual futures market, including hourly, 8-hour, and annualized rates, mark-vs-oracle premium, and windowed statistics.","exampleAgentPrompt":"What's the current funding rate for BTC perpetual futures — give me the hourly rate, 8-hour equivalent, and the last 48 hours of history so I can see if the regime has been consistently positive or recently flipped.","exampleUseCases":[{"title":"Pre-trade funding cost check","prompt":"Before I open a long SOL perp position, what's the current hourly funding rate and its annualized equivalent? I want to know what it'll cost me to hold this position."},{"title":"Funding regime flip detection","prompt":"Has the ETH perpetual funding rate flipped from positive to negative recently? Give me the last 72 hours of prints and tell me the average, min, max, and what share were positive."},{"title":"Cross-market carry opportunity scan","prompt":"What's the current annualized funding rate for BTC perps, and what's the mark-vs-oracle premium right now? I'm trying to figure out if there's a carry trade worth running."}],"resultDescription":"Returns the current hourly funding rate, 8-hour equivalent, and annualized rate for the specified perp market, the mark-vs-oracle price premium, and a time series of historical hourly funding prints (up to the requested limit) with aggregate statistics: mean, min, max, and the fraction of periods where funding was positive.","failureModes":["Unknown ticker symbol returns an error or empty result","Limit value exceeding 500 may be clamped or rejected","Network or venue outage may return stale or unavailable data","Case-sensitive input errors resolved by case-insensitive normalization","No data returned if the market has insufficient history for the requested window"],"whenToPreferThis":"Choose this endpoint when an agent needs real-time or historical perpetual futures funding rate data — specifically the cost of holding a leveraged position, regime detection (positive vs negative funding), or carry trade analysis. Prefer this over generic market data APIs when you need funding-specific metrics like the 8-hour rate, annualized equivalent, and mark-vs-oracle premium all in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:56:16.064Z","isFirstParty":false}