{"uid":"cap_HAIjhELh9a63Tm3SmmEUl","slug":"usenami-perp-snapshot-86f9405f","name":"Usenami Perp Snapshot","description":"One-call market snapshot for one crypto perpetual across every tracked venue — funding rate, annualized carry with contango/backwardation structure, open interest, 24h volume and mark price in a single response. Bundles funding/carry/open-interest/volume-24h so an agent makes one paid call instead of four.","url":"https://api.usenami.io/v1/perp/snapshot","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":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oB3TU8Dwnfrty9KXf4-L8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a one-call bundled market snapshot for a single perpetual futures venue/ticker, including funding rate, annualized carry, structure, open interest, 24h volume, and mark price.","exampleAgentPrompt":"Give me a full market snapshot for the BTC-PERP on Binance — I need the current funding rate, annualized carry, open interest, 24h volume, and mark price all in one shot.","exampleUseCases":[{"title":"Pre-trade perp market check","prompt":"Before I open a long on ETH-PERP on Bybit, can you pull the current funding rate, annualized carry, open interest, and mark price so I know what I'm walking into?"},{"title":"Carry farming opportunity scan","prompt":"What's the annualized carry and current funding structure on SOL-PERP at dYdX right now? I'm looking for high positive carry opportunities."},{"title":"Portfolio monitoring snapshot","prompt":"Pull me a quick perp snapshot for BTC-PERP on OKX — funding, mark price, 24h volume, and open interest — I want to check on my position's environment."}],"resultDescription":"A bundled JSON object containing the current funding rate, annualized carry and carry structure, open interest, 24-hour trading volume, and mark price for the specified perpetual futures ticker and venue — all returned in a single API response.","failureModes":["Unsupported ticker or venue returns an error or empty result","Stale data if the venue feed has a temporary gap","Malformed input schema (missing type or method fields) returns a 400-level error","Rate limiting or payment failure (x402) if USDC payment is not processed correctly","Venue temporarily offline or data unavailable returns partial or null fields"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, single-call snapshot of all key perpetual futures market metrics (funding, carry, OI, volume, mark price) for a specific venue/ticker pair, rather than making multiple separate API calls. It is ideal for pre-trade checks, carry farming scans, or real-time position monitoring where latency and call efficiency matter. Prefer it over individual metric endpoints when you need all metrics simultaneously.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:35:13.330Z","isFirstParty":false}