Skip to content
onelayer.
All tools

Tool detail

positioning

Returns CFTC Commitments of Traders weekly futures positioning (managed-money, producer, swap-dealer, open interest) for a chosen commodity.

Categories: Derivatives data, Market prices

Use when

  • check managed-money long/short positioning in gold futures
  • pull historical COT data for silver or copper over a date range
  • compare producer-merchant vs speculator positioning in WTI crude

Not for

  • not real-time price data, weekly CFTC positioning only
  • raw positioning data, not a forecast or trading signal

Inputs

GET query params (all optional): commodity (string, e.g. gold), from/to (date), page (integer, default 1)

Admitted input schema

{
  "type": "object",
  "properties": {
    "commodity": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "examples": [
        "gold"
      ]
    },
    "from": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "format": "date",
      "examples": [
        "2026-01-01"
      ]
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "default": 1,
      "examples": [
        1
      ]
    },
    "to": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "format": "date",
      "examples": [
        "2026-04-30"
      ]
    }
  },
  "required": [],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://thevaultreport.com/api/x402/cot/positioning

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://thevaultreport.com/api/x402/cot/positioning
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z