{"uid":"cap__9YdLfJJawqLwU47ReukS","slug":"bykaranteli-leverage-tiers-history-0e1c41fd","name":"ByKaranteli Leverage Tiers History","description":"Every recorded version of each perpetual's leverage ladder on every venue whose ladders we read: tier, notional floor and cap, maximum leverage and maintenance margin, with valid_from and valid_to so leverage cuts can be dated. The free endpoint serves only the current ladder.","url":"https://bykaranteli.com/api/x402/leverage-tiers-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"},"from":{"type":"string","description":"iso, optional, valid_from lower bound"},"limit":{"type":"number","description":"number, optional, max 20000"},"symbol":{"type":"string","description":"string, optional base asset, e.g. BTC"},"exchange":{"type":"string","description":"string, optional venue id: bybit | okx | gate | htx | bitget | mexc ..."}}}},"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_cwAv5Fhv98TOnxE-D90vL","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 the full historical record of perpetual futures leverage tier ladders across major crypto exchanges, including tier boundaries, notional caps, max leverage, and maintenance margin with time-range validity.","exampleAgentPrompt":"Pull the full leverage tier history for BTC perpetuals on Bybit and OKX from January 2024 to now — I want to see every tier's notional floor, notional cap, max leverage, and maintenance margin, and when each version was valid.","exampleUseCases":[{"title":"Audit leverage cuts after market crash","prompt":"Can you pull the leverage tier history for ETH on OKX and Bybit from October 2023 through December 2023? I want to see if and when they reduced max leverage or changed notional caps during that period."},{"title":"Backtest margin model with historical tiers","prompt":"I need the complete leverage ladder history for BTC on Bybit — all tiers with their notional floor, cap, max leverage, and maintenance margin rates — going back to January 2022, up to a limit of 10000 rows, so I can backtest my margin calculations."},{"title":"Compare venue leverage policies for a symbol","prompt":"Give me the current and historical leverage tier ladders for SOL across Gate, MEXC, and Bitget — I want to see how each venue's notional brackets and max leverage compare and when they last changed."}],"resultDescription":"A list of leverage tier records, each containing the exchange venue, asset symbol, tier number, notional floor and cap, maximum leverage allowed, maintenance margin rate, valid_from datetime, and valid_to datetime (null if currently active). Filterable by asset, exchange, and date range.","failureModes":["Invalid or unsupported exchange venue ID returns empty results or error","Symbol not found on specified exchange returns no records","Date range with no historical changes returns empty array","Limit exceeded (max 20000) may be rejected or truncated","Malformed ISO date strings in from/to parameters cause validation errors","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need point-in-time or historical leverage tier data for perpetual futures — especially to audit when exchanges changed their leverage ladders, reconstruct margin requirements for backtesting, or compare tier structures across venues over time. The free endpoint only returns the current ladder; this paid endpoint is required for any historical analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:30:04.142Z","isFirstParty":false,"canonicalSlug":"bykaranteli-leverage-tiers-history-0e1c41fd"}