Skip to content
Get started
COT
  1. REST reference
  2. Market context
  3. COT

Get the COT summary

GET/public/v1/cot/summary

The latest report for every tracked contract, one summary each.

PremiumAnnualLifetimeNo on-demand analysis

Request

curl "https://api.tradeeasyai.net/public/v1/cot/summary" \
  -H "X-API-Key: $TRADEEASY_API_KEY"

Response shape

Field names and types; no sample values.

200 · application/json
{
  "success": true,
  "data": {
    "summaries": [ … ],
    "count": "<integer>"
  },
  "meta": { "timestamp": "<string>", "request_id": "<string>" }
}

Parameters#

No parameters.

Response fields#

  • summaries[]array

    One per contract: symbol, report date and the group nets.

  • countinteger

    Number of contracts.

Errors#

  • 401detail

    Missing, invalid or revoked key, or a locked account. FastAPI {"detail": …} body, not the envelope.

  • 403detail

    The plan does not include the REST API, or the subscription is not active.

  • 429RATE_LIMIT_EXCEEDED

    Per-key minute or day bucket spent. Honour Retry-After.

  • 500FETCH_FAILED

    The summary could not be read. Retry with backoff.

Educational market research, not investment advice; not for fully automated trade execution. Questions about the API or the MCP server: support@tradeeasyai.net.