{"uid":"cap_adl8asde_tSCriaRltl-w","slug":"darkly-energized-batch-series-fetch-45959c14","name":"Darkly Energized Batch Series Fetch","description":"Fetch multiple computed series in one call (the sum of each series price)","url":"https://darklyenergized.com/api/v1/x402/series/batch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","format":"date","description":"End date (YYYY-MM-DD)"},"ids":{"type":"array","items":{"enum":["cbdet","cbdeo","wresbal_plus","fed_drains","cb_usd_walcl","cb_usd_jpnassets","cb_usd_ecbassetsw","cb_usd_cncbbs","cb_usd_gbcbbs","cb_usd_chcbbs","cb_usd_cacbbs","cb_usd_krcbbs"],"type":"string"},"maxItems":20,"minItems":1,"description":"Up to 20 series ids; the price is the sum of each distinct series"},"from":{"type":"string","format":"date","description":"Start date (YYYY-MM-DD)"},"summary":{"type":"boolean","default":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.8","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.8/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.8","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.8","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PvdX3gy5c9Gbxe6d-hDBO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.8","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetch multiple central-bank liquidity and dark-energy computed series in a single paid call, returning time-series data for up to 20 series IDs over a specified date range","exampleAgentPrompt":"Can you pull the Fed total assets, ECB total assets, and central bank dark energy oscillator series all at once from January 1 2023 to December 31 2023 using the darklyenergized batch endpoint?","exampleUseCases":[{"title":"Global liquidity dashboard data pull","prompt":"Fetch the Fed, ECB, Bank of Japan, and PBoC total asset series together from 2020-01-01 to 2024-01-01 so I can build a chart of global central bank balance sheet expansion."},{"title":"Dark energy oscillator with CB assets","prompt":"Get me cbdet, cbdeo, and wresbal_plus from 2022-06-01 to 2023-06-01 — I want to compare the dark energy signal against the Fed's reserve balance."},{"title":"Macro research snapshot with summary","prompt":"Pull a summary of the Bank of Canada, Swiss National Bank, and Bank of England total asset series from 2021-01-01 to 2023-12-31 — just the summary stats, not every data point."}],"resultDescription":"Returns time-series data for each requested series ID over the specified date range. Each series includes computed values (e.g. USD-converted central bank total assets, reserve balances, dark energy oscillator readings). If summary=true, returns aggregate statistics rather than full bar-by-bar data. The price charged equals $0.05–$0.10 per distinct series ID included.","failureModes":["Invalid or unsupported series ID returns 400 with list of valid enum values","Date range with no available data returns empty series arrays","Requesting more than 20 series IDs triggers validation error","Malformed date format (not YYYY-MM-DD) returns 400 bad request","Payment failure via x402 protocol returns 402 Payment Required","from date after to date returns invalid date range error"],"whenToPreferThis":"Use this endpoint when you need data from two or more of the available central bank or macro liquidity series simultaneously and want to minimize API calls and payment overhead. It is more cost-effective than calling individual series endpoints separately when fetching 3+ series. Prefer individual series endpoints ($0.05 each) only when you need exactly one or two series. Use this batch endpoint for dashboard builds, multi-CB comparisons, or any workflow that joins global liquidity data across regions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:32:53.757Z","isFirstParty":false,"canonicalSlug":"darkly-energized-batch-series-fetch-45959c14"}