Get Future Arbitrage Detail (Spot x Future)

📖 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âmetro	Tipo	Obrigatório	Descrição
`ticker`	string	Sim	Ticker do par (ex: “RBNT_USDT”, “RVNBTC”)
`date`	string	Não	Data no formato YYYY-MM-DD. Se omitido, usa o dia atual (America/Sao_Paulo)
`exchange`	string	Não	Nome 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

Campo	Tipo	Descrição
`ticker`	string	Ticker consultado
`date`	string	Data dos dados (YYYY-MM-DD)
`dataPoints`	array	Lista de pontos no tempo, ordenados por `timestamp` (milissegundos)
`dataPoints[].timestamp`	number	Unix timestamp em milissegundos
`dataPoints[].spotPrice`	number	Preço spot no momento
`dataPoints[].futurePrice`	number	Preço futuro no momento
`crossingCount`	number	Quantidade 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).

API Documentation

Endpoint Examples

Get Future Arbitrage Detail (Spot x Future)

📖 Descrição

🛠️ Requisição

Método

URL

Parâmetros de Query

Exemplo de Requisição

📤 Resposta

Exemplo de Resposta

Campos da Resposta

📝 Notas

​📖 Descrição

​🛠️ Requisição

​Método

​URL

​Parâmetros de Query

​Exemplo de Requisição

​📤 Resposta

​Exemplo de Resposta

​Campos da Resposta

​📝 Notas

📖 Descrição

🛠️ Requisição

Método

URL

Parâmetros de Query

Exemplo de Requisição

📤 Resposta

Exemplo de Resposta

Campos da Resposta

📝 Notas