Commodity Prices, Momentum Scores & Social Leaderboard

One actor that answers three questions your market research, dashboards, or AI agents keep asking: what are commodities actually trading at, which way is momentum pointing, and what is the market talking about right now?

Getting commodity data normally means juggling half a dozen sources — a government API here, a spreadsheet there, an expensive terminal for anything social — and then worrying about whether you're even allowed to store and reuse what you fetched. This actor collapses that into one call with a clean licensing story: prices come only from sources that permit reuse (World Bank, US-government data) or from your own API keys; sentiment comes as statistics we compute ourselves. No scraped exchange quotes, no redistributed social content — nothing you have to think twice about building on.

It's built agent-first: every mode returns flat, predictable JSON rows an LLM agent or a pandas one-liner can consume directly, and the whole catalog is discoverable with a free list call. Ask it for two years of gold prices, a momentum read on WTI, or this week's most-talked-about tickers with their sentiment — same actor, one line of input each.

Use from AI agents (MCP)

This actor is callable through Apify's MCP server — point your agent at https://mcp.apify.com (authorized with your Apify token) and it can discover this actor and run it like any tool:

{
  "actor": "palatial_lorikeet/commodity-pulse",
  "input": { "mode": "leaderboard" }
}

Every mode returns flat JSON rows with stable field names — no HTML, no nested blobs — so results drop straight into an agent's context or a DataFrame. Typical agent patterns: pull the daily sentiment leaderboard as market context, check momentum state before a simulated trade, or fetch a price history for charting and analysis.

What you get

Four modes, one actor:

Mode	What it returns	Charged per
fetch	Normalized price rows: series_id, date, value, unit, source	price row
score	B-Xtrender momentum composite per date (daily + weekly + monthly momentum states, RSI, integer score −8..+8)	score row
leaderboard	Daily snapshot: top-25 most-mentioned tickers on finance social media with LLM sentiment aggregates, plus commodity topics (gold, oil, natgas, …) with mention z-scores	leaderboard row
list	The full series catalog	free

Price series

• World Bank Pink Sheet (monthly) — WTI, Brent, natural gas, gold, silver, copper, wheat, maize, coffee, sugar. Always current: the actor resolves the latest release automatically.
• EIA daily spot (WTI Cushing, Brent, Henry Hub) — US-government data, rolling out.
• Bring-your-own-key (daily) — Alpha Vantage commodity endpoints and Polygon commodity-ETF proxies (GLD, SLV, USO, UNG) using your API key; your data relationship stays between you and your provider.

Momentum scores

The score mode runs a B-Xtrender-based composite on any daily series: short-term momentum state, completed-bar weekly and monthly states (no lookahead — a bar's state is only used after the bar closes), RSI(14), and an integer composite score. Built for systematic filters and agent decision inputs, not chart art.

Social leaderboard

Refreshed daily from a curated set of finance accounts:

• Top 25 tickers by mention volume (7-day window) with sentiment aggregates — each ticker's tweets are individually scored by an LLM that reads trader slang and sarcasm, not just surface tone.
• Commodity topics (gold, silver, oil, natgas, wheat, corn) with mention counts, attention z-scores, and sentiment.

Aggregates only. The feed contains counts and statistics — never tweet text or user content.

Example leaderboard row:

{
  "date": "2026-08-09",
  "window_days": 7,
  "kind": "symbol",
  "symbol": "PLTR",
  "mentions_7d": 82,
  "sentiment_n": 21,
  "sentiment_mean": 0.41
}

Input

{
  "mode": "fetch",
  "series": "wti_monthly_wb",
  "start": "2026-01-01",
  "end": "2026-08-01"
}

Run mode: "list" to see every series id. BYOK series take your key in the api_key field (stored as a secret input).

Licensing & attribution

• World Bank Pink Sheet: CC BY 4.0 — "Source: World Bank, Commodity Markets (CMO)."
• EIA / USDA series: US-government public domain.
• BYOK series: fetched with your credentials under your provider agreement.
• Momentum scores and leaderboard aggregates are original derived data.

Support

Issues and feature requests (additional series, more tickers, delivery formats) are welcome via the actor's Issues tab.