Catalog / Forex Factory Calendar

Forex Factory Calendar API

forexfactory.com

Live read-only access to Forex Factory's economic calendar. The API fetches a requested calendar day over HTTP and returns every event embedded in the source response, including reported and forecast values; the serving path does not use a browser or local probe artifacts.

  • finance
  • forex
  • economic-calendar
  • macro data
1 endpointDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Forex Factory Calendar API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Fetches the requested date live from Forex Factory over HTTP. The response contains all source events for that date; empty event arrays are valid when Forex Factory publishes no events.

Calendar date to fetch, in ISO format YYYY-MM-DD.

View call pricing
cURL · Calendar events
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/c342ec29-899d-49b5-9e36-ef1502080a9d/v1/calendar/events' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY" \
  --data-urlencode 'date=2026-10-09'

Endpoints

Inputs and response fields for every endpoint in this API.

GETCalendar events/v1/calendar/events

Fetches the requested date live from Forex Factory over HTTP. The response contains all source events for that date; empty event arrays are valid when Forex Factory publishes no events.

Input

dateRequiredQuery · string (date)

Calendar date to fetch, in ISO format YYYY-MM-DD.

Example: 2026-10-09

Response

dataobject
data.datestring (date)
data.eventsobject[]
data.events[].idinteger
data.events[].urlstring | null
data.events[].datestring
data.events[].namestring
data.events[].actualstring
data.events[].base_idinteger | null
data.events[].countrystring
data.events[].site_idinteger | null
data.events[].currencystring
data.events[].datelineinteger | null
data.events[].forecaststring
data.events[].previousstring
data.events[].revisionstring
data.events[].solo_urlstring | null
data.events[].has_graphboolean
data.events[].time_labelstring
data.events[].impact_namestring
data.events[].time_maskedboolean
data.events[].prefixed_namestring
data.events[].has_data_valuesboolean
data.events[].actual_better_worseinteger
data.events[].revision_better_worseinteger
data.fetched_atstring (date-time)
data.source_urlstring
request_idstring

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.