{"uid":"cap_5jqnAyOdLHRWAmf4LGOQO","slug":"api-quantoracle-dev-1ba0cdce","name":"QuantOracle FX Forward Rate","description":"QuantOracle: fx/forward-rate","url":"https://api.quantoracle.dev/v1/fx/forward-rate","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"compounding":{"enum":["continuous","annual","semi"],"type":"string","title":"Compounding","default":"continuous","description":"Compounding convention"},"forward_end":{"type":"number","title":"Forward End","description":"Forward period end (years)"},"yield_curve":{"type":"array","items":{"type":"object","title":"YieldPoint","required":["tenor_years","spot_rate"],"properties":{"spot_rate":{"type":"number","title":"Spot Rate","description":"Spot rate at this tenor"},"tenor_years":{"type":"number","title":"Tenor Years","description":"Maturity in years"}}},"title":"Yield Curve","minItems":2,"description":"Array of yield curve points"},"forward_start":{"type":"number","title":"Forward Start","description":"Forward period start (years)"}}},"responseSchema":null,"example":{"request":{"input":{"body":{"compounding":"continuous","forward_end":2,"yield_curve":[{"spot_rate":0.04,"tenor_years":1},{"spot_rate":0.045,"tenor_years":2},{"spot_rate":0.05,"tenor_years":3}],"forward_start":1},"type":"http","method":"POST","bodyType":"json"}},"response":{"ms":8.03,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"compounding":"continuous","forward_rate":0.05,"spot_rate_end":0.045,"spot_rate_start":0.04,"forward_rate_pct":5,"full_forward_curve":[{"end":2,"start":1,"forward_rate":0.05},{"end":3,"start":2,"forward_rate":0.06}]}},"exampleRequest":{"compounding":"continuous","forward_end":2,"yield_curve":[{"spot_rate":0.04,"tenor_years":1},{"spot_rate":0.045,"tenor_years":2},{"spot_rate":0.05,"tenor_years":3}],"forward_start":1},"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_9vAGdl6mG_OJDqmiItnwC","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 the theoretical forward exchange rate between two currencies given spot rate, interest rate differentials, and a tenor/maturity period","exampleAgentPrompt":"Calculate the 6-month forward rate for EUR/USD given a spot rate of 1.0850, a US interest rate of 5.25%, and a eurozone interest rate of 3.75%.","exampleUseCases":null,"resultDescription":"Returns the computed forward exchange rate for the specified currency pair and tenor, along with forward points (the difference between forward and spot) and optionally the implied interest rate differential used in the calculation.","failureModes":["Invalid or unsupported currency pair returns 400 error","Negative or unrealistic interest rates may return a validation error","Missing required fields (spot rate, tenor, interest rates) return 422 unprocessable entity","Malformed tenor/date format returns parsing error","Payment not provided or insufficient USDC balance returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you need a precise, model-based FX forward rate computation grounded in covered interest parity, especially when building hedging strategies, pricing currency forwards, or verifying no-arbitrage conditions. Prefer this over spot-rate lookups when you need a future settlement date and want to account for interest rate differentials between two currencies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:51:53.123Z","isFirstParty":false}