{"uid":"cap_e5bGHspZgo4KKRSyLIp_5","slug":"api-usenami-io-06334a45","name":"Nami Volume-Weighted Average Funding Rate","description":"Volume-weighted average funding rate across all tracked venues for one crypto perpetual. Accounts for venue market share — high-volume venues dominate the weighted rate, so it reflects what the market actually pays rather than a flat average across thin and deep venues alike.","url":"https://api.usenami.io/v1/perp/vw-spread","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","method":"GET"},"ticker":"BTC"},"response":{"ticker":"BTC","vw_rate":0.0000254402,"updated_at":"2026-06-12T04:10:51.534309Z","venues_count":24,"simple_avg_rate":0.0000309824,"top_contributors":[{"rate":0.00002931,"venue":"Binance","weight_pct":30.75,"volume_24h_usd":11246181314.72},{"rate":0.000029,"venue":"MEXC","weight_pct":12.43,"volume_24h_usd":4544285336.34578},{"rate":0.00005665,"venue":"Bybit","weight_pct":11.97,"volume_24h_usd":4377767143.6521},{"rate":0.00003,"venue":"Gate.io","weight_pct":11.96,"volume_24h_usd":4375529154},{"rate":-0.00002,"venue":"Bitget","weight_pct":8.33,"volume_24h_usd":3047929475.54619}],"total_volume_24h_usd":36571065751.96}},"exampleRequest":{"input":{"type":"perpetual","method":"GET"},"ticker":"BTC"},"tags":["x402"],"displayCostAmount":"0.003","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.003/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_E7mVix5cQSLeRON8-ZpCj","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 volume-weighted average perpetual funding rate across all venues for a given ticker, weighting each venue's rate by its market share.","exampleAgentPrompt":"What's the volume-weighted average funding rate for BTC perpetuals right now across all venues, taking into account each exchange's market share?","exampleUseCases":null,"resultDescription":"A composite funding rate for the requested ticker, computed as a weighted average across all tracked venues where each venue's rate is weighted by its share of total trading volume. High-volume venues dominate the resulting rate.","failureModes":["Invalid or unsupported ticker symbol returns a 4xx error","No venue data available for ticker returns empty or zero result","Venue data temporarily unavailable causes incomplete weighting","Payment not included or insufficient results in 402 Payment Required","Rate limiting may apply if call volume is exceeded"],"whenToPreferThis":"Use this endpoint when you need a single representative funding rate for a ticker that fairly reflects the overall market, rather than rates from a single exchange. Ideal for position cost modeling, delta-neutral strategy evaluation, or any scenario where you want a volume-adjusted blended rate rather than a simple average or single-venue rate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:30.065Z","isFirstParty":false}