Calendar API

Upcoming macro and crypto events with a positive or negative read.

What you get

One endpoint for the events that move the market: rate decisions, token unlocks, and other macro and crypto dates, each with its scheduled time. No path parameter. Authenticate with your X-API-Key against https://api.xaxios.com.

Endpoint

GET/terminal/calendar

Upcoming macro and crypto events with their scheduled times. No path parameter.data is an array covering the current week. Premium keys also get a positive or negative read per event.

json
{
  "success": true,
  "data": [
    {
      "unix": 1720620000,
      "countryName": "United States",
      "countryCode": "US",
      "title": "Fed Interest Rate Decision",
      "category": "interest rate",
      "actual": null,
      "previous": 5.5,
      "analyst_forecast": 5.5,
      "institutional_forecast": 5.5,
      "isPositive": null,
      "key": "Fed Interest Rate Decision_interest rate_Jul/2026_United States",
      "notified": false,
      "createdAt": 1720531800
    }
  ]
}
FieldTypeDescription
unixnumberWhen the event is scheduled, as a unix timestamp in seconds.
countryNamestringThe country the event belongs to.
countryCodestringThe ISO country code.
titlestringThe event name, localized to your Accept-Language.
categorystringThe event type, e.g. "interest rate".
actualnumber | nullThe reported figure once released, otherwise null.
previousnumber | nullThe prior period reading, if any.
analyst_forecastnumber | nullThe consensus (analyst) forecast, if any.
institutional_forecastnumber | nullThe institutional forecast, if any.
isPositiveboolean | nullPositive or negative read on the outcome. Present only for a Premium key; null until there is a read.
keystringA stable unique identifier for the event.
notifiedbooleanInternal flag for whether alarms have already fired for this event.
createdAtnumberWhen xAxios AI first recorded the event, as a unix timestamp in seconds.

Try it live

Paste your xax_ key and pull the upcoming events. This endpoint needs no token address.

Request
curl -s "https://api.xaxios.com/terminal/calendar" \ -H "X-API-Key: YOUR_API_KEY"
Response

Choose an endpoint, paste your key, and send a request to see the live JSON response.