{"uid":"cap_1F-U8d-ZqDEaSeEoGtKcW","slug":"agent402-perpetual-futures-basis-funding-rate-lookup-1c146ff8","name":"Agent402 Perpetual Futures Basis & Funding Rate Lookup","description":"Basis for one perpetual: mark versus oracle premium in percent and basis points, impact premium, current funding and the predicted next funding per venue. Use it when an agent is evaluating a cash-and-carry, comparing funding across venues or deciding whether a perp is trading rich or cheap to spot.","url":"https://agent402.tools/api/perp-basis","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"coin":{"type":"string","description":"Perp ticker, e.g. BTC, ETH, SOL."}}},"responseSchema":{"type":"json","example":{"coin":"BTC","midPx":77266.5,"markPx":77267,"source":"hyperliquid","funding":{"per8h":0.0001,"aprPct":10.95,"hourly":0.0000125},"oraclePx":77236,"fetchedAt":"2026-08-22T12:00:00.000Z","impactPremiumPct":0.0388,"predictedFunding":[{"per8h":0.0001,"venue":"HlPerp","aprPct":10.95,"fundingRate":0.0000125,"nextFundingTime":"2026-08-22T13:00:00.000Z","fundingIntervalHours":1}],"markOraclePremiumBps":4.01,"markOraclePremiumPct":0.0401}},"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_uQjtnTjgjv46ivvspDSPI","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 real-time perpetual futures basis data including mid price, mark price, oracle price, funding rates, and predicted funding for a given crypto asset ticker.","exampleAgentPrompt":"What's the current perpetual funding rate and basis for BTC right now — including the mark-oracle premium and predicted next funding interval?","exampleUseCases":[{"title":"Funding rate arbitrage opportunity scan","prompt":"Check the current annualized funding rate APR and mark-oracle premium for ETH perps so I can decide whether to go long spot and short the perp to capture funding."},{"title":"Real-time perp basis monitoring for SOL","prompt":"What's the live basis between mark price and oracle price for SOL perpetual futures, and what is the predicted funding rate for the next interval?"},{"title":"Pre-trade perp pricing check for BTC","prompt":"Before I open a position, can you pull the current mid price, mark price, and 8-hour funding rate for BTC perps on Hyperliquid?"}],"resultDescription":"Returns a JSON object with the coin ticker, mid price, mark price, oracle price, impact premium percent, mark-oracle premium in both bps and percent, current funding rate (per 8h, hourly, and annualized APR), and an array of predicted funding entries each with venue, rate, APR, and next funding timestamp.","failureModes":["Invalid or unsupported ticker symbol — returns error or empty data","Hyperliquid data source temporarily unavailable — stale or missing fetchedAt","Network timeout on upstream perp data fetch — delayed or failed response","Malformed request body missing 'coin' field — likely 400 or validation error"],"whenToPreferThis":"Use this endpoint when you need real-time perpetual futures pricing and funding rate data sourced from Hyperliquid, particularly when you want both current and predicted funding intervals, mark-oracle spread in basis points, and annualized funding APR in a single call. Prefer this over generic crypto price feeds when the specific data needed is perp basis and funding mechanics rather than spot price alone.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:08.716Z","isFirstParty":false}