{"uid":"cap_erlpg0J00WtXoFTBzR43y","slug":"api-quantoracle-dev-05e23a58","name":"QuantOracle FX Interest Rate Parity","description":"QuantOracle: fx/interest-rate-parity","url":"https://api.quantoracle.dev/v1/fx/interest-rate-parity","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"spot_rate":{"type":"number","title":"Spot Rate","description":"Current spot exchange rate"},"time_years":{"type":"number","title":"Time Years","default":1,"description":"Time horizon in years"},"parity_type":{"enum":["covered","uncovered"],"type":"string","title":"Parity Type","default":"covered","description":"Parity type: covered or uncovered"},"foreign_rate":{"type":"number","title":"Foreign Rate","description":"Foreign interest rate (annualized)"},"domestic_rate":{"type":"number","title":"Domestic Rate","description":"Domestic interest rate (annualized)"},"actual_forward":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Actual Forward","description":"Actual forward rate for arbitrage detection"}}},"responseSchema":null,"example":{"request":{"spot_rate":1.085,"time_years":1,"parity_type":"covered","foreign_rate":0.0375,"domestic_rate":0.0525,"actual_forward":1.07},"response":{"ms":7.87,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"mispriced":true,"parity_type":"covered","arbitrage_pct":2.8283,"carry_direction":"BORROW_FOREIGN","arbitrage_profit":0.0307,"forward_premium_pct":1.4458,"theoretical_forward":1.100687,"annualized_carry_yield":1.5}},"exampleRequest":{"spot_rate":1.085,"time_years":1,"parity_type":"covered","foreign_rate":0.0375,"domestic_rate":0.0525,"actual_forward":1.07},"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_eSQQnf11VhZqy7iGwBRMT","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":"Calculates covered or uncovered interest rate parity, detects FX mispricing, and identifies arbitrage opportunities between forward and theoretical forward rates.","exampleAgentPrompt":"Check covered interest rate parity for a EUR/USD spot rate of 1.085, domestic rate 5.25%, foreign rate 3.75%, over 1 year — the actual forward rate on offer is 1.07, and I want to know if it's mispriced and what the arbitrage profit would be.","exampleUseCases":null,"resultDescription":"Returns the theoretical forward rate, whether the market rate is mispriced, the arbitrage profit in absolute and percentage terms, the forward premium percentage, the recommended carry direction (e.g. BORROW_FOREIGN), and the annualized carry yield. Response time is typically under 10ms.","failureModes":["Missing required fields (spot_rate, domestic_rate, foreign_rate, time_years) returns a 400 error","Invalid parity_type value (not 'covered' or 'uncovered') causes a validation error","Negative or zero time_years may produce nonsensical results or an error","actual_forward is optional for uncovered parity but required for mispricing detection — omitting it may result in null arbitrage fields","Payment failure via x402 protocol returns a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need a fast, programmatic check of interest rate parity conditions for a specific currency pair — particularly when you have a concrete forward rate to benchmark against the theoretical value and want to detect arbitrage or carry trade opportunities. Prefer this over manual spreadsheet calculations or generic financial data APIs that don't perform the full covered/uncovered parity analysis with arbitrage profit quantification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:56:58.799Z","isFirstParty":false}