Skip to main content

​
📖 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âmetroTipoObrigatórioDescrição
exchangesstringNãoLista de exchanges separadas por vírgula (ex: “Gate.io,Binance”)
strategiesstringNãoLista de estratégias separadas por vírgula (ex: “BUY_SPOT_SELL_FUTURE,SELL_SPOT_BUY_FUTURE”)
spreadPercentagefloatNãoSpread mínimo em percentual
volumeMinfloatNãoVolume 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,
        "created_at": "Agora",
        "timestamp": "2025-07-10T18:43:29Z"
    }
]

​
📝 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.