{"uid":"cap_McDGIx-aPhnfzWIRD2poj","slug":"annalist-hip-3-perpetuals-market-data-d1ffa0a1","name":"Annalist HIP-3 Perpetuals Market Data","description":"Signed data for AI agents, paid per call over x402. Hyperliquid crowd state, smart money and liquidations with what historically happened next, plus independent checks of x402 services and MCP servers.","url":"https://api.annalist.dev/v1/hip3/perp?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","required":["coin"],"properties":{"coin":{"type":"string","description":"exchange:asset, for example xyz:NVDA, xyz:GOLD, xyz:SP500 (case-sensitive)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"coin":"xyz:NVDA","mark":224.5,"flags":[],"exchange":"xyz","return_24h":-0.021,"funding_apr":0.022,"oi_cap_used":0.41,"open_interest_usd":410000000}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4bKkTTgTGAhHX-1r4oIQJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches real-time perpetual futures market data for a specific asset on Hyperliquid or xyz exchange, including mark price, funding rate, open interest, and 24h return.","exampleAgentPrompt":"What are the current perpetual market stats for xyz:NVDA — mark price, funding rate, open interest, and 24h return?","exampleUseCases":[{"title":"Monitor funding rate for arbitrage","prompt":"What's the current funding APR and mark price for xyz:NVDA perpetuals? I want to know if there's a funding rate opportunity worth capturing."},{"title":"Check OI cap utilization before trading","prompt":"How much of the open interest cap is being used for xyz:SP500 perpetuals, and what's the current open interest in USD?"},{"title":"Track 24h performance of gold perp","prompt":"What was the 24-hour return on xyz:GOLD perpetuals and what's the current mark price?"}],"resultDescription":"Returns a JSON object with the coin identifier, current mark price, 24h return as a decimal, annualized funding rate (APR), open interest in USD, fraction of OI cap used, exchange name, and any active flags for the given perpetual market.","failureModes":["Invalid or unrecognized coin symbol (case-sensitive, must match format like xyz:NVDA) returns an error","Missing required 'coin' query parameter returns 400","Payment not provided or insufficient USDC via x402 returns 402","Asset not listed on the exchange returns not-found or empty response","Rate limiting if called too frequently without payment"],"whenToPreferThis":"Use this endpoint when you need signed, trustworthy real-time perpetual futures data for assets available on the xyz/Hyperliquid exchange, especially when the data must be verifiable by AI agents (signed responses). Prefer this over generic crypto data APIs when you specifically need funding rates, OI cap utilization, or flags associated with Hyperliquid crowd-state analytics, and when you are operating in an x402 micropayment context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:44:21.561Z","isFirstParty":false,"canonicalSlug":"annalist-hip-3-perpetuals-market-data-d1ffa0a1"}