> ## 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

## 📖 Descrição

Este endpoint retorna oportunidades de arbitragem entre mercados spot e futuros, com opção de filtrar por exchanges específicas.

***

## 🛠️ Requisição

### Método

`GET`

### URL

```plaintext theme={null}
/v1/arbitrage/future
```

### Parâmetros de Query

| Parâmetro          | Tipo   | Obrigatório | Descrição                                                                                          |
| ------------------ | ------ | ----------- | -------------------------------------------------------------------------------------------------- |
| `exchanges`        | string | Não         | Lista de exchanges separadas por vírgula (ex: "Gate.io,Binance")                                   |
| `strategies`       | string | Não         | Lista de estratégias separadas por vírgula (ex: "BUY\_SPOT\_SELL\_FUTURE,SELL\_SPOT\_BUY\_FUTURE") |
| `spreadPercentage` | float  | Não         | Spread mínimo em percentual                                                                        |
| `volumeMin`        | float  | Não         | Volume mínimo de operação                                                                          |

### Exemplo de Requisição

Sem filtro de exchanges:

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

Com filtro de exchanges:

```bash theme={null}
curl --location 'localhost:8080/v1/arbitrage/future?exchanges=Gate.io%2CBinance'
```

Com filtros avançados:

```bash theme={null}
curl --location 'localhost:8080/v1/arbitrage/future?exchanges=Binance&strategies=BUY_SPOT_SELL_FUTURE&spreadPercentage=1.5&volumeMin=1000'
```

***

## 📤 Resposta

### Exemplo de Resposta

```json theme={null}
[
    {
        "unique": "687009d11616504625cb20ea",
        "ticker": "RVNBTC",
        "spotPrice": 0,
        "futurePrice": 0,
        "spread": -0,
        "spreadPercentage": -3.34,
        "strategy": "BUY_SPOT_SELL_FUTURE",
        "fundingRate": 0,
        "isProfitable": false,
        "exchange": "Binance",
        "volume": 125000.50,
        "created_at": "Agora",
        "timestamp": "2025-07-10T18:43:29Z"
    }
]
```

***

## 📝 Notas sobre os Parâmetros

<Callout type="info">
  **Parâmetros de Filtro:**

  * **`exchanges`**: Permite filtrar por exchanges específicas. Se omitido, retorna oportunidades de todas as exchanges disponíveis. Múltiplas exchanges devem ser separadas por vírgula.

  * **`strategies`**: Filtra por estratégias de arbitragem. Valores possíveis: `BUY_SPOT_SELL_FUTURE` (Compra SPOT / Vende Future) ou `SELL_SPOT_BUY_FUTURE` (Vende SPOT / Compra Future). Múltiplas estratégias devem ser separadas por vírgula.

  * **`spreadPercentage`**: Filtra oportunidades com spread mínimo em percentual. Apenas oportunidades com spread maior ou igual ao valor informado serão retornadas.

  * **`volumeMin`**: Filtra oportunidades por volume mínimo de operação. Apenas oportunidades com volume maior ou igual ao valor informado serão retornadas.
</Callout>