{"uid":"cap_nBq_RwAC-lOSdsJGBEvAl","slug":"api-usenami-io-f737716e","name":"Nami Perp Oracle Family Classifier","description":"Oracle price-source family classification across tracked crypto perp venues — which venues derive their index price from the same upstream feed. Basis-risk awareness for cross-venue and funding-arb strategies: two venues sharing an oracle family will not diverge independently, so a spread between them is not the hedge it looks like.","url":"https://api.usenami.io/v1/perp/oracle-families","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"}},"response":{"families":[{"family":"cex_aggregated","method":"Weighted median of top CEX spot prices (Binance, OKX, Bybit, Kraken, etc.)","venues":["binance","bybit","okx","kraken","bitget","gateio","mexc","htx","kucoin","bingx","phemex","asterdex","grvt","apex_omni","hyperliquid"]},{"family":"pyth_stork","method":"Decentralized oracle networks (Pyth + Stork)","venues":["paradex","lighter","edgex"]},{"family":"slinky_validator","method":"Slinky single-CEX validator consensus per market","venues":["dydx"]},{"family":"hip3_pyth_equities","method":"Pyth oracle via institutional LPs (equities + indices)","venues":["hyperliquid_xyz","hyperliquid_km"]},{"family":"hip3_pyth_tradfi","method":"Pyth for commodities/equities (mixed TradFi)","venues":["hyperliquid_cash","hyperliquid_flx"]},{"family":"hip3_pyth_preipo","method":"Pyth oracle for pre-IPO synthetic perps","venues":["hyperliquid_vntl"]},{"family":"hip3_crypto","method":"Mixed CEX + Pyth oracle (crypto-focused HIP-3)","venues":["hyperliquid_hyna"]},{"family":"api_annualized","method":"Internal API computation (annualized funding rates)","venues":["variational"]}],"total_venues":26}},"exampleRequest":{"input":{"type":"perpetual_futures","method":"GET"}},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OmA1GowwGhZK7vMIHQriz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns oracle price-source family classification for 30+ perpetual futures venues, enabling basis-risk awareness for cross-venue strategies","exampleAgentPrompt":"Can you pull the oracle price-source family classification for all perp venues on Nami so I can see which exchanges share the same oracle and understand my basis risk before running a cross-venue funding arb strategy?","exampleUseCases":null,"resultDescription":"A structured mapping of 30+ perpetual futures venues to their oracle price-source families, indicating which venues share the same underlying price feed — enabling traders to identify correlated basis risk and group venues by oracle type for cross-venue strategy construction.","failureModes":["Missing or invalid 'type' or 'method' fields in input returns a 400 validation error","Payment not provided or insufficient results in 402 Payment Required","Service temporarily unavailable returns 503","Stale oracle classification data if venue oracle sources change without cache refresh","Unknown venue or oracle type not yet indexed returns incomplete results"],"whenToPreferThis":"Use this endpoint when building cross-venue perpetual futures strategies where oracle-driven basis risk matters — specifically when you need to know whether two or more venues reference the same price source family and might converge or diverge together. Prefer this over generic venue-info endpoints when oracle dependency analysis is the primary concern.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:18.790Z","isFirstParty":false}