{"uid":"cap_cLaDK4Xu9KgXqIrmt9eGP","slug":"cryptofeed402-single-asset-perp-spot-snapshot-00c55be2","name":"cryptofeed402 Single-Asset Perp & Spot Snapshot","description":"Live snapshot for one major coin (BTC, ETH, SOL, HYPE, NEAR, AAVE): Hyperliquid perp mark price, hourly funding rate and annualized funding APR, open interest in coins and USD, 24h volume and premium, plus OKX spot last price and 24h change. Use it when a trading agent needs current price and perp positioning for a single asset before sizing or timing a trade. JSON. $0.0025 USDC per call on Base.","url":"https://cryptofeed402.site/price/:symbol?utm_source=zero.xyz","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","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["symbol"],"properties":{"symbol":{"enum":["BTC","ETH","SOL","HYPE","NEAR","AAVE"],"type":"string","description":"Coin ticker (case-insensitive)"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["symbol","as_of","perp"],"properties":{"perp":{"type":"object","properties":{"venue":{"type":"string"},"mark_px":{"type":"number"},"premium":{"type":"number"},"funding_hourly":{"type":"number"},"volume_24h_usd":{"type":"number"},"funding_apr_pct":{"type":"number"},"open_interest_usd":{"type":"number"},"open_interest_coins":{"type":"number"}}},"spot":{"type":["object","null"],"properties":{"last":{"type":"number"},"venue":{"type":"string"},"open_24h":{"type":"number"},"change_24h_pct":{"type":"number"}}},"as_of":{"type":"string","description":"ISO 8601 UTC timestamp"},"symbol":{"type":"string"},"disclaimer":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qSFlnwBLNpT78RdqB0vJG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live snapshot of Hyperliquid perpetual market data (mark price, funding rate, open interest, volume) plus OKX spot price for one of six supported crypto assets.","exampleAgentPrompt":"What's the current Hyperliquid mark price, funding rate, and open interest for ETH right now, plus the OKX spot price?","exampleUseCases":[{"title":"Pre-trade sizing check for BTC","prompt":"Before I open a BTC perp position, can you pull the current Hyperliquid mark price, funding APR, and open interest so I can decide how big to go?"},{"title":"Funding rate arbitrage scan for SOL","prompt":"What's the annualized funding rate on SOL perps on Hyperliquid right now, and how does the mark price compare to the OKX spot price? I'm looking for a funding arb opportunity."},{"title":"Real-time AAVE perp market check","prompt":"Give me a live snapshot of AAVE on Hyperliquid — mark price, hourly funding, 24h volume, and open interest in USD — I want to time my entry."}],"resultDescription":"A JSON object containing: the requested symbol, an ISO 8601 UTC timestamp, a 'perp' object with Hyperliquid mark price, hourly funding rate, annualized funding APR percentage, 24h volume in USD, open interest in both coins and USD, and perp premium; plus a 'spot' object (or null) with OKX last price, 24h open price, and 24h percentage change; and a disclaimer string.","failureModes":["Unsupported symbol: only BTC, ETH, SOL, HYPE, NEAR, AAVE are accepted; other tickers return an error","Hyperliquid or OKX upstream outage may result in stale or missing data","Spot object may be null if OKX data is unavailable for the requested asset","Payment failure: x402 micropayment not processed, returning 402 status","Network timeout if upstream exchanges are slow to respond"],"whenToPreferThis":"Use this endpoint when a trading agent needs a real-time, consolidated perp + spot snapshot for one of the six supported assets (BTC, ETH, SOL, HYPE, NEAR, AAVE) specifically from Hyperliquid perp and OKX spot markets. Prefer it over generic price APIs when Hyperliquid funding rate, open interest, and perp-vs-spot premium are required for trade sizing or timing decisions. Not suitable for assets outside the supported six, for historical data, or for exchange-agnostic best-price routing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T18:35:47.132Z","isFirstParty":false,"canonicalSlug":"cryptofeed402-single-asset-perp-spot-snapshot-00c55be2"}