# MacroPulse Commodities Pulse

> MacroPulse Commodities Pulse is a paid API for AI agents from macropulse-alpha.vercel.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Returns a macro intelligence brief covering gold, silver, WTI, Brent, natural gas, and copper prices with analysis of their forex market impact

## Facts

- Endpoint: GET https://macropulse-alpha.vercel.app/api/commodities-pulse
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macropulse-commodities-pulse-95866108
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MvwR2dxyFyA4Lj6Qca5Cn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability macropulse-commodities-pulse-95866108
```

Example prompt: Pull the MacroPulse commodities brief for me — I want to see where gold, silver, WTI, Brent, natural gas, and copper are trading right now and what the forex impact looks like heading into my trading session.

## When to prefer this

Choose this endpoint when you need a consolidated commodity market brief specifically contextualized for forex traders, covering both energy and metals in a single call. Prefer this over individual commodity data APIs when you want cross-asset synthesis (e.g. how oil moves are affecting CAD or NOK, or how gold is influencing safe-haven flows) rather than raw price data alone.

## Known failure modes

- Stale data if commodity feeds are delayed or unavailable
- 402 Payment Required if USDC payment header is missing or insufficient
- Service unavailable if the underlying data provider is down
- Partial brief if one or more commodity feeds fail to return data

## How this service works

Commodities brief for macro and FX agents — gold, silver, WTI/Brent crude, natural gas and copper, with the cross-asset read into commodity-linked currencies (CAD, AUD, NOK).

## Output

A structured commodities brief covering spot or near-term prices and directional moves for gold, silver, WTI crude, Brent crude, natural gas, and copper, along with analysis of how those moves are influencing forex pairs and broader currency market sentiment.

## Example request

```json
{
 "session": "newyork"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lang": {
       "type": "string",
       "description": "e.g. en, es, fr, de, ja, zh, ko, pt, ar (default: en; not strictly validated — any language is forwarded to the model)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "errors": {
     "type": "object",
     "description": "Documented error responses, keyed by HTTP status code",
     "additionalProperties": {
      "type": "object",
      "required": [
       "description"
      ],
      "properties": {
       "example": {
        "type": "object"
       },
       "description": {
        "type": "string"
       }
      }
     }
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "corn": 485,
  "wheat": 620,
  "copper": 4.52,
  "regime": "risk-off — USD strength weighing on commodities",
  "nat_gas": 2.84,
  "oil_wti": 78.2,
  "gold_usd": 2387.4,
  "oil_brent": 82.1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macropulse-commodities-pulse-95866108/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from macropulse-alpha.vercel.app](https://www.zero.xyz/host/macropulse-alpha.vercel.app/llms.txt)
