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 API | O que devolve | Acesso |
|---|---|---|
| API pública de exchange | Cotações, order books e negociações de uma exchange | Sem chave |
| API privada de exchange | Saldos, ordens, saques | Chave e assinatura |
| Genesis API | Spreads, order books, funding, DEX, on-chain, mercados de previsão | Chave, 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.