{"uid":"cap_m80gsPXoceCMhFBZW-Qek","slug":"api-quantoracle-dev-61e53b25","name":"QuantOracle Crypto Funding Rate","description":"QuantOracle: crypto/funding-rate","url":"https://api.quantoracle.dev/v1/crypto/funding-rate","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"funding_rates":{"type":"array","items":{"type":"object","title":"FundingEntry","required":["rate"],"properties":{"rate":{"type":"number","title":"Rate","description":"Funding rate for the period (e.g. 0.0001 = 0.01%)"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","description":"Optional ISO timestamp"}}},"title":"Funding Rates","minItems":3,"description":"Array of funding rate entries"},"position_size":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Position Size","description":"Optional position size for P&L calculation"},"payment_interval_hours":{"type":"integer","title":"Payment Interval Hours","default":8,"description":"Hours between funding payments"}}},"responseSchema":null,"example":{"request":{"input":{"body":{"funding_rates":[{"rate":0.0001,"timestamp":"2024-01-15T08:00:00Z"},{"rate":0.00015,"timestamp":"2024-01-15T16:00:00Z"},{"rate":0.00012,"timestamp":"2024-01-16T00:00:00Z"}],"position_size":50000,"payment_interval_hours":8},"type":"http","method":"POST","bodyType":"json"}},"response":{"n":3,"ms":9.71,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"regime":"CONTANGO","std_rate":0.000025,"carry_pnl":18.5,"mean_rate":0.000123,"median_rate":0.00012,"positive_pct":100,"annualized_rate":0.1351,"cumulative_return":0.00037,"max_streak_negative":0,"max_streak_positive":3}},"exampleRequest":{"funding_rates":[{"rate":0.0001,"timestamp":"2024-01-15T08:00:00Z"},{"rate":0.00015,"timestamp":"2024-01-15T16:00:00Z"},{"rate":0.00012,"timestamp":"2024-01-16T00:00:00Z"}],"position_size":50000,"payment_interval_hours":8},"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_oE7cacaOvkJ5omc9cZWna","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":"Computes or retrieves the funding rate for a specified cryptocurrency perpetual futures contract","exampleAgentPrompt":"What's the current funding rate for BTC-USDT perpetual futures, and can you annualize it so I can see whether it's cheap or expensive to hold a long position right now?","exampleUseCases":null,"resultDescription":"Returns the funding rate for the specified crypto perpetual contract, likely including the current rate value, annualized equivalent, rate direction (positive/negative indicating long vs short pays), and potentially historical funding rate data or the estimated periodic payment amount.","failureModes":["Unknown or unsupported trading pair returns a 404 or validation error","Unsupported exchange identifier results in an error response","Invalid time range or interval parameter causes a 400 bad request","Rate limit exceeded returns a 429 with retry guidance","Missing required symbol field triggers a validation error","Data unavailable for a specific exchange or contract returns partial or null results"],"whenToPreferThis":"Use this endpoint when you need to quantify the cost of carry for a cryptocurrency perpetual futures position, assess funding rate arbitrage opportunities, or compare funding rates across instruments. Prefer this over generic crypto price feeds when the specific concern is perpetual futures mechanics, funding costs, or basis analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:43:09.792Z","isFirstParty":false}