Skip to main content

​
📖 Descrição

Retorna o detalhe da operação SPOT x FUTURE para um ticker (e opcionalmente exchange e data): série temporal de preço spot e preço futuro no dia e a quantidade de cruzamentos de preço entre as duas linhas. Útil para a página de detalhe e gráfico de preços Spot x Future.

​
🛠️ Requisição

​
Método

GET

​
URL

/v1/arbitrage/future/detail

​
Parâmetros de Query

ParâmetroTipoObrigatórioDescrição
tickerstringSimTicker do par (ex: “RBNT_USDT”, “RVNBTC”)
datestringNãoData no formato YYYY-MM-DD. Se omitido, usa o dia atual (America/Sao_Paulo)
exchangestringNãoNome da exchange para filtrar operações (ex: “Binance”, “MEXC”)

​
Exemplo de Requisição

Apenas ticker (dia atual): 
curl --location 'localhost:8080/v1/arbitrage/future/detail?ticker=RBNT_USDT'
Com data e exchange: 
curl --location 'localhost:8080/v1/arbitrage/future/detail?ticker=RVNBTC&date=2026-02-25&exchange=Binance'

​
📤 Resposta

​
Exemplo de Resposta

{
    "ticker": "RVNBTC",
    "date": "2026-02-25",
    "dataPoints": [
        {
            "timestamp": 1737813600000,
            "spotPrice": 0.52,
            "futurePrice": 0.51
        },
        {
            "timestamp": 1737824400000,
            "spotPrice": 0.53,
            "futurePrice": 0.54
        }
    ],
    "crossingCount": 2
}

​
Campos da Resposta

CampoTipoDescrição
tickerstringTicker consultado
datestringData dos dados (YYYY-MM-DD)
dataPointsarrayLista de pontos no tempo, ordenados por timestamp (milissegundos)
dataPoints[].timestampnumberUnix timestamp em milissegundos
dataPoints[].spotPricenumberPreço spot no momento
dataPoints[].futurePricenumberPreço futuro no momento
crossingCountnumberQuantidade de cruzamentos de preço (spot x future) no período

​
📝 Notas

Comportamento:
  • Os dados são gerados a partir de todas as operações SPOT x FUTURE persistidas para o ticker (e exchange, se informada) na data indicada.
  • crossingCount é a quantidade de vezes em que as linhas de preço spot e futuro se cruzam ao longo do dia (mudança de sinal de spotPrice - futurePrice entre pontos consecutivos).
  • Se não houver operações na data, dataPoints virá vazio e crossingCount será 0.
Erros comuns:
  • 400: parâmetro ticker ausente ou vazio.
  • 500: erro interno (ex.: falha na base de dados ou parsing de data).