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

/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:

curl --location 'localhost:8080/v1/arbitrage/future'

Com filtro de exchanges:

curl --location 'localhost:8080/v1/arbitrage/future?exchanges=Gate.io%2CBinance'

Com filtros avançados:

curl --location 'localhost:8080/v1/arbitrage/future?exchanges=Binance&strategies=BUY_SPOT_SELL_FUTURE&spreadPercentage=1.5&volumeMin=1000'

📤 Resposta

Exemplo de Resposta

[
    {
        "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,
        "crossingCount": 5,
        "created_at": "Agora",
        "timestamp": "2025-07-10T18:43:29Z"
    }
]

Campo `crossingCount`

Cada item traz crossingCount: a soma dos cruzamentos de preço spot x future do par (ticker, exchange) nos últimos 7 dias, o mesmo valor de Get Crossing Count. Vale 0 quando não há registro na janela. As contagens vêm de uma única agregação na coleção spot_future_crossing_counts, guardada em memória por 4 horas e invalidada quando o processamento de Process Crossing Counts termina. Se a agregação falhar, a lista é retornada mesmo assim, com crossingCount: 0. Assim o front não precisa de uma requisição por linha, que estourava o rate limit (429).

📝 Notas sobre os Parâmetros

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.

API Documentation

Endpoint Examples

📖 Descrição

🛠️ Requisição

Método

URL

Parâmetros de Query

Exemplo de Requisição

📤 Resposta

Exemplo de Resposta

Campo `crossingCount`

📝 Notas sobre os Parâmetros

​📖 Descrição

​🛠️ Requisição

​Método

​URL

​Parâmetros de Query

​Exemplo de Requisição

​📤 Resposta

​Exemplo de Resposta

​Campo crossingCount

​📝 Notas sobre os Parâmetros

📖 Descrição

🛠️ Requisição

Método

URL

Parâmetros de Query

Exemplo de Requisição

📤 Resposta

Exemplo de Resposta

Campo `crossingCount`

📝 Notas sobre os Parâmetros