# MacroPulse COT Brief

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

Returns a CFTC Commitments of Traders positioning brief covering institutional futures positioning across 7 major currency pairs, gold, and WTI crude oil

## Facts

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

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-cot-brief-ad0e6384
```

Example prompt: Pull the latest MacroPulse COT brief so I can see where institutions are positioned across the major currency pairs, gold, and WTI right now.

## When to prefer this

Use this endpoint when you need a synthesized, human-readable COT positioning brief across multiple currency pairs and commodities in a single call, rather than parsing raw CFTC CSV files or querying individual instruments. Best for forex traders who want to quickly assess institutional sentiment and positioning bias across the G10 FX complex plus gold and WTI.

## Known failure modes

- CFTC source data not yet updated for the current week — may return prior week's data
- Payment of $0.15 USDC not received or x402 payment flow failed — returns 402 Payment Required
- Upstream data provider unavailable — returns 5xx error
- Rate limiting or server error from Vercel hosting — returns 503

## How this service works

CFTC Commitment-of-Traders positioning for FX and commodity agents — institutional net positioning and weekly shifts across 7 major pairs plus gold and WTI, with crowding and contrarian signals.

## Output

A structured brief summarizing CFTC Commitments of Traders data across 7 major currency pairs (e.g. EUR/USD, GBP/USD, USD/JPY, AUD/USD, etc.) plus gold and WTI crude oil futures, including net institutional positioning, directional bias, and notable changes in speculator positioning.

## 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": {
      "group": {
       "type": "string",
       "description": "Optional comma-separated filter: fx, commodities, grains, financials. Omit or \"all\" for everything."
      }
     }
    }
   },
   "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": {
  "pair": "EURUSD",
  "signal": "Institutional positioning favours further EUR weakness",
  "direction": "SHORT",
  "change_week": -3100,
  "extreme_reading": false,
  "net_speculative": -45200
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macropulse-cot-brief-ad0e6384/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)