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
- Guarde a chave em uma variável de ambiente ou em um arquivo
.envno servidor e adicione.envao.gitignore. - Nunca cole a chave no código de um site, em um aplicativo móvel, em um chat ou em uma captura de tela.
- A Genesis API mostra a chave uma única vez e guarda apenas o hash dela: uma chave perdida não pode ser recuperada, só reemitida.
- Se a chave vazar, clique em «Reemitir» no seu perfil e a chave antiga para de funcionar na hora. «Revogar» desativa a chave sem uma substituta.
Chave de exchange e chave da Genesis API
| Chave de exchange | Chave da Genesis API | |
|---|---|---|
| Permissões | Ler, operar, sacar: o que você ativar | Somente leitura de dados |
| Um vazamento expõe | Negociações e saques da sua conta | Sua cota de chamadas |
| Proteção | Sem saques, lista de IPs permitidos | Reemissã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».