ETF & Macro Calendar

Use this endpoint when you need a structured calendar view of upcoming US macroeconomic events filtered by date range, especially when the use case involves crypto ETF flows or institutional fund timing. Prefer this over general financial news APIs when you need event scheduling data (not narrative news) and when you want events scoped to crypto-relevant macro catalysts.

• Missing required 'from' date parameter returns an error or empty result
• Invalid date format (non-ISO 8601) may cause a parse error or empty data array
• Date range with no events returns {success: true, data: []} — not an error but may mislead if misinterpreted
• Very wide date ranges may return large payloads or be throttled
• Payment failure (402) if USDC payment is not correctly submitted before the request