Skip to main content

​
📖 Descrição

Retorna a quantidade de cruzamentos de preço (spot x future) processada e persistida para um ticker e exchange, somada sobre uma janela móvel dos últimos 7 dias (em vez de acumular indefinidamente todo o histórico). Assim o número reflete a frequência de cruzamento recente e não cresce para sempre. A busca considera apenas registros com crossing_count > 0. O resultado é cacheado por 4 horas para reduzir consultas ao banco. Se não houver registro na janela, retorna crossingCount: 0. O campo spotXFuture indica que o dado se refere ao contexto Spot x Future.

​
🛠️ Requisição

​
Método

GET

​
URL

/v1/arbitrage/future/crossing-count

​
Parâmetros de Query

ParâmetroTipoObrigatórioDescrição
tickerstringSimTicker do par (ex: “RBNT_USDT”)
exchangestringSimNome da exchange (ex: “Binance”)

​
Exemplo de Requisição

curl --location 'localhost:8080/v1/arbitrage/future/crossing-count?ticker=RBNT_USDT&exchange=Binance'

​
📤 Resposta

​
Exemplo de Resposta (registro encontrado)

{
    "ticker": "RBNT_USDT",
    "exchange": "Binance",
    "crossingCount": 5,
    "spotXFuture": true
}

​
Exemplo de Resposta (sem registro)

{
    "ticker": "RBNT_USDT",
    "exchange": "Binance",
    "crossingCount": 0,
    "spotXFuture": true
}

​
Campos da Resposta

CampoTipoDescrição
tickerstringTicker consultado
exchangestringExchange consultada
crossingCountnumberSoma dos cruzamentos nos últimos 7 dias (0 se não houver registro com crossing_count > 0 na janela)
spotXFuturebooleanSempre true; indica que o dado é do contexto Spot x Future

​
📝 Notas

Comportamento:
  • A consulta usa a coleção spot_future_crossing_counts, com filtro ticker, exchange, crossing_count > 0 e processing_date dentro dos últimos 7 dias. Os crossing_count dos registros na janela são somados (a janela é controlada pela constante CrossingCountWindowDays no back-end).
  • O resultado é cacheado por 4 horas (em memória ou Redis, conforme configuração). Após esse período, a próxima requisição consulta o banco novamente.
  • Os dados são gerados pelo endpoint POST /v1/arbitrage/future/crossing-counts, que processa as operações do dia e persiste as contagens.
Erros comuns:
  • 400: parâmetro ticker ou exchange ausente ou vazio.
  • 500: erro interno (ex.: falha na base de dados ou no cache).