Documentation

Authenticate with Authorization: Bearer cot_live_… or x-api-key. Every JSON response includes source, as_of, and methodology_url.

REST

• GET /api/v1/markets — list markets
• GET /api/v1/cot/{market} — series (from, to, limit)
• GET /api/v1/cot/{market}/latest — latest observation
• GET /api/v1/cot/{market}/export — CSV (Pro+)

MCP

GET /api/mcp lists tools. POST /api/mcp with { "method": "tools/call", "params": { "name": "get_cot_latest", "arguments": { "market": "gold" } } }.

Tools: list_markets, get_cot_latest, get_cot_series.

Example

curl -s \
  -H "Authorization: Bearer $COTLY_API_KEY" \
  https://YOUR_HOST/api/v1/cot/gold/latest

Methodology →