Include your API key in the header of every request. Generate your API 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";

One request per second. 1 credit per premium use, otherwise free. Purchase credits — charges only occur if users have credits. Monitor usage.

Returns a JSON list of all available News Events.

Example Response

[
  {
    "Name": "Adjusted Current Account",
    "Currency": "JPY",
    "Event_ID": 39207008,
    "Category": "Currency Report",
    "Impact": "Low"
  }
]

[
  {
    "Name": "Adjusted Current Account",
    "Currency": "JPY",
    "Event_ID": 39207008,
    "Category": "Currency Report",
    "Impact": "Low"
  }
]

[
  {
    "Name": "Adjusted Current Account",
    "Currency": "JPY",
    "Event_ID": 39207008,
    "Category": "Currency Report",
    "Impact": "Low"
  }
]

Retrieve specific event information by replacing ID with the Event Identification number:

• MQL5: GET /news/api/mql5/ID
• Forex Factory: GET /news/api/forex-factory/ID
• FxStreet: GET /news/api/fxstreet/ID

Returns a JSON object with Name, Currency, Event ID, Category, and Impact.

Retrieve a specific event's history by replacing ID:

• MQL5: GET /news/api/mql5/ID/history/
• Forex Factory: GET /news/api/forex-factory/ID/history/
• FxStreet: GET /news/api/fxstreet/ID/history/

Example Response

{
  "Name": "Average Hourly Earnings m/m",
  "Currency": "USD",
  "Event_ID": 840030018,
  "Category": "Job Inflation Report",
  "Impact": "High",
  "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",
  "Impact": "High",
  "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"
    }
  ]
}

{
  "Name": "Average Hourly Earnings m/m",
  "Currency": "USD",
  "Event_ID": 840030018,
  "Category": "Job Inflation Report",
  "Impact": "High",
  "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"
    }
  ]
}

GET /news/api/mql5/ID/machine-learning/ (MQL5 data only)

Returns a JSON object with ML predictions including bullish/bearish probabilities at 1-min, 30-min, and 1-hour intervals, plus accuracy scores.

Example Response

{
  "Name": "Average Hourly Earnings m/m",
  "Currency": "USD",
  "Event_ID": 840030018,
  "Category": "Job Inflation Report",
  "Impact": "High",
  "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}
      }
    },
    "Accuracy": {
      "1 Hour": 0.57,
      "1 Minute": 0.71,
      "30 Minute": 0.43
    }
  }
}

GET /news/api/mql5/ID/smart-analysis/ (MQL5 data only)

Returns a JSON object with automatic directional analysis for each possible outcome scenario.

Example Response

{
  "Name": "Average Hourly Earnings m/m",
  "Currency": "USD",
  "Event_ID": 840030018,
  "Category": "Job Inflation Report",
  "Impact": "High",
  "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"
  }
}