{"uid":"cap_gBpGEo27titkDY1D6ZoGs","slug":"x402stock-perpetuals-funding-rate-history-f27c5a2a","name":"x402stock Perpetuals Funding Rate History","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/perps/funding/%7Bcoin%7D","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["hours"],"properties":{"end":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"hours":{"type":"integer","default":24,"maximum":720,"exclusiveMinimum":0},"start":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source","as_of","venue","coin","count","history"],"properties":{"coin":{"type":"string"},"as_of":{"type":"string"},"count":{"type":"number"},"venue":{"type":"string"},"source":{"type":"string","const":"x402stock"},"history":{"type":"array","items":{"type":"object","required":["time","funding_rate_hourly","funding_apr_percent","premium"],"properties":{"time":{"anyOf":[{"type":"string"},{"type":"null"}]},"premium":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_apr_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_rate_hourly":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"coin":"BTC","as_of":"2026-06-04T00:00:00.000Z","count":1,"venue":"hyperliquid","source":"x402stock","history":[{"time":"2026-06-03T00:00:00.000Z","premium":-0.0003727867,"funding_apr_percent":10.95,"funding_rate_hourly":0.0000125}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_pOkgmCig6FRzZyOpjIklp","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":"Returns historical funding rates and premiums for a crypto perpetual contract (e.g. BTC, ETH) on Hyperliquid over a specified time window","exampleAgentPrompt":"Pull the last 72 hours of BTC perpetual funding rate history from x402stock — I want to see the hourly funding rate, APR, and premium for each data point.","exampleUseCases":[{"title":"Spot carry trade opportunities in crypto","prompt":"Check the funding rate history for ETH perps on Hyperliquid over the last 7 days — I want to know if the funding APR has been consistently positive and whether there's a viable carry trade opportunity right now."},{"title":"Monitor BTC funding regime shifts","prompt":"Pull the last 30 days of BTC perpetual funding data from Hyperliquid and flag any points where the funding rate flipped from positive to negative — I'm trying to spot regime changes and understand how long each lasted."},{"title":"Backtest SOL perp funding strategy","prompt":"Get me up to 720 hours of SOL perpetual funding rate history from Hyperliquid, including the hourly rate, annualized APR, and premium for each entry — I need this to backtest a funding-rate mean-reversion strategy."}],"resultDescription":"Returns a JSON object with the coin symbol, venue (e.g. Hyperliquid), as_of timestamp, count of records, and a history array where each entry contains: time (ISO timestamp), funding_rate_hourly (fractional rate), funding_apr_percent (annualized rate), and premium (basis). Covers up to 720 hours of history.","failureModes":["Missing required 'hours' query parameter returns a validation error","Invalid or unsupported coin symbol returns empty or error response","Hours value exceeding 720 (max) returns a validation/range error","Payment not provided or insufficient USDC causes 402 Payment Required response","Start/end timestamps that produce zero matching records return count=0 with empty history array"],"whenToPreferThis":"Use this endpoint when you need on-chain perpetual futures funding rate history for a specific cryptocurrency, particularly from Hyperliquid. Ideal for DeFi traders, quant analysts, or agents that need to assess carry trade opportunities, monitor funding regime changes, or backtest funding-rate strategies — without needing API keys, just pay $0.01 USDC per call via x402 on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:40.827Z","isFirstParty":false}