Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

API

Uma API (interface de programação de aplicações) é um conjunto de regras pelas quais um programa pede dados ou uma ação a outro: qual URL chamar, o que enviar e em que formato a resposta chega. O trader precisa de uma API quando preços, order books e taxas de financiamento (funding) devem ser lidos por um programa: um bot, uma planilha ou um painel.

Exemplo de requisição

Exemplo hipotético: um programa pede à Genesis API o perfil da moeda IRYS por Busca de moedas, um endpoint da API. A requisição é um HTTP GET, com a chave em um cabeçalho:

curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
  -H "X-API-Key: $GENESIS_API_KEY"

A resposta vem em JSON, com alguns campos omitidos:

{
  "coin": "IRYS",
  "contracts": [
    {
      "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
      "network": "BNB Smart Chain(BEP20)",
      "exchanges": ["MEXC", "Ourbit"]
    }
  ],
  "exchanges": {
    "MEXC": {
      "spot_price": 0.01329,
      "futures_price": 0.0133,
      "deposit": true,
      "withdraw": true
    }
  }
}

Uma pessoa precisaria juntar esses dados a partir das páginas das exchanges e de um explorador de blocos; um programa os recebe em uma única resposta e calcula na hora que os futuros da MEXC negociam acima do spot em (0,0133 − 0,01329) / 0,01329 × 100 ≈ 0,075%.

APIs públicas e privadas de exchanges

A API de uma exchange tem duas partes. A parte pública entrega dados de mercado (cotações, order books, negociações) sem chave. A parte privada trabalha com a sua conta (saldos, ordens, histórico) e exige uma chave de API e a assinatura da requisição. Na Binance, os endpoints públicos têm o tipo de segurança NONE; todos os demais exigem uma chave e o parâmetro signature.

Os dados chegam de duas formas. Uma REST API responde a cada requisição separadamente: assim você obtém um retrato dos dados com os filtros de que precisa. Um WebSocket mantém a conexão aberta e o servidor envia as atualizações por conta própria: é assim que a Binance transmite negociações e mudanças do order book em tempo real.

APIs de dados: várias plataformas em uma resposta

A API de uma exchange conhece apenas a própria plataforma. Para comparar o preço de uma moeda em 20 exchanges, um programa precisa de 20 conexões, e cada exchange tem seu formato de resposta e seus limites. Uma API de dados reúne as plataformas de antemão.

Tipo de APIO que devolveAcesso
API pública de exchangeCotações, order books e negociações de uma exchangeSem chave
API privada de exchangeSaldos, ordens, saquesChave e assinatura
Genesis APISpreads, order books, funding, DEX, on-chain, mercados de previsãoChave, somente leitura

Uma requisição ao endpoint /arbitrage/spot-spot da Genesis API devolve os spreads calculados entre os mercados spot de mais de 20 exchanges CEX, com flags de depósito e saque. Toda requisição é um HTTP GET, toda resposta é JSON, e os parâmetros e campos de cada endpoint estão na documentação.

Veja também: API de criptomoedas: tipos e como escolher, início rápido na documentação, rate limit, lição: o que é uma API de criptomoedas.

Perguntas e respostas

Preciso de um SDK para trabalhar com uma API?

Se a API fala HTTP, qualquer cliente HTTP serve. Para a Genesis API, bastam o curl, o requests do Python ou o fetch nativo do JavaScript.

Posso operar pela Genesis API?

Não. A Genesis API só entrega dados. As ordens são colocadas na exchange, manualmente ou pela API da própria exchange com a chave dela, por sua conta e risco.