{"uid":"cap_tkfAXHIBpVRqqfQ4GjLBd","slug":"x402stock-perpetuals-predicted-funding-rate-4ff3fac4","name":"x402stock Perpetuals Predicted Funding Rate","description":"Returns live state of one perpetual-futures market by coin.","url":"https://agents.x402stock.xyz/api/v1/perps/predicted-funding?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["coin"],"properties":{"coin":{"not":{"enum":["predicted-funding"]},"type":"string","description":"Hyperliquid perpetual coin symbol, e.g. BTC or ETH."}}},"responseSchema":{"type":"object","required":["source","as_of","venue","market","data"],"properties":{"data":{"type":"object","required":["coin","max_leverage","mark_price","oracle_price","mid_price","prev_day_price","funding_rate_hourly","funding_apr_percent","premium","open_interest","day_volume_usd","day_volume_base"],"properties":{"coin":{"type":"string"},"premium":{"anyOf":[{"type":"number"},{"type":"null"}]},"mid_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"mark_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"max_leverage":{"type":"number"},"oracle_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"open_interest":{"anyOf":[{"type":"number"},{"type":"null"}]},"day_volume_usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"prev_day_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"day_volume_base":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_apr_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_rate_hourly":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"as_of":{"type":"string"},"venue":{"type":"string"},"market":{"type":"string","const":"perp"},"source":{"type":"string","const":"x402stock"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USD","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h9Jnt7dk84Sl1LLRcztmr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_0m8s9D_IcKlX6nO1-fJd2","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns predicted funding rates for on-chain perpetual futures contracts","exampleAgentPrompt":"What's the predicted funding rate for BTC perpetual futures right now? I want to know what carry cost to expect before opening a long position.","exampleUseCases":[{"title":"Pre-trade funding cost check","prompt":"Before I open a long ETH perp position, what's the predicted funding rate? I want to see if it's cheap or expensive to hold."},{"title":"Arbitrage carry assessment","prompt":"Give me the predicted funding rate for BTC perpetuals so I can figure out if the cash-and-carry arb is worth it right now."},{"title":"Portfolio funding monitoring","prompt":"What are the predicted funding rates for SOL and AVAX perpetuals? I need to estimate overnight carry costs across my perp book."}],"resultDescription":"Returns predicted funding rate data for a specified on-chain perpetual futures contract, including the forecasted rate percentage, funding interval, and relevant contract metadata such as trading pair and exchange.","failureModes":["Invalid or unsupported perpetual contract identifier returns 400 or empty result","Payment failure via x402/MPP results in 402 Payment Required","Unknown exchange or trading pair returns no data","Network timeout or upstream data source unavailability returns 5xx","Malformed request body returns validation error"],"whenToPreferThis":"Choose this endpoint when you need forward-looking predicted funding rates for on-chain perpetual futures, particularly for pre-trade carry cost analysis or arbitrage modeling. Prefer this over spot price or historical funding endpoints when the goal is estimating future funding payments before entering or holding a perp position.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:02:05.818Z","isFirstParty":false,"canonicalSlug":"x402stock-perpetuals-predicted-funding-rate-4ff3fac4"}