Economic calendar API

A real-time economic calendar, pushed to your app

Every release with its actual, forecast and previous value, pushed over WebSocket within about two seconds of publication. Economic, crypto, metals and energy calendars, with history and event details.

  • 4 calendars
  • WebSocket within ~2 s
  • History included

4

calendars

2

seconds to your app

2

languages of event names

What you get

  • Pushed, not polled

    A WebSocket sends a snapshot when you connect, then one frame per change: a new actual, a revised forecast, a notice.

  • Actual, forecast, previous

    Every event carries its impact, currency, country and time, and its values the moment they are out, revisions included.

  • History and details

    Each event's release history and its specification (what it measures, how often it is released) come from the single-event endpoint.

  • Four calendars

    Economic, crypto, metals and energy, each queried on its own or together.

  • Filters that matter

    A date range, an impact level and a row limit on every list.

  • Names in your language

    Event names in English, plus Persian where a translation exists, with the English name always included.

Endpoints

Every request takes your key in the X-API-Key header (or Authorization: Bearer, or ?key=). Responses are JSON.

  • GET /calendar/{source}/events

    A calendar's events with from, to, impact and limit filters.

  • GET /calendar/{source}/events/{eventId}

    One event with its details and release history.

  • GET /calendar/events

    This week across every calendar at once.

  • GET /calendar/sources

    Each calendar's event count and date coverage.

  • WS /ws/calendar

    A snapshot on connect, then one frame per change.

WebSocket:wss://api3.broker-radar.com/ws/calendar

Each feed's full guide is open at /help on its own address, and its OpenAPI file downloads from your account page. Read the feed's guide

A first call · curl
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api3.broker-radar.com/calendar/economic/events?impact=high&limit=1"
JSON
{
  "success": true,
  "source": "economic",
  "total": 1,
  "events": [
    {
      "static": {
        "eventId": 147783,
        "dateline": 1777955400,
        "name": "Cash Rate",
        "currency": "AUD",
        "countryCode": "AU",
        "impact": "high"
      },
      "live": {
        "actual": "3.60%",
        "forecast": "3.60%",
        "previous": "3.85%",
        "revision": "",
        "hasNotice": false
      }
    }
  ]
}
WebSocket · JavaScript
const ws = new WebSocket(
  "wss://api3.broker-radar.com/ws/calendar?source=economic&key=YOUR_API_KEY"
);
ws.onmessage = (event) => {
  const frame = JSON.parse(event.data);
  // { kind: "snapshot", events: [...] } first, then { kind: "change", ... }
};

Replace YOUR_API_KEY with a key from your account page.

Prices

Monthly or yearly, paid in USDT. Yearly is ten months' price for a full year. One key covers every feed you buy.

Monthly · Full feed

US$100 a month

Yearly · Full feed

US$1,000 a year

Built for

  • Trading platforms and apps

    Show the calendar and alert users the second a release is out.

  • Bots and EAs

    Pause or act on high-impact releases without polling.

  • Financial news sites

    Fill your calendar page with live values.

  • Analysts

    Pull release histories to study surprises.

One key, every feed you buy

There is no key per feed: one key works over REST and WebSocket on everything your account holds, and you can limit any key to some feeds, IP addresses or websites.

  • Forex spreads

    Bid, ask and spread at 176 retail forex brokers, live while the market is open: EUR/USD, GBP/USD, USD/JPY, gold, US30 and more. Ask for one broker, or every broker in a single call.

  • Prop firm spreads

    What traders actually pay at 37 prop firms: live spreads on their trading servers while the market is open, and typical spreads where a live feed isn't available. One firm, or every firm in one call.

  • Iran rates (toman)

    The dollar, euro and 38 currencies against the toman, plus gold and coins, as low/high ranges pooled from several market sources.

  • Crypto prices

    Bid, ask and last price for 25,256 markets at 42 crypto exchanges, refreshed about every 20 seconds. Ask for one coin across every exchange, cheapest ask first, or the whole board in one call.

Questions

A feed of scheduled economic releases with their actual, forecast and previous values, over REST and a WebSocket that pushes each change as it happens.

Live values reach the WebSocket within about two seconds of publication. Between releases the stream is quiet: silence is not an outage.

4 calendars: economic, crypto, metals and energy. Query one with /calendar/{source}/events, or this week across all of them with /calendar/events.

Yes. The per-calendar endpoints serve past events with their values, and each event's detail includes its release history.

Yes: ?from= and ?to= take dates, ?impact= takes holiday, low, medium or high, and ?limit= caps the list (up to 5,000).

Open wss://api3.broker-radar.com/ws/calendar with your key as ?key=. You get a snapshot first, then a frame for every change. If the stream drops three times in 30 seconds, fall back to REST until it recovers.

Event names come in English and, where a translation exists, in Persian with ?lang=fa; the English name is always included.

Its time, name, currency, country, impact, and live fields: actual, forecast, previous, revision and whether a notice is attached.

Webhooks for customers are on the way. Until then, the WebSocket delivers every release the moment it is out.

In USDT, monthly or yearly, on your account's API page; the prices are on this page.
Contact

Data API

Releases in your app the second they're out

Make a free account, buy the calendar, and connect the WebSocket with your key.