{"uid":"cap_0IKwRqfImLM7CVKwVYUW7","slug":"api-usenami-io-0a42a0cf","name":"Nami Perpetual Funding Next Payment ETA & Rate","description":"Next funding payment ETA for one crypto perpetual on one venue, with the current indicative funding rate alongside — when the next settlement lands and where the rate stands now. Entry-timing input for funding-arb and carry trades. Not a payment forecast: the endpoint takes no position side or size, and the rate can move before settlement.","url":"https://api.usenami.io/v1/perp/funding-next","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"},"method":{"type":"string"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"perpetual_futures","method":"GET"},"venue":"binance","ticker":"BTC"},"response":{"venue":"binance","ticker":"BTC","mark_price":63906.50023913,"updated_at":"2026-06-18T05:25:28.106420Z","current_rate":0.0000151,"next_funding_time":"2026-06-18T08:00:00Z","funding_interval_hours":8}},"exampleRequest":{"input":{"type":"perpetual_futures","method":"GET"},"venue":"binance","ticker":"BTC"},"tags":["x402"],"displayCostAmount":"0.003000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.003000/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_fA8i44apXv2Ndb3rgqUcl","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 next funding payment timestamp (ETA) and predicted funding rate for a specific ticker/venue pair on perpetual futures markets.","exampleAgentPrompt":"What's the next funding payment ETA and predicted rate for BTC perps on Binance right now — I'm deciding whether to enter before or after the next funding event.","exampleUseCases":null,"resultDescription":"Returns the estimated time until the next funding payment (ETA) and the predicted funding rate size for the specified ticker and venue, enabling entry timing decisions around funding events.","failureModes":["Unsupported ticker or venue pair returns an error or empty result","Stale or unavailable market data may produce inaccurate rate predictions","Missing required input fields (ticker or venue) returns a 400-level error","Rate limit exceeded or payment failure returns a 402/429 error"],"whenToPreferThis":"Use this endpoint when you need real-time next-funding-event timing and rate prediction for a specific perpetual futures ticker on a named venue — particularly for entry/exit timing strategies that depend on funding arbitrage or cost avoidance. Prefer this over the cross-venue funding spread endpoint when you already know which venue you're trading on and want precise payment countdown data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:43:50.631Z","isFirstParty":false}