commodity-macro-signal
Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals. Skill: commodity-macro-signal Owner: finskills Summary: Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-04-18T15:47:52.044Z | user - Added a skill manifest block (metadata) including API key requirements, author, and homepage info. - Updated API key setup instructions for clarity and direct r
Rank
62
Safety
84
Downloads
965
Updated
Oct 12, 2026
Version
1.0.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 965 downloads reported by the source. Last updated 10/12/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 12, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 12, 2026
- Adoption signal
- 965 downloadsadoption · observed Oct 12, 2026
- Latest release
- 1.0.1release · observed Apr 18, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 1.0.1release
- Added a skill manifest block (metadata) including API key requirements, author, and homepage info. - Updated API key setup instructions for clarity and direct registration link. - No changes to code functionality or API usage; documentation update only.
Observed Apr 18, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s179tgs48y0pmgcemse7r2m5w18476rn:commodity-macro-signal- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
30,384 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: Commodity Macro Signal
version: 1.0.2
description: "Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals."
author: finskills
metadata:
openclaw:
requires:
env:
- FINSKILLS_API_KEY
primaryEnv: FINSKILLS_API_KEY
homepage: https://github.com/finskills/commodity-macro-signal
---
# Commodity Macro Signal
Analyze global commodity markets to extract macro signals for inflation, growth,
and supply chain dynamics using free-tier Finskills API data. Covers energy
(crude oil, natural gas), precious metals (gold, silver), industrial metals
(copper), agricultural products, and FRED/IMF commodity indices — then synthesizes
investment implications across asset classes.
---
## Setup
**API Key required** — [Register at https://finskills.net](https://finskills.net) to get your free key.
Header: `X-API-Key: <your_api_key>`
> **Get your API key**: Register at **https://finskills.net** — free tier available, Pro plan unlocks real-time quotes, history, and financials.
---
## When to Activate This Skill
Activate when the user:
- Asks about oil, gold, copper, natural gas, silver, or agricultural commodity prices
- Wants to understand what rising/falling commodity prices mean for markets
- Asks "is this inflationary or deflationary?"
- Wants a commodity-driven macro analysis
- Asks about Dr. Copper, gold/silver ratio, oil equity ratio
- Wants to know how commodities affect specific sectors (energy, materials, airlines, etc.)
---
## Data Retrieval — Finskills API Calls
### 1. All Commodity Spot Prices (Snapshot)
```
GET https://finskills.net/v1/free/commodity/prices
```
Extract the full commodity price dashboard:
- Energy: `crude_oil_wti`, `crude_oil_brent`, `natural_gas`, `heating_oil`, `gasoline`
- Metals: `gold`, `silver`, `platinum`, `copper`, `aluminum`, `iron_ore`
- Agricultural: `corn`, `wheat`, `soybeans`, `coffee`, `cotton`, `sugar`
### 2. Individual Commodity History (for trend analysis)
For key commodities, fetch 1-year daily history:
```
GET https://finskills.net/v1/free/commodity/history/{symbol}
```
Target symbols: `WTI` (crude oil), `gold`, `copper`, `natgas`, `wheat`
Extract: date, price, change
### 3. FRED Commodity Data Series
```
GET https://finskills.net/v1/free/commodity/fred
```
Lists all available FRED commodity series.
```
GET https://finskills.net/v1/free/commodity/fred/{seriesId}
```
Key series to pull:
- `DCOILWTICO`: WTI Crude Oil Daily Price
- `GOLDAMGBD228NLBM`: Gold Price Daily
- `PCOPPUSDM`: Copper Price Monthly
- `TERMCBPER24NS`: Not applicable — use commodity endpoint instead
### 4. IMF Commodity Index
```
GET https://finskills.net/v1/free/commodity/imf
```
Extract: IMF primary commodity price index (energy, metals, food sub-indices)
Use for: broad commodity cycle positioning (secular bull/bear)
---
## Analysis Workflow
### Step 1 — Commodity Price Dashboard
Create a snapshot of all key commodities with direcREADME.md
# commodity-macro-signal
> Analyze energy, metals, and agricultural commodity prices to extract macro signals for inflation, growth, and sector rotation — all via free-tier [Finskills API](https://finskills.net) commodity endpoints.
[]()
[](https://finskills.net/register)
[]()
---
## What This Skill Does
1. Fetches a full commodity price dashboard: energy (WTI/Brent, NatGas), metals (Gold, Silver, Copper), agricultural (Wheat, Corn, Soybeans)
2. Computes 1M/3M/YTD trends per commodity
3. Calculates macro signal ratios: Gold/Silver ratio, Copper/Gold ratio ("Dr. Copper")
4. Fetches FRED and IMF commodity indices for broader cycle context
5. Classifies current commodity super-cycle phase (Early Bull → Late Bear)
6. Maps commodity signals to sector and asset class implications (OW/N/UW)
**All API endpoints used are on the free tier — no Pro plan required.**
## Install
Add this skill via [ClawHub](https://clawhub.ai/finskills/commodity-macro-signal):
1. Visit **[https://clawhub.ai/finskills/commodity-macro-signal](https://clawhub.ai/finskills/commodity-macro-signal)**
2. Click **Download zip** and follow the setup instructions
3. Set your API key: `FINSKILLS_API_KEY=your_key_here`
## Quick Start
```
You: What are commodity prices telling us about the macro environment?
Claude: [Fetches all commodity prices + history + FRED series, computes ratios, outputs macro signal report]
```
## Example Triggers
- `"What's the signal from oil prices right now?"`
- `"Is gold rising for good or bad reasons?"`
- `"What is Dr. Copper saying about the economy?"`
- `"Give me a commodities macro panel"`
- `"Should I overweight energy or materials based on commodities?"`
## Key Signal Ratios
| Ratio | Interpretation |
|-------|---------------|
| Gold/Silver > 80 | Risk-off, economic uncertainty |
| Gold/Silver < 60 | Risk-on, industrial expansion |
| Copper/Gold rising | Growth regime, yields following |
| Copper/Gold falling | Deflationary / slowdown signal |
| WTI > $90 | High inflation pressure or supply shock |
| WTI < $60 | Disinflation, consumer spending tailwind |
## API Endpoints Used (All Free)
| Endpoint | Data |
|----------|------|
| `GET /v1/free/commodity/prices` | All commodity spot prices |
| `GET /v1/free/commodity/history/{symbol}` | 1Y history for WTI, Gold, Copper |
| `GET /v1/free/commodity/fred/{seriesId}` | FRED commodity series (DCOILWTICO, etc.) |
| `GET /v1/free/commodity/imf` | IMF all-commodity + sub-indices |
## Requirements
- **Finskills API Key**: [Register at finskills.net](https://finskills.net) (free tier available) — **free plan is sufficient**
- **Claude** with skill support
## License
MIT — see [LICENSE](../LICENSE)_meta.json
{
"ownerId": "kn7ebwb8j890wdqw56b58x77w182snyh",
"slug": "commodity-macro-signal",
"version": "1.0.1",
"publishedAt": 1776527272044
}skill-card.md
## Description: Analyze energy, metals, and agricultural commodity markets alongside macro indicators to generate cross-asset macro signals. This skill is ready for commercial/non-commercial use. ## Publisher: [finskills](https://clawhub.ai/user/finskills) ### License/Terms of Use: MIT-0 ## Use Case: Developers, analysts, and financial research teams use this skill to fetch Finskills commodity data and produce macro signal reports about inflation, growth, sector rotation, and asset-class implications. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Commodity macro interpretations may be mistaken for personalized trading advice. Mitigation: Frame results as informational market analysis and avoid automated trading or individualized portfolio recommendations. Risk: The skill requires a Finskills API key for commodity data requests. Mitigation: Keep FINSKILLS_API_KEY in environment configuration and avoid exposing it in prompts, logs, or generated reports. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/finskills/skills/commodity-macro-signal) - [Project homepage](https://github.com/finskills/commodity-macro-signal) - [Finskills API registration](https://finskills.net) ## Skill Output: **Output Type(s):** [Text, Markdown, API calls, Guidance] **Output Format:** [Markdown market analysis report with commodity snapshots, signal ratios, cycle classification, and sector implications.] **Output Parameters:** [1D] **Other Properties Related to Output:** [Requires FINSKILLS_API_KEY; outputs should be treated as informational market analysis, not automated trading or personalized financial advice.] ## Skill Version(s): 1.0.1 (source: server release metadata; target metadata agrees) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/finskills/skills/commodity-macro-signal",
"sourceUrl": "https://clawhub.ai/finskills/skills/commodity-macro-signal",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T00:53:42.229Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-12T00:53:42.229Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "965 downloads",
"href": "https://clawhub.ai/finskills/commodity-macro-signal",
"sourceUrl": "https://clawhub.ai/finskills/commodity-macro-signal",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T00:53:42.229Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.1",
"href": "https://clawhub.ai/finskills/commodity-macro-signal",
"sourceUrl": "https://clawhub.ai/finskills/commodity-macro-signal",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-18T15:47:52.044Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-finskills-commodity-macro-signal/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.1",
"description": "- Added a skill manifest block (metadata) including API key requirements, author, and homepage info. - Updated API key setup instructions for clarity and direct registration link. - No changes to code functionality or API usage; documentation update only.",
"href": "https://clawhub.ai/finskills/commodity-macro-signal",
"sourceUrl": "https://clawhub.ai/finskills/commodity-macro-signal",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-18T15:47:52.044Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-finskills-commodity-macro-signal/run-check
