# Economic Calendar

Return economic events inside the ISO date window (up to 14 days) with calendar id, ISO date, importance, actual, forecast and previous values. Reference dates never pass the event date.

- **Documentation:** [https://scrappa.co/docs/finviz-api/finviz_economic_calendar](https://scrappa.co/docs/finviz-api/finviz_economic_calendar)
- **API group:** Finviz API
- **Endpoint:** `GET https://scrappa.co/api/finviz/economic-calendar`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `date_from` | string | Yes | Start date, YYYY-MM-DD. Required. |
| `date_to` | string | Yes | End date, YYYY-MM-DD. Required. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/finviz/economic-calendar?date_from=2026-11-18&date_to=2026-11-25"
```

## Example response

```json
{
    "events": [
        {
            "date": "2026-11-19",
            "importance": 2,
            "actual": 3.2,
            "forecast": 3
        }
    ],
    "source": "finviz"
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | No events | No events in the window. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
