{"uid":"cap_K2DX2D0tB4BOzaFoE7QJO","slug":"basebuilder2-stocks-forex-time-series-968b0e91","name":"Basebuilder2 Stocks – Forex Time Series","description":"BaseBuilder Stocks API hub - 21 paid endpoints","url":"https://bbx-stocks.vercel.app/api/forex/time-series","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.113143","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.113143/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.113143","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.113143","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P7Z0v731bLzzXzL3Dhold","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.113143","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical time-series exchange rate data for a currency pair over a specified date range","exampleAgentPrompt":"Can you pull the daily EUR/USD exchange rate time series for the past 3 months so I can analyze the trend?","exampleUseCases":[{"title":"Backtesting a currency trading strategy","prompt":"Get me daily OHLC forex data for GBP/USD from January 1 to March 31 this year — I need it for backtesting a momentum trading strategy."},{"title":"Financial report with FX rates","prompt":"Pull the historical EUR to JPY exchange rates on a weekly interval for all of last year so I can include FX movement charts in our annual financial report."},{"title":"Monitoring emerging market currency trends","prompt":"Fetch me the USD to MXN daily time-series data for the last 6 months — I want to see how the peso has moved against the dollar."}],"resultDescription":"Returns a structured time-series array of exchange rate data points for the requested currency pair and date range, typically including timestamps and rate values (open, high, low, close) at the specified interval.","failureModes":["Invalid or unsupported currency pair returns an error","Date range too large or out of supported historical bounds","Malformed date format in request body","Missing required fields such as currency symbols or date range","Payment not processed or insufficient USDC balance (402 error)","Rate-limit or quota exceeded on paid tier"],"whenToPreferThis":"Choose this endpoint when you need structured historical forex exchange rate time-series data for analysis, backtesting, charting, or financial modeling. It is a paid, on-demand endpoint suited for agents that require reliable FX history without managing their own data pipeline. Prefer it over general financial APIs when operating in a crypto-payment (x402/USDC) context or when integrating with other Basebuilder Stocks endpoints on the same hub.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:06.785Z","isFirstParty":false}