FinancialJuice APIfinancialjuice.com ↗
Access FinancialJuice financial news, economic calendar, MOO/MOC imbalances, and high-impact news scoring via 7 structured endpoints.
What is the FinancialJuice API?
The FinancialJuice API exposes 7 endpoints covering real-time financial news, economic calendar events, and market imbalance data. The get_high_impact_news endpoint assigns a computed volatility score (1–10) to market-moving headlines, filtering to items scoring 3 or above. Other endpoints return structured calendar events with actual, forecast, and previous data values, plus MOO and MOC imbalance summaries for S&P 500, NASDAQ 100, DOW 30, and MAG 7 indexes.
curl -X GET 'https://api.parse.bot/scraper/1ffd7dde-1ef5-44de-aeeb-4e70d73df082/get_news_feed?old_id=0&tab_id=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace financialjuice-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""FinancialJuice SDK — real-time financial news, calendar, and market data."""
from parse_apis.financial_juice_api import FinancialJuice, Article, QueryRequired
client = FinancialJuice()
# Latest news feed — list with pagination, capped at 5 items
for article in client.articles.list(limit=5):
print(article.title, article.timestamp, article.labels)
# Search for Fed-related news
article = client.articles.search(query="Fed", limit=1).first()
if article:
print(article.title, article.url)
# Typed error handling — catch invalid input
try:
for a in client.articles.search(query="", limit=1):
print(a.title)
except QueryRequired as exc:
print(f"Query required: {exc}")
# Economic calendar — high-impact events
for event in client.calendarevents.list(limit=3):
print(event.title, event.country, event.impact, event.actual)
# Market imbalances — singleton fetch
report = client.imbalancereports.fetch()
for imb in report.realtime_imbalances:
print(imb.sheet_name, imb.moo_total, imb.moc_total)
# High-impact news with volatility scores
for item in client.highimpactarticles.list(limit=3):
print(item.title, item.volatility_score, item.is_breaking)
print("exercised: articles.list / articles.search / calendarevents.list / imbalancereports.fetch / highimpactarticles.list")
Fetch the main news feed from FinancialJuice with optional keyword filtering and ID-based pagination. Returns the 20 most recent news items matching the criteria. Pagination advances by passing the last item's ID as old_id to fetch older articles.
| Param | Type | Description |
|---|---|---|
| query | string | Search filter keyword for news items. Omitting returns all recent news. |
| old_id | integer | Last news ID for pagination (fetch items older than this ID). Pass 0 or omit to get the latest. |
| tab_id | integer | Tab filter ID for category filtering. 0 returns all categories. |
{
"type": "object",
"fields": {
"news": "array of news article objects with id, title, description, timestamp, date, labels, and url",
"count": "integer total number of articles returned"
},
"sample": {
"data": {
"news": [
{
"id": 9630114,
"url": "https://www.financialjuice.com/News/9630114/Meta-loses-access-to-Manus-data-after-Chinese-buyout-reversed.aspx",
"date": "2026-06-11T08:08:52.453",
"title": "Meta loses access to Manus data after Chinese buyout reversed",
"labels": [],
"timestamp": "08:08 Jun 11",
"description": ""
},
{
"id": 9630075,
"url": "https://www.financialjuice.com/News/9630075/Iran-Foreign-Ministry-US-attacks-render-ceasefire-meaningless.aspx",
"date": "2026-06-11T07:49:56.313",
"title": "Iran Foreign Ministry: US attacks render ceasefire 'meaningless'.",
"labels": [
"Energy",
"US Indexes",
"USD"
],
"timestamp": "07:49 Jun 11",
"description": ""
}
],
"count": 20
},
"status": "success"
}
}About the FinancialJuice API
News Feed and Search
The get_news_feed endpoint returns up to 20 recent news items, each with id, title, description, timestamp, date, labels, and url. It accepts an optional query string for keyword filtering, a tab_id for category-level filtering, and an old_id integer for cursor-based pagination — pass the lowest id from the previous response to fetch older articles. The search_news endpoint offers a dedicated keyword search returning the same article shape plus a query echo field. search_tariffs is a fixed variant that always queries for tariff-related content, useful for workflows that monitor trade policy coverage without managing query state.
The FinancialJuice API is a managed, monitored endpoint for financialjuice.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when financialjuice.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official financialjuice.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Alerting systems that trigger on
volatility_scorethresholds fromget_high_impact_newsto flag trades during FOMC or CPI releases - Economic event dashboards that display
actualvsforecastvspreviousfromget_economic_calendarfor live consensus tracking - MOO/MOC imbalance monitors using
MOO_Buys,MOO_Sells,MOC_Totalfields to gauge opening and closing order flow for S&P 500 and NASDAQ 100 - Trade-policy research pipelines that call
search_tariffson a schedule to collect and store tariff-related news with timestamps and labels - Hourly market briefing bots that consume the
summaryfield fromget_hourly_summaryand post it to Slack or a messaging interface - News archive tools that paginate through
get_news_feedusingold_idto build a historical dataset of financial headlines with labels - Breaking news classifiers that use the
is_breakingflag andlabelsfromget_high_impact_newsto route stories to different downstream consumers
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FinancialJuice have an official developer API?+
How does `get_high_impact_news` decide what to return?+
volatility_score between 1 and 10; only items scoring 3 or above are returned, sorted by score descending. The is_breaking boolean field indicates whether the breaking-news boost was applied.Can I filter the economic calendar by date range or country?+
get_economic_calendar takes no input parameters and returns all currently scheduled events in a single response. Date-range or country filtering is not currently available. You can fork the API on Parse and revise it to add filtering logic on top of the returned date and country fields.Does the API return full article body text?+
title, description, labels, timestamp, and url. You can fork the API on Parse and revise it to add an endpoint that fetches article body content from the linked url.What is the pagination mechanism for the news feed?+
get_news_feed returns at most 20 items per call. To fetch older articles, pass the id of the oldest item in the current response as the old_id parameter on the next call. The endpoint will return up to 20 items with IDs lower than that value. There is no offset or page-number parameter.