Forex Sentiment API

// what you get back
{
  "schema": "fxnb.sentiment.v1",
  "generated_at": "2026-08-21T09:00:12Z",
  "data": [
    { "currency": "USD", "score": 72,
      "bias": "Bullish" },
    { "currency": "EUR", "score": 42,
      "bias": "Bearish" },
    ... 6 more
  ]
}

Endpoints

Two GET endpoints, both authenticated with the same key. Base URL https://fxnewsbias.com.

The API serves forward data: the current read and everything published from now on. Historical series are not available through the API. If you need history for research, talk to us about a data licence.

Quickstart

Bearer header only. Keys are never accepted in the URL or query string.

curl -H "Authorization: Bearer $FXNB_KEY" \
  https://fxnewsbias.com/api/v1/sentiment

Response shape

{
  "schema": "fxnb.sentiment.v1",
  "generated_at": "2026-08-21T09:00:12Z",
  "next_update_expected": "2026-08-21T12:00:00Z",
  "attribution": {
    "required": true,
    "text": "Data by FXNewsBias",
    "url": "https://fxnewsbias.com"
  },
  "data": [
    { "currency": "USD", "score": 72, "bias": "Bullish",
      "updated_at": "2026-08-21T09:00:00Z" },
    ... 7 more
  ]
}

Staying current without wasting quota

Scores publish on a fixed 3-hour cycle. Rather than polling blindly, read next_update_expected and come back then. You get the new data within seconds of publication and spend about 8 requests a day.

import requests, time
from datetime import datetime, timezone

H = {"Authorization": "Bearer " + FXNB_KEY}

while True:
    r = requests.get("https://fxnewsbias.com/api/v1/sentiment", headers=H).json()
    handle(r["data"])
    nxt = datetime.fromisoformat(r["next_update_expected"].replace("Z", "+00:00"))
    time.sleep(max(30, (nxt - datetime.now(timezone.utc)).total_seconds() + 20))

Rate limits

• 200 requests per UTC calendar day per account, resetting at 00:00 UTC
• Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset
• One over the limit returns 429 with a Retry-After header
• The allowance follows the account, not the key, so regenerating a key does not reset it

Errors

Attribution and terms

• Wherever the data is displayed or republished, keep the attribution "Data by FXNewsBias" linking to https://fxnewsbias.com. It ships in every response
• Your Pro subscription covers commercial use inside your own product
• No redistribution, resale, or using the data to build a competing sentiment service
• One key per account. Sharing a key across separate users or products is not permitted and is detectable
• Your key works while your subscription is active, including the free trial, and stops when it ends
• Questions, higher volume, or a data licence: contact@fxnewsbias.com

Frequently asked questions

Where the data comes from