News API Documentation
Last Updated: October 10th, 2026
Get sentiment scores, event predictions, and historical data in seconds. Integrate advanced forex intelligence into your trading platform today.
Quick Start
Welcome to our Forex News API, your complete solution for comprehensive historical data, calendar information, and advanced AI-driven insights. Harness the power of OpenAI and machine learning to access detailed analyses of forex news events and related speeches, optimized for MQL5, MQL4, Swift, and Python.
Authentication
Include your API key in the header of every request. Generate your key in your profile.
headers = {
"Content-Type": "application/json",
"Authorization": "Api-Key YOUR_API_KEY"
}
var request = URLRequest(url: URL(string: "https://www.jblanked.com/news/api/YOUR-ENDPOINT")!)
request.addValue("Api-Key YOUR_API_KEY", forHTTPHeaderField: "Authorization")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
string headers = "Content-Type: application/json\r\n"
+ "Authorization: Api-Key YOUR_API_KEY";
Why Trading Teams Choose Us
Stop wasting time on manual research and unreliable data. Get the insights you need to make better trading decisions, faster.
| Feature | Our Value | Competitor Value |
|---|---|---|
| Start Trading on News Instantly | ✓ Real-time alerts with AI sentiment scores | Hours of manual monitoring |
| Test Your Strategies with Real Data | ✓ Years of backtesting data + ML predictions | Limited or incomplete historical records |
| Experience-Based Impact Analysis | ✓ 5+ years of market data with Outcome, Strength, Quality metrics | Generic "high/medium/low" ratings |
| Automate Everything | ✓ Ready-to-use libraries for Python, MQL4/5, Swift | Build integrations from scratch |
| Scale Without Limits | ✓ Unlimited requests on paid plans | Restrictive rate limits |
| Get Smarter Predictions | ✓ OpenAI-powered analysis with accuracy scores | Basic data, no intelligent insights |
| Get Help When You Need It | ✓ Active community + direct support | Slow email support or none |
Experience-Based Impact Analysis
Our Impact field isn't guesswork — it's built on over 5 years of real market movement data. We track actual price reactions and use that historical performance to classify impact with precision.
Outcome
What it measures: The result of an event's data compared to forecast and previous values, influencing market sentiment.
Actual = Forecast = Previous
Strength
What it measures: Weak Data or Strong Data. Weak = old/repeated/low-impact news. Strong = high-impact events with significant deviation.
Quality
What it measures: Good Data or Bad Data. Bad = news hurting the currency/economy. Good = news supporting the currency/economy.
This three-dimensional approach gives you the complete picture: not just "was there impact?" but "what kind, how much, and how reliable?"
Authentication
All API requests require authentication via an API key passed in the Authorization header.
import requests
url = "https://www.jblanked.com/news/api/mql5/calendar/today/"
headers = {
"Content-Type": "application/json",
"Authorization": "Api-Key YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
import Foundation
let url = URL(string: "https://www.jblanked.com/news/api/mql5/calendar/today/")!
var request = URLRequest(url: url)
request.addValue("Api-Key YOUR_API_KEY", forHTTPHeaderField: "Authorization")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
let (data, _) = try await URLSession.shared.data(for: request)
print(String(data: data, encoding: .utf8)!)
#include <jb-news\news.mqh>
CRequests request;
request.url = "https://www.jblanked.com/news/api/mql5/calendar/today/";
request.key = "YOUR_API_KEY";
if(request.GET()) {
Print(request.result);
}
API Endpoints
| API | Description | Documentation |
|---|---|---|
| Backtesting | Machine Learning, Auto Smart analysis, and historical event data | View Docs → |
| Calendar | Real-time list of forex events ordered by time | View Docs → |
| GPT | AI-powered sentiment analysis on news events and statements | View Docs → |
Model Context Protocol (MCP) Server
The News API MCP server is hosted by this website and uses Streamable HTTP. Connect your MCP client to https://www.jblanked.com/news/api/mcp; you do not need to install or run a separate server.
Send your own API key in the Authorization header on every request, using Api-Key YOUR_API_KEY. The server validates the key against this website's API-key records and forwards it to the News API, so existing permissions, rate limits, and usage charges still apply.
Example remote-server settings (client configuration syntax varies):
{
"mcpServers": {
"jblanked-news": {
"url": "https://www.jblanked.com/news/api/mcp",
"headers": {
"Authorization": "Api-Key YOUR_API_KEY"
}
}
}
}
Available tools cover calendar periods (today, week, month, year, or a date range), event lists and details, event histories, full backtesting data, MQL5 machine-learning results, and MQL5 smart analysis.
Library Access
Official client libraries for easy integration.
| Platform | Package | Install |
|---|---|---|
| Python | jb-news on PyPI | pip install jb-news |
| MQL4/5 | MQL Library on GitHub | Copy to MQL5/Include/ |
| Swift | JBNews.swift on GitHub | Add to Xcode project |
| GitHub | Full Repository | git clone |
JB News Calendar App
Download for Linux, macOS, or Windows. The app parses and stores news data on your computer and can optionally export it to CSV.
The app requires credits and an JBlanked API key, which is included with every request. 1 credit is consumed per request. App requests have no rate limit.
Downloads
Linux (.zip) macOS (.zip) macOS Intel (.zip) Windows (.exe ZIP)
How it works
- The app sends each request, including your API key, to JBlanked for a handshake.
- JBlanked returns raw news data from the providers.
- The app parses and stores the data locally on your computer. You can optionally export it to CSV.
Desktop app vs. hosted News API
| Feature | Desktop app | Hosted News API |
|---|---|---|
| Data handling | Raw provider data is parsed and stored locally on your device. | Returns data from the JBlanked-hosted news dataset. |
| Data fields | Includes provider data such as currencies not supported by the hosted API (for example, CNY) and provider impact fields. It does not include JBlanked-curated fields. | Includes JBlanked-curated fields such as Trend, Quality, Category, and Strength. |
| Limits and terms | No JBlanked rate limit applies to app requests. You are responsible for complying with news providers' usage policies. | Rate limits and usage rules depend on the API endpoint and plan. |
Important: You are responsible for how you use the raw data and must follow the applicable news providers' usage policies.
Watch the Overview
Trusted by 500+ Developers and Trading Firms Worldwide
"This API transformed our trading bot. The AI sentiment analysis is incredibly accurate, and the backtesting data saved us months of manual research."
"Finally, a forex API without ridiculous rate limits. We process thousands of requests daily for our mobile app, and the unlimited plan is a game-changer."
"The MQL5 library integration was seamless. Within a day, we had live news alerts running. The ML predictions have significantly improved our entry timing."