Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

Chave de API

Uma chave de API é uma string longa e aleatória pela qual um serviço sabe quem enviou uma requisição: de qual conta ela é, em que plano está e quais dados pode receber. Para um programa, a chave funciona como uma senha: quem conhece a string age em nome do dono.

Como a chave é enviada

A chave viaja em um cabeçalho de cada requisição, enquanto os filtros vão na URL. Na Genesis API o cabeçalho é X-API-Key e a chave tem a forma gns_live_…. O exemplo pede os sinais alpha classificados de Sinais de IA:

import os
import requests

key = os.environ.get("GENESIS_API_KEY")
if not key:
    raise SystemExit("defina GENESIS_API_KEY no servidor")

r = requests.get(
    "https://api.genesisarbitrage.com/v1/ai/signals",
    headers={"X-API-Key": key},  # a chave vai somente no cabeçalho
    params={"category": "alpha"},  # os filtros vão na URL
    timeout=10,
)
if r.status_code == 401:
    # a chave está ausente, é inválida ou foi revogada
    print(r.json()["error"]["code"])  # invalid_key
elif r.ok:
    print("sinais alpha:", r.json()["meta"]["count"])

Usa-se um cabeçalho porque a URL da requisição, com a query string, vai parar nos logs do servidor web e dos proxies, e no histórico do navegador se alguém a abrir nele. A documentação da Genesis API é direta: nunca passe a chave nos parâmetros de consulta, nunca a embuta no código de um site ou aplicativo e faça as requisições apenas do seu próprio servidor. As exchanges funcionam igual: a Binance recebe a chave no cabeçalho X-MBX-APIKEY, e as requisições de conta também são assinadas com uma segunda chave, o API secret.

Como guardar a chave

Chave de exchange e chave da Genesis API

Chave de exchangeChave da Genesis API
PermissõesLer, operar, sacar: o que você ativarSomente leitura de dados
Um vazamento expõeNegociações e saques da sua contaSua cota de chamadas
ProteçãoSem saques, lista de IPs permitidosReemissão no seu perfil

A chave da Genesis API é somente leitura: não pode colocar ordens nem sacar dinheiro. Os erros de chave e seus códigos estão nas seções Autenticação e Erros.

Veja também: API, endpoint, rate limit, chave de API: obter, guardar, reemitir e revogar.

Perguntas e respostas

Posso criar várias chaves da Genesis API?

Não, a conta tem uma única chave. «Reemitir» entrega uma chave nova e desativa a antiga imediatamente.

Onde obtenho uma chave da Genesis API?

No seu perfil, no bloco «Genesis API», depois de pagar um plano de API. O botão «Obter chave» abre a janela «Sua chave de API» com um botão «Copiar».