{"uid":"cap_ce8_t3e1NrvpdHVWTsTow","slug":"hyperliquid-perpetuals-ticker-history-4e7f74e3","name":"Hyperliquid Perpetuals Ticker History","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/api/v1/perpetuals/ticker-history?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"},"queryParams":{"type":"object","properties":{"coin":{"enum":["BTC","ETH","SOL"],"type":"string","examples":["BTC","ETH","SOL"],"description":"Perp coin (default BTC)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"coins":{"BTC":{"mark_px":80860,"oracle_px":80870,"open_interest":30000,"funding_hourly":0.0000125,"funding_apr_pct":10.95,"open_interest_usd":2426000000}},"venue":"hyperliquid","sources":["https://api.hyperliquid.xyz/info"],"updated_at":"2026-10-28T11:00:00Z"}},"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_19EMWqPHNPt6uGjbKZa2X","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 mark price, oracle price, open interest, hourly funding rate, and annualized funding APR for BTC, ETH, or SOL perpetuals on Hyperliquid, paid per-call via x402 USDC micropayment.","exampleAgentPrompt":"What's the current mark price, oracle price, open interest, and annualized funding rate for BTC perpetuals on Hyperliquid?","exampleUseCases":[{"title":"Funding rate arbitrage signal","prompt":"Check the current hourly funding rate and annualized funding APR for ETH perpetuals on Hyperliquid — I want to know if it's worth going short to collect funding right now."},{"title":"Open interest spike detection","prompt":"Pull the current open interest in USD for BTC perps on Hyperliquid — I'm watching for unusual OI spikes that might signal a big move."},{"title":"Mark vs oracle price divergence monitor","prompt":"Get me the mark price and oracle price for SOL perpetuals on Hyperliquid so I can see how far apart they are and whether liquidations might be near."}],"resultDescription":"A JSON object containing for the requested coin: mark_px (mark price), oracle_px (oracle price), open_interest (in coin units), funding_hourly (hourly funding rate as decimal), funding_apr_pct (annualized funding rate as percentage), and open_interest_usd (open interest in USD). Also includes the venue name ('hyperliquid'), data sources array, and an updated_at ISO timestamp.","failureModes":["Unsupported coin symbol returns error (only BTC, ETH, SOL are valid enum values)","x402 payment failure if USDC balance on Base is insufficient or payment is rejected","Hyperliquid API upstream outage may cause stale or missing data","Rate limiting or worker timeout on the Cloudflare Workers backend","Missing coin query param defaults to BTC — agent may silently get BTC data when another coin was intended"],"whenToPreferThis":"Choose this endpoint when an AI trading agent needs real-time Hyperliquid perpetuals data — specifically mark/oracle price divergence, funding rates, and open interest — without managing API keys. The x402 micropayment model makes it ideal for autonomous agents that pay per call in USDC on Base. Prefer this over general market data APIs when Hyperliquid-specific funding and OI data is required for derivatives strategy decisions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:18.808Z","isFirstParty":false,"canonicalSlug":"hyperliquid-perpetuals-ticker-history-4e7f74e3"}