> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arbitragem-crypto.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```plaintext theme={null}
/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):

```bash theme={null}
curl --location 'localhost:8080/v1/arbitrage/future/detail?ticker=RBNT_USDT'
```

Com data e exchange:

```bash theme={null}
curl --location 'localhost:8080/v1/arbitrage/future/detail?ticker=RVNBTC&date=2026-02-25&exchange=Binance'
```

***

## 📤 Resposta

### Exemplo de Resposta

```json theme={null}
{
    "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

<Callout type="info">
  **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.
</Callout>

<Callout type="warn">
  **Erros comuns:**

  * `400`: parâmetro `ticker` ausente ou vazio.
  * `500`: erro interno (ex.: falha na base de dados ou parsing de data).
</Callout>