# Nimatron COT Market Data

> Nimatron COT Market Data is a paid API for AI agents from api.nimatron.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-11).

Returns structured CFTC Commitment of Traders positioning data for a single market, including longs/shorts/net, week-over-week changes, percent of open interest, 52-week COT index, percentile, extremes flag, and a plain-English summary.

## Facts

- Endpoint: GET https://api.nimatron.com/v1/cot/market?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nimatron-cot-market-data-9465965a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ejfYihvqBsEycgGg6R6T3

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 nimatron-cot-market-data-9465965a
```

Example prompt: Pull the latest CFTC Commitment of Traders data for GOLD — I want to see where managed money is positioned, their net change from last week, and whether we're at a 52-week extreme.

## When to prefer this

Use this endpoint when you need detailed, structured COT positioning data for a specific futures market, including historical context via the 52-week COT index and percentile. Prefer this over the sibling 'extremes scan' endpoint when you already know which market you want to analyze, rather than scanning all 438 markets for positioning extremes. Ideal for macro research, systematic trading signals, or any workflow requiring per-market speculator positioning with enriched context.

## Known failure modes

- Market not found if the query string does not match any of the 438 tracked markets — returns empty or error response
- Stale data if queried before the Friday CFTC release has been processed
- Ambiguous query matching multiple markets — may return the closest match or require a more specific substring
- Rate limiting or payment failure if x402 payment is not properly handled
- Typos in the market name query causing no results

## How this service works

CFTC Commitment of Traders positioning for one market, structured and enriched: producer/swap/managed-money (or dealer/asset-manager/leveraged-funds) longs, shorts, net, week-over-week changes, percent of open interest, plus 52-week COT index, percentile, extremes flag and a plain-English read. 438 markets across energy, metals, ags, softs, FX, rates, equity indexes, crypto. Updated every Friday within hours of CFTC release.

## Output

A structured JSON object containing producer/merchant, swap dealer, and managed money (or dealer/asset manager/leveraged funds) long, short, and net position counts; week-over-week changes; percent of open interest for each category; the 52-week COT index score and percentile rank; an extremes flag indicating if positioning is historically stretched; and a plain-English narrative summary of the current positioning picture. Updated within hours of the CFTC's Friday release.

## 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",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Market name, commodity, or exchange substring, e.g. GOLD, CRUDE, BITCOIN, NASDAQ"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nimatron-cot-market-data-9465965a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nimatron.com](https://www.zero.xyz/host/api.nimatron.com/llms.txt)