Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

REST API

Uma REST API é uma API construída no estilo REST (Representational State Transfer): cada conjunto de dados é um recurso com sua própria URL, o método HTTP define a ação e o servidor não guarda o estado do cliente entre as requisições. Roy Fielding descreveu esse estilo em sua tese de doutorado, em 2000.

Anatomia de uma requisição

Uma requisição das taxas de funding do BTC em todas as exchanges:

curl "https://api.genesisarbitrage.com/v1/funding/rates?coin=BTC" \
  -H "X-API-Key: $GENESIS_API_KEY"
ParteValorSignificado
MétodoGETLer dados
URL basehttps://api.genesisarbitrage.com/v1Servidor e versão da API
Recurso/funding/ratesTaxas de funding das exchanges
Parâmetrocoin=BTCSomente BTC
CabeçalhoX-API-KeyChave do cliente

A resposta é JSON: data traz o BTC com uma lista de exchanges, cada uma com a taxa por intervalo de funding (funding_pct) e a taxa normalizada para 8 horas (funding_8h_pct). Sem coin, o mesmo recurso devolve todas as moedas. Os campos estão descritos na seção Taxas de funding.

Métodos e estado

O método diz ao servidor o que fazer com o recurso. A semântica dos métodos é definida pelo padrão HTTP, RFC 9110:

A Genesis API só entrega dados, então todos os seus endpoints são GET.

Stateless (sem estado) significa que cada requisição carrega tudo de que precisa: chave, recurso, filtros. O servidor não lembra chamadas anteriores e o GET não altera nada, então a requisição pode ser repetida após um timeout ou um 503: o resultado depende só da própria requisição e dos dados atuais. Para não baixar de novo dados que não mudaram, a Genesis API envia um ETag: uma requisição com If-None-Match recebe 304 quando nada mudou.

REST e WebSocket

REST APIWebSocket
InteraçãoRequisição e respostaFluxo de mensagens nos dois sentidos
Quem iniciaO clienteQualquer um dos lados, depois de conectado
Indicado paraRetratos dos dados, filtros, históricoFluxos de negociações e de order book
Na Genesis APITodos os endpointsNão

Com REST, as atualizações vêm por polling: o programa repete a requisição em um intervalo. A Genesis API atualiza sua saída a cada meta.freshness_sec segundos, de 60 no Trial a 5 no Max, então consultar mais rápido não adianta.

Veja também: endpoint, WebSocket, formato de resposta, lição: sua primeira requisição a uma API com HTTP, cabeçalhos e JSON.

Perguntas e respostas

Qual a diferença entre uma REST API e uma API em geral?

API é qualquer conjunto de regras pelo qual programas se comunicam. Uma REST API é um caso específico sobre HTTP: recursos em URLs, métodos padrão e requisições que não dependem das anteriores.

Em que formato uma REST API responde?

O REST não fixa um formato: pode ser JSON, XML ou outro tipo. A Genesis API responde em JSON com compressão gzip.