Our API leverages OpenAI and advanced machine learning techniques to deliver comprehensive forex news event data and analysis. This service is designed to support developers working with a variety of programming languages, including MQL5, MQL4, Swift, and Python. It provides a robust suite of features tailored for accessing detailed event information and predictive analytics, enhancing decision-making in forex trading.
Library Access
| Platform | Link |
|---|---|
| GitHub | https://github.com/jblanked/JB-News |
| Python | https://pypi.org/project/jb-news/ |
| MQL | Github |
| Swift | Github |
You can also access the API using GET requests. To authenticate your GET requests, include your API key in the header of your request. You can generate an API key in your profile.
Example Header:
{
"Content-Type": "application/json",
"Authorization": "Api-Key YOUR_API_KEY"
}var request = URLRequest(url: URL(string: "https://www.jblanked.com/news/api/YOUR-END-POINT"))
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";Rate Limit
Our API enforces a rate limit of one request per second to ensure service stability and fair usage.
Pricing and Credits
1 credit per use. Credits can be purchased via our billing page. You can monitor your API usage here.
Note: Charges will only occur if users have credits.
Endpoints
| Endpoint | Description |
|---|---|
| Event List | List of News Events |
| Event Info | Basic news event information |
| Event History | Details including Strength, Quality, Projection, and Outcome |
| Machine Learning | Predictions on event outcomes |
| Smart Analysis | Analysis on event outcomes |
| Full Event List | Comprehensive list of events with all details |
To access the Event List endpoint, send a GET request to:
| Data | Endpoint |
|---|---|
| MQL5 | https://www.jblanked.com/news/api/mql5/list/ |
| Forex Factory | https://www.jblanked.com/news/api/forex-factory/list/ |
It returns a JSON list of dictionaries of all available News Events.
Example Response:
[
{
"Name": "Adjusted Current Account",
"Currency": "JPY",
"Event_ID": 39207008,
"Category": "Currency Report",
},
][
{
"Name": "Adjusted Current Account",
"Currency": "JPY",
"Event_ID": 39207008,
"Category": "Currency Report",
},
]To retrieve specific event information, send a GET request to the URLs below, replacing 'ID' with the Event Identification number:
- MQL5 Data: https://www.jblanked.com/news/api/mql5/ID
- Forex Factory Data: https://www.jblanked.com/news/api/forex-factory/ID
It returns a JSON object with the Name, Currency, Event ID, and Category.
Example Response:
[
{
"Name": "Adjusted Current Account",
"Currency": "JPY",
"Event_ID": 39207008,
"Category": "Currency Report",
},
][
{
"Name": "Adjusted Current Account",
"Currency": "JPY",
"Event_ID": 39207008,
"Category": "Currency Report",
},
]To retrieve a specific event's history information, send a GET request to the URLs below, replacing 'ID' with the Event Identification number:
- MQL5 Data: https://www.jblanked.com/news/api/mql5/ID/history/
- Forex Factory Data: https://www.jblanked.com/news/api/forex-factory/ID/history/
It returns a JSON object with the Name, Currency, Event ID, Category, and Event History.
Example Response:
{
"Name": "Average Hourly Earnings m/m",
"Currency": "USD",
"Event_ID": 840030018,
"Category": "Job Inflation Report",
"History": [
{
"Date": "2023.12.08 15:30:00",
"Actual": 0.4,
"Forecast": 0.4,
"Previous": 0.2,
"Outcome": "Actual = Forecast > Previous",
"Projection": 0.5,
"Strength": "Strong Data",
"Quality": "Bad Data",
},
],
}{
"Name": "Average Hourly Earnings m/m",
"Currency": "USD",
"Event_ID": 840030018,
"Category": "Job Inflation Report",
"History": [
{
"Date": "2023.12.08 15:30:00",
"Actual": 0.4,
"Forecast": 0.4,
"Previous": 0.2,
"Outcome": "Actual = Forecast > Previous",
"Strength": "Strong Data",
"Quality": "Bad Data",
},
],
}To access the Machine Learning endpoint, send a GET request to: https://www.jblanked.com/news/api/mql5/ID/machine-learning/, where ID is the Event Identification number. This endpoint only has MQL5 data.
It returns a JSON object with the Name, Currency, Event ID, Category, and Machine Learning predictions.
Example Response:
{
"Name": "Average Hourly Earnings m/m",
"Currency": "USD",
"Event_ID": 840030018,
"Category": "Job Inflation Report",
"MachineLearning": {
"Outcomes": {
"Actual < Forecast < Previous": {
"1 Hour": {"Bearish": 36.77, "Bullish": 61.21},
"1 Minute": {"Bearish": 33.23, "Bullish": 65.27},
"30 Minute": {"Bearish": 33.80, "Bullish": 65.07},
},
// other outcomes...
},
"Accuracy": {
"1 Hour": 0.57,
"1 Minute": 0.71,
"30 Minute": 0.43,
}
}
}To access the Smart Analysis endpoint, send a GET request to: https://www.jblanked.com/news/api/mql5/ID/smart-analysis/, where ID is the Event Identification number. This endpoint only has MQL5 data.
It returns a JSON object with the Name, Currency, Event ID, Category, and Smart Analysis.
Example Response:
{
"Name": "Average Hourly Earnings m/m",
"Currency": "USD",
"Event_ID": 840030018,
"Category": "Job Inflation Report",
"SmartAnalysis": {
"Actual < Forecast < Previous": "Bullish",
"Actual < Forecast = Previous": "Bullish",
"Actual = Forecast < Previous": "Bullish",
"Actual = Forecast = Previous": "Neither_Bearish_or_Bullish",
"Actual = Forecast > Previous": "Bearish",
"Actual > Forecast > Previous": "Bearish",
// other outcomes...
}
}| Data Source | Endpoint |
|---|---|
| MQL5 | https://www.jblanked.com/news/api/mql5/full-list/ |
| Forex Factory | https://www.jblanked.com/news/api/forex-factory/full-list/ |