Commitments of Traders da CFTC

Commitments of Traders da CFTC (futuros de bitcoin / ether da CME)

GET/api/cftc/cot

Série anterior e mais curta. `/api/sd/cme/cot` traz o histórico completo da CFTC por classe de trader, com seleção de unidade.

Requisição

Parâmetros de consulta

Nome	Tipo	Obrigatório	Padrão	Valores aceitos	Descrição
currency	string	Opcional	BTC	BTC, ETH	Ativo subjacente; qualquer valor diferente de ETH é tratado como BTC. Exemplo: BTC

Exemplo de requisição

curl -s "https://www.coinboss.com/api/cftc/cot?currency=BTC"

Campos da resposta

A tabela de campos é gerada a partir de respostas reais, portanto lista exatamente o que o endpoint retorna. Os caminhos usam a[] para itens de array e {*} para objetos indexados por um nome dinâmico, como uma moeda ou uma corretora.

Campo	Tipo	Unidade	Descrição
success	boolean	—	true quando a requisição foi bem-sucedida. Em caso de falha, o corpo é `{ success: false, code, error, request_id }`.
currency	string	—	Símbolo da moeda / do ativo.
contract	string	—	Nome e tamanho do contrato futuro da CME coberto pelo relatório (`CME Bitcoin Futures (5 BTC)` ou `CME Ether Futures (50 ETH)`).
report_date	string	—	Data de referência (YYYY-MM-DD, uma terça-feira) do relatório Commitments of Traders da CFTC mais recente em `series`; publicado na sexta-feira seguinte.
fetched_at	number	ms	Quando a CoinBoss obteve os dados da fonte.
latest	object	—	Registro mais recente.
latest.date	string	—	Data do calendário (UTC).
latest.oi	number	—	Contratos em aberto.
latest.dealer_long	number	—	Relatório da CFTC: posições long de dealers.
latest.dealer_short	number	—	Relatório da CFTC: posições short de dealers.
latest.am_long	number	—	Relatório da CFTC: posições long de gestores de ativos.
latest.am_short	number	—	Relatório da CFTC: posições short de gestores de ativos.
latest.lev_long	number	—	Relatório da CFTC: posições long de fundos alavancados.
latest.lev_short	number	—	Relatório da CFTC: posições short de fundos alavancados.
latest.other_long	number	—	Relatório da CFTC: posições long de outros reportáveis.
latest.other_short	number	—	Relatório da CFTC: posições short de outros reportáveis.
latest.nonrept_long	number	—	Relatório da CFTC: posições long de não reportáveis.
latest.nonrept_short	number	—	Relatório da CFTC: posições short de não reportáveis.
latest.traders	number	—	Número de traders.
prev	object	—	Valor anterior (linha de base).
prev.date	string	—	Data do calendário (UTC).
prev.oi	number	—	Contratos em aberto.
prev.dealer_long	number	—	Relatório da CFTC: posições long de dealers.
prev.dealer_short	number	—	Relatório da CFTC: posições short de dealers.
prev.am_long	number	—	Relatório da CFTC: posições long de gestores de ativos.
prev.am_short	number	—	Relatório da CFTC: posições short de gestores de ativos.
prev.lev_long	number	—	Relatório da CFTC: posições long de fundos alavancados.
prev.lev_short	number	—	Relatório da CFTC: posições short de fundos alavancados.
prev.other_long	number	—	Relatório da CFTC: posições long de outros reportáveis.
prev.other_short	number	—	Relatório da CFTC: posições short de outros reportáveis.
prev.nonrept_long	number	—	Relatório da CFTC: posições long de não reportáveis.
prev.nonrept_short	number	—	Relatório da CFTC: posições short de não reportáveis.
prev.traders	number	—	Número de traders.
series	array	—	Série temporal.
series[]	object	—	Série temporal.
series[].date	string	—	Data do calendário (UTC).
series[].oi	number	—	Contratos em aberto.
series[].dealer_long	number	—	Relatório da CFTC: posições long de dealers.
series[].dealer_short	number	—	Relatório da CFTC: posições short de dealers.
series[].am_long	number	—	Relatório da CFTC: posições long de gestores de ativos.
series[].am_short	number	—	Relatório da CFTC: posições short de gestores de ativos.
series[].lev_long	number	—	Relatório da CFTC: posições long de fundos alavancados.
series[].lev_short	number	—	Relatório da CFTC: posições short de fundos alavancados.
series[].other_long	number	—	Relatório da CFTC: posições long de outros reportáveis.
series[].other_short	number	—	Relatório da CFTC: posições short de outros reportáveis.
series[].nonrept_long	number	—	Relatório da CFTC: posições long de não reportáveis.
series[].nonrept_short	number	—	Relatório da CFTC: posições short de não reportáveis.
series[].traders	number	—	Número de traders.

Gerada 2026-11-11 23:00 UTC a partir de 1 respostas reais.

Exemplo de resposta

/api/cftc/cot?currency=BTC · Resposta real capturada 2026-11-13 03:58:26 UTC. Arrays e mapas longos são encurtados para exibição: series tinha 448 itens.

{
- "success": true,
- "currency": "BTC",
- "contract": "CME Bitcoin Futures (5 BTC)",
- "report_date": "2026-11-03",
- "fetched_at": 1794536904404,
- "latest": {
  - "date": "2026-11-03",
  - "oi": 17527,
  - "dealer_long": 6027,
  - "dealer_short": 5548,
  - "am_long": 4379,
  - "am_short": 1976,
  - "lev_long": 5114,
  - "lev_short": 7705,
  - "other_long": 124,
  - "other_short": 308,
  - "nonrept_long": 762,
  - "nonrept_short": 869,
  - "traders": 105
  },
- "prev": {
  - "date": "2026-10-27",
  - "oi": 20791,
  - "dealer_long": 6257,
  - "dealer_short": 5001,
  - "am_long": 4743,
  - "am_short": 1989,
  - "lev_long": 5887,
  - "lev_short": 9866,
  - "other_long": 94,
  - "other_short": 285,
  - "nonrept_long": 1002,
  - "nonrept_short": 842,
  - "traders": 106
  },
- "series": [
  - { … 13 },
  - { … 13 }
  ]
}

Detalhes

Autenticação: Nenhuma. Endpoint público.
Limite de requisições: 1200 requisições por minuto por IP
Cache do servidor: 10m
Microcache de borda: 10s
Frequência de atualização: sob demanda, em cache por 6 horas; o relatório é semanal (posições de terça-feira, publicadas na sexta-feira)
Janela: histórico semanal completo
Fontes de dados: Posicionamento em futuros de Bitcoin e Ether da CME por categoria de trader, a partir dos dados abertos oficiais do Commitments of Traders da CFTC.
Cobertura de corretoras: `currency` = BTC (padrão) ou ETH; somente contratos CME padrão (microcontratos não incluídos); categorias: dealers, gestores de ativos, fundos alavancados, outros reportáveis, não reportáveis.
Ordenação: data do relatório crescente
Unidades: contracts (CME Bitcoin = 5 BTC, CME Ether = 50 ETH per contract)
Timestamps: Milissegundos da época Unix (UTC), salvo se a descrição do campo indicar o contrário
Formato da resposta: json
Estabilidade: Estável

Status ao vivo

DisponívelVerificado 2026-11-13 03:58:26 UTCHTTP 2007 msEsquema confereDado mais recente: há 10.2d

Disponibilidade, últimos 30 dias

100% de 409 verificações aprovadas

Erros

As chamadas com falha têm o mesmo formato em todos os endpoints. A lista completa está na página de erros. Erros e limites de requisições →

Código	HTTP	Significado	O que fazer
INVALID_PARAM	400	Falta um parâmetro obrigatório ou um valor não é aceito. `param` indica o nome do parâmetro quando ele é conhecido.	Não repita a requisição sem alterações; corrija-a.
UNAUTHORIZED	401	O cabeçalho `CB-API-KEY` foi enviado, mas a chave é desconhecida ou foi revogada. Dados públicos não exigem chave — remova o cabeçalho ou use uma chave válida.	Não repita a requisição sem alterações.
FORBIDDEN	403	A rota não faz parte da API pública (é interna ou exclusiva de conta).	Não tente novamente.
NOT_FOUND	404	Rota desconhecida, ou a moeda / corretora / fundo solicitado não existe.	Não tente novamente; confira o caminho e os identificadores no catálogo.
RATE_LIMITED	429	Mais requisições do que o limite por minuto. `Retry-After` informa os segundos a aguardar.	Aguarde `Retry-After` e então tente novamente com backoff.
INTERNAL	500	Erro inesperado do servidor. A mensagem é genérica de propósito; cite `request_id` ao reportá-lo.	Tente novamente uma vez após alguns segundos; se persistir, reporte-o com o ID da requisição.
UPSTREAM_FAILED	503	A fonte de dados por trás deste endpoint não respondeu a tempo. Nenhum número desatualizado ou substituto é retornado em seu lugar.	Tente novamente com backoff; consulte a página de status.
UNAVAILABLE	501 / 503	O conjunto de dados ainda não está pronto temporariamente (aquecimento do cache) ou o endpoint ainda não tem uma fonte pública lícita.	Tente novamente mais tarde; o catálogo marca os endpoints que são indisponíveis por design.
REQUEST_FAILED	200	Alguns endpoints mais antigos respondem HTTP 200 com `success: false`. Verifique sempre `success`, não apenas o status HTTP.	Depende da mensagem; trate como uma requisição com falha.

Experimente

GET/api/cftc/cotDisponível

Parâmetros

currency

string · padrão BTC — Underlying; anything other than ETH is BTC.

URL da requisiçãohttps://www.coinboss.com/api/cftc/cot?currency=BTC

Escolha um endpoint e clique em “Enviar requisição”. A resposta, os cabeçalhos e o tempo de resposta aparecerão aqui.

Posicionamento da CFTC (futuros cripto da CME) /api/sd/cme/cot
Visão geral dos futuros da CME /api/sd/cme/overview
Commitments of Traders da CFTC /api/cftc/cot