Quem já escreveu robô sabe qual é o problema: a biblioteca que fala com a corretora quebra sozinha, num dia qualquer, sem aviso — e o robô morre até alguém consertar. Esta API é a mesma fonte de dados que sustenta o Binaryzando há mais de dois anos. Você não paga por um endpoint; paga por não ser você quem conserta.
Sua chave
Carregando…
O que ela é — e o que ela não é
Isto não é letra miúda, é o desenho do produto. Ele está escrito aqui em cima justamente pra ninguém assinar esperando outra coisa.
✅ O que a API faz
- Entrega velas históricas (OHLC) por par e timeframe.
- Lista os ativos que realmente têm dado, lidos do banco — não uma lista fixa que envelhece.
- Marca quais são OTC.
- Continua respondendo quando a corretora muda do lado de lá. Essa é a assinatura.
⛔ O que a API não faz
- Não executa ordem. Nenhuma rota compra, vende ou opera.
- Não recebe sua senha de corretora. Não existe campo pra isso, de propósito.
- Não é sinal, não é indicação de entrada e não promete resultado.
- Quem opera é o seu robô, na sua máquina, na sua conta.
A decisão de a API ser somente leitura é deliberada: no dia em que ela recebesse credencial de corretora de terceiro, o problema deixaria de ser técnico e passaria a ser a sua conta na mão de outra pessoa. Preferimos não ter esse poder.
Como chamar
Base: https://api.binaryzando.com · Autenticação: cabeçalho
X-API-Key (ou ?chave= na URL, pra teste rápido).
Todos os horários são timestamp Unix em UTC.
Cota: 5.000 chamadas por dia por chave.
Velas de um par/timeframe, em ordem cronológica.
| Parâmetro | Obrigatório | O que é |
|---|---|---|
| par | sim | Nome do par exatamente como sai em /api/v1/ativos. |
| tf | sim | M1, M5 ou M15. |
| n | não | Quantas velas (padrão 100, teto 1000). Devolve as mais recentes da janela. |
| desde / ate | não | Recorta a janela por timestamp de abertura da vela. |
curl -H "X-API-Key: SUA_CHAVE" \
"https://api.binaryzando.com/api/v1/candles?par=EURUSD-op&tf=M5&n=3"
{
"success": true, "par": "EURUSD-op", "tf": "M5", "total": 3,
"velas": [
{"ts": 1785312000, "open": 1.0990, "high": 1.1004, "low": 1.0987, "close": 1.1000}
]
}
Os pares que têm vela no banco agora, com OTC marcado, e os timeframes disponíveis.
{"success": true, "total": 244,
"ativos": [{"par": "EURUSD-op", "otc": false}, {"par": "EURUSD-OTC", "otc": true}],
"timeframes": ["M1", "M15", "M5"]}
Quanto da cota do dia já foi gasto. Consultar não gasta cota — se gastasse, você evitaria consultar e descobriria o limite só batendo nele.
{"success": true, "cota_dia": 5000, "usadas": 132, "restantes": 4868}
Códigos de resposta
| Código | O que significa |
|---|---|
| 200 | Deu certo. |
| 400 | Parâmetro faltando ou inválido — a mensagem diz qual. |
| 401 | Chave inválida, inativa ou ausente. |
| 404 | Não existe vela pra esse par/timeframe/período. Nunca devolvemos vela inventada pra preencher buraco. |
| 429 | Cota do dia esgotada. A chave continua boa; volta à meia-noite (UTC−3). |
Exemplo em Python
import requests
BASE = "https://api.binaryzando.com"
CHAVE = "SUA_CHAVE"
r = requests.get(BASE + "/api/v1/candles",
headers={"X-API-Key": CHAVE},
params={"par": "EURUSD-op", "tf": "M5", "n": 100})
r.raise_for_status()
for vela in r.json()["velas"]:
print(vela["ts"], vela["close"])
O combinado, por escrito
- Se manter esta API virar trabalho demais, ela é descontinuada — e nesse dia você é avisado com 60 dias de antecedência, a parte não usada do plano anual volta, e o código vira aberto. Está escrito antes de começar de propósito: escrito depois seria desculpa.
- A chave é sua e vale enquanto a assinatura estiver ativa. Cancelou, ela para — nada é cobrado depois disso.
- Dado de mercado é histórico do passado. Nada aqui prevê preço nem garante resultado, e operar opções binárias envolve risco de perder o valor aplicado. Leia o aviso de risco.
- Quer a resposta pronta em vez das velas cruas — win/loss conferido, atraso do relógio medido? Isso são as peças pro seu robô.