{"uid":"cap_iKBAtq7IqOjH62OD0B1iC","slug":"bykaranteli-solana-perps-hourly-history-5a8b6b38","name":"ByKaranteli Solana Perps Hourly History","description":"Hourly history of every Solana perp venue on the board but Jupiter (jupiter-history): Pacifica, Phoenix, GM Trade, Velocity and Bullet, per market and metric: one-sided open interest in USD (both sides on pool venues), 24h volume, hourly funding in percent of position size (empty where the venue publishes only an accumulator), mark, and Phoenix's raw funding accumulator; recorded from 2026-09-25. The free API returns the live board and seven days of one market.","url":"https://bykaranteli.com/api/x402/solana-perps-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":{"to":{"type":"string","description":"iso, optional, default now"},"from":{"type":"string","description":"iso, optional, default 30 days ago"},"limit":{"type":"number","description":"number, default 1000, max 20000"},"venue":{"type":"string","description":"string, optional: pacifica | phoenix | gmtrade | velocity | bullet"},"metric":{"type":"string","description":"string, optional: oi_usd | oi_long_usd | oi_short_usd | volume_24h_usd | funding_hourly_pct | mark_usd | funding_accumulator_raw"},"symbol":{"type":"string","description":"string, optional market as the venue names it, e.g. SOL, SOL-PERP, SOL-USD, USDCAD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pGZTPivklx49uTsrkcUh3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns hourly time-series history of open interest, volume, funding rates, and mark prices across Solana perpetual trading venues (Pacifica, Phoenix, GM Trade, Velocity, Bullet) per market and metric.","exampleAgentPrompt":"Pull the hourly funding rate history for SOL on Pacifica and Phoenix from the past 7 days so I can compare how their rates have diverged.","exampleUseCases":[{"title":"Funding rate divergence analysis","prompt":"Give me the last 14 days of hourly funding rates for SOL-PERP across all Solana perp venues — Pacifica, Phoenix, GM Trade, Velocity, and Bullet — so I can see which venue is consistently cheapest for longs."},{"title":"Open interest trend monitoring","prompt":"Fetch hourly open interest in USD for BTC across all Solana perp venues from 2025-06-01 to 2025-06-30, up to 20000 rows, so I can chart how OI moved during that month."},{"title":"Mark price history for a specific market","prompt":"Get me the hourly mark price history for USDCAD on Phoenix for the past 30 days — I want to see how the synthetic FX perp has been tracking the spot rate."}],"resultDescription":"A JSON array of time-series records, each containing timestamp, venue, symbol, and the requested metric value (e.g. oi_usd, funding_hourly_pct, volume_24h_usd, mark_usd, or funding_accumulator_raw). Records are hourly granularity. Up to 20,000 rows per call. The free tier returns only live board data and 7 days of history for one market; paid calls unlock full history from 2024-09-25.","failureModes":["Invalid venue name returns empty results or error","Invalid metric string returns error or empty set","Date range outside available history (before 2024-09-25) returns no data","Exceeding limit of 20000 returns a validation error","Symbol not recognized by the specified venue returns empty results","Missing payment header results in 402 Payment Required for historical data beyond 7 days"],"whenToPreferThis":"Choose this endpoint when you need hourly granularity Solana-specific perp data across Pacifica, Phoenix, GM Trade, Velocity, or Bullet — especially for funding rates, open interest, volume, or mark prices. Prefer this over generic multi-exchange APIs when your analysis is focused on Solana-native perp venues and you need historical depth beyond what free tiers provide. Not suitable for Jupiter perp data or non-Solana venues.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:32:23.655Z","isFirstParty":false,"canonicalSlug":"bykaranteli-solana-perps-hourly-history-5a8b6b38"}