Stay updated with the latest changes and improvements to our News API. This changelog documents all major updates, new features, and breaking changes.
📦 October 11, 2025 - JB-News v2.4.5 Update
New Update: JB-News v2.4.5: https://github.com/jblanked/JB-News
Added:
Projects
directory containing projects built in different languages that use this library
Updated:
README.md
to correct the Event ID property (fromeventID
toevent_id
)
- Added a new enumeration
ENUM_NEWS_FREQUENCY
and methods to convert to and from strings/datetimes - Updated the calendar and chart methods to accept
ENUM_NEWS_FREQUENCY
andENUM_NEWS_SOURCE
parameters
- Simplified parameters and URL setting in the
calendar
method - Handled null
Event ID
fields (Forex Factory endpoints do not contain that field) - Bumped version to 2.2.6 and submitted to PyPI
PyPi: https://pypi.org/project/jb-news/2.2.6/
Documentation: https://www.jblanked.com/news/api/docs/
🚀 October 10, 2025 - New Calendar Endpoints
I added two new endpoints for monthly and yearly calendar data:
New Endpoints:
Month:
/news/api/mql5/calendar/month
/news/api/forex-factory/calendar/month
Year:
/news/api/mql5/calendar/year
/news/api/forex-factory/calendar/year
These endpoints return the data from the current month/year up until today's date.
🔧 October 7, 2025
System updates to provide a smoother experience.
📅 September 24, 2025 - Date Range Filtering Update
I added date range filtering to both MQL5 and Forex Factory calendar endpoints. No more grabbing everything when you just need a specific time period.
New Endpoints:
/news/api/mql5/calendar/range/?from=year-month-day&to=year-month-day
/news/api/forex-factory/calendar/range/?from=year-month-day&to=year-month-day
Parameters:
from
- Start date (YYYY-MM-DD format)to
- End date (YYYY-MM-DD format)- API key authentication (same as existing endpoints)
Quick Examples:
Get January 2025 MQL5 events:
/news/api/mql5/calendar/range/?from=2025-01-01&to=2025-01-31
Get last week's Forex Factory events:
/news/api/forex-factory/calendar/range/?from=2025-09-17&to=2025-09-24
Should make it way easier to work with calendar data without pulling unnecessary info. Let me know if you run into any issues! 👍
⚠️ September 18, 2025 - Breaking Changes: New Pricing Model
Breaking changes!!
Due to a huge increase in traffic, free API usage has decreased to 1 request per day. For other requests, you can either purchase credits or join our updated website membership plan which unlocks unlimited access to the NewsAPI and TradeAPI, along with the other VIP perks (access to 60+ trading tools, 24/7 Discord alerts, extensive News analysis resources, and more)
It's 5 credits per GPT POST request and 1 credit for the other endpoints.
📦 November 26, 2024 - JB-News v2.4.4 Update
New Update: JB-News v2.4.4: https://github.com/jblanked/JB-News
- Refreshed news event data (January 1st, 2020 to December 10th, 2024)
- Updated the Python library:
- Changed variables/functions to snake case
- Added a timer parameter in the GPT request
- Added a 10-second timeout to all HTTP requests
- Added a
news_source
parameter so users can choose which news endpoint to retrieve data from (this was also added in the Swift library)
PyPi: https://pypi.org/project/jb-news/2.2.4/
Documentation: https://www.jblanked.com/news/api/docs/
🔧 July 13, 2024 - JB-News v2.4.2 Update
New Update: JB-News v2.4.2
- Updated the
GPT
method in the MQL library to function as intended. Similar to ourSwift
andPython
libraries, it will send a POST request containing the message and periodically ping our server for the response. - Refactored the MQL library to enhance speed by removing unnecessary casting and looping, and organizing the project structure.
Check out the documentation here.
🚀 June 28, 2024 - Calendar & Backtesting APIs Launch
New Update
Calendar API - Free, fast access to MQL5 and Forex Factory calendars. Check out the documentation here.
Backtesting API - Features machine learning, auto-smart analysis, and extensive historical news event data. Check out the documentation here.
Changes:
- Added historical data to the Forex Factory endpoints from January 1st, 2023, to today.
- Removed field restrictions in the Calendar API.
- Aligned new fields in the Forex Factory model with the MQL5 model, including Machine Learning, Smart Analysis, Outcome, Category, Strength, and Quality.
- Introduced a
Usage
section with examples for using the API in Swift, Python, and MQL. - Added support for Swift 5.10.
MQL5 and Forex Factory event data are updated within seconds of news event release times. FXStreet will be the next calendar integrated, and the upcoming updates involve the Python, MQL, and Swift News API libraries.
📱 May 31, 2024 - JB-News v2.4.0: Swift Integration
New Update - JB-News v2.4.0
Swift Integration
We've added support for Swift, enhancing the functionality for both iOS and Android devices. Users can now access our calendar, GPT, and a comprehensive news database directly through Swift. Retrieved data from calendar or GET methods is automatically saved to specific properties for streamlined usage.
var apiKey: String = "" // Stored after initialization
var history: [HistoryData] = [] // Organized historical data, retrieved via the get or calendar methods
var basicInfo: [NewsInfoBasic] = [] // Includes Event ID, Name, and Currency for each event, retrieved using the get method
var data: NewsData = NewsData() // Full news data accessible after using the get method
var newsEvents: [NewsEvent] = [] // Organized list of news events
get()
- Retrieves a comprehensive list of economic news data.calendar(today: Bool, thisWeek: Bool)
- Fetches economic news data for today or the current week, based on parameters.loadEventData(eventID: Int)
- Retrieves detailed information about a specific news event, available after using the get method.gpt(message: String)
- Fetches a response from our News GPT model based on a supplied message.gpt_post(message: String)
- Posts a message to our News GPT model and retrieves a task ID.gpt_get(taskID: String)
- Retrieves the response from our News GPT model using the provided task ID.
Example of accessing our GPT:
let yourAPIKey: String = "YOUR-API-KEY"
let newsModel = JBNews(yourAPIKey)
Task {
let messageResponse: String = await newsModel.gpt(message: "In less than 8 words, what does bullish mean?")
print(messageResponse)
}
Documentation
- View the Full documentation
- Explore our GitHub repository
🐛 May 24, 2024 - Bug Fixes & Pricing Updates
New Update
- Fixed a bug in the
/news/gpt/
endpoint. - Updated the usage chart to display billed uses.
- Lowered rate limits from 5 minutes to 1 second.
- Updated pricing and access. Users receive 24 free uses per day. Afterward, they are billed 1 credit per use for non-GPT endpoints and 5 credits per use for GPT POST requests. Users won't be charged unless they have credits, which means they will be unauthenticated unless they have free uses available on the day or have credits.
Check out the updated documentation here.
🔄 May 22, 2024 - JB-News v2.3.0: MQL5 & Forex Factory Integration
New Update - JB-News v2.3.0
MQL5 Endpoints
- Changed the MQL5 data endpoint from
/news/api/
to/news/api/mql5/
:/news/api/
is deprecated and will be fully removed on June 1st./news/api/mql5/list/
returns a list of news events with the fields "Name", "Currency", "Event_ID", and "Category"./news/api/mql5/full-list/
returns a list of dictionaries, each containing the Name, Currency, ID, Event History, Machine Learning, and Smart Analysis of each event, organized by currency./news/api/mql5/calendar/
returns a list of dictionaries, each containing the Name, Currency, ID, Event History, Machine Learning, and Smart Analysis of each event, organized by date./news/api/mql5/calendar/today/
returns a list of dictionaries with today's events, including the Name, Currency, ID, Event History, Machine Learning, and Smart Analysis, organized by date./news/api/mql5/calendar/week/
returns a list of dictionaries with this week's events, including the Name, Currency, ID, Event History, Machine Learning, and Smart Analysis, organized by date.
Forex Factory Data
- Added Forex Factory data from January 1st, 2024, to today.
- Updated the format of the "Time" and "Date" fields to a single "Date" field in the format YYYY.MM.DD HH:MM.
- Created replica MQL5 endpoints for Forex Factory data:
/news/api/forex-factory/list/
returns a list of news events with the fields "Name" and "Currency"./news/api/forex-factory/full-list/
returns a list of dictionaries, each containing the Name, Currency, and Event History of each event, organized by currency./news/api/forex-factory/calendar/
returns a list of dictionaries, each containing the Name, Currency, and Event History of each event, organized by date./news/api/forex-factory/calendar/today/
returns a list of dictionaries with today's events, including the Name, Currency, and Event History, organized by date./news/api/forex-factory/calendar/week/
returns a list of dictionaries with this week's events, including the Name, Currency, and Event History, organized by date.
Miscellaneous
- Updated the
/news/api/gpt/
endpoint to allow access to all users. - Added a usage page so users can track their API key usage.
Documentation will be updated over the next few hours, followed by the pricing update.