API v1 · somente leitura

A API do Diário Operebem

Consulte suas operações, estatísticas e análises em JSON. Monte planilhas, painéis e automações com os dados do seu Diário.

Ver documentação Testar o PRO grátis

Somente leitura
Uma chave por conta
Incluída no PRO

curl https://diario.operebem.com.br/api/v1/stats \
  -H "Authorization: Bearer opb_sua_api_key"

import requests

response = requests.get(
    "https://diario.operebem.com.br/api/v1/stats",
    headers={"Authorization": "Bearer " + API_KEY},
)
response.raise_for_status()
print(response.json()["data"])

O que dá para fazer

Do Diário para qualquer lugar

Planilha que se atualiza

Cole o script no Google Sheets e traga trades e estatísticas para a sua própria planilha.

Painel sob medida

Monte gráficos no Looker Studio, Power BI ou no seu próprio site com a curva de patrimônio.

Revisão com IA

Copie a documentação em Markdown para o seu LLM e peça uma revisão das suas operações.

Alertas e automações

Consulte o resumo do dia em um script e receba um aviso quando bater o limite de perda.

Como funciona

Três passos

1
Gere a chave
Em Configurações → API, selecione a conta e crie a API Key. Ela aparece uma única vez.
2
Autentique
Envie a chave no header Authorization: Bearer ou X-API-Key.
3
Consulte
Chame os endpoints na URL base e receba JSON com os dados daquela conta.

Referência

Seis endpoints, todos de leitura

Base URL: https://diario.operebem.com.br/api/v1

GET/accountRetorna a conta vinculada à chave, as estatísticas básicas e o primeiro e o último registro de atividade.

GET/tradesLista as operações da conta com paginação, filtros de ativo, tipo, resultado, período e ordenação.

GET/statsRetorna métricas de trades (profit bruto), sequências, duração e visão financeira da conta. Campos permanecem presentes na conta vazia. profitFactor pode ser o texto Infinity quando há ganho sem perda; currentBalance inclui custos e lançamentos confirmados.

GET/analytics/summaryConsolida métricas básicas, risco, saldo, atividade e, por padrão, performance por dimensão.

GET/analytics/equity-curveRetorna patrimônio, resultado operacional líquido, TWR e seus drawdowns por operação ou período agregado.

GET/analytics/performanceAgrupa o resultado por ativo, dia da semana, hora, sessão ou mês. Sem dimension, retorna todas as dimensões e meta; com dimension, retorna somente a dimensão escolhida.

4requisições por minuto

50requisições por dia (UTC)

100trades por página

Exemplos

Pronto para copiar

Exemplos de requisição e do formato das respostas da API v1.

curl https://diario.operebem.com.br/api/v1/stats \
  -H "Authorization: Bearer opb_sua_api_key"

import requests

response = requests.get(
    "https://diario.operebem.com.br/api/v1/stats",
    headers={"Authorization": "Bearer " + API_KEY},
)
response.raise_for_status()
print(response.json()["data"])

const response = await fetch("https://diario.operebem.com.br/api/v1/stats", {
  headers: { Authorization: "Bearer " + apiKey },
});
if (!response.ok) throw new Error("Falha na consulta");
const { data } = await response.json();
console.log(data);

function consultarEstatisticas() {
  const response = UrlFetchApp.fetch("https://diario.operebem.com.br/api/v1/stats", {
    headers: { Authorization: "Bearer " + API_KEY }
  });
  return JSON.parse(response.getContentText()).data;
}

{
  "success": true,
  "data": {
    "currency": "USD",
    "totalTrades": 3,
    "winningTrades": 1,
    "losingTrades": 1,
    "winRate": 33.33,
    "profitFactor": 4,
    "totalProfit": 15,
    "averageWin": 20,
    "averageLoss": 5,
    "maxWinStreak": 1,
    "maxLossStreak": 1,
    "averageTradeDuration": 600,
    "averageTradeDurationSeconds": 600,
    "averageTradeDurationMinutes": 10,
    "bestDay": {
      "date": "2026-09-06",
      "profit": 15
    },
    "worstDay": {
      "date": "2026-09-06",
      "profit": 15
    },
    "totalDeposits": 0,
    "totalWithdrawals": 0,
    "currentBalance": 1015,
    "netFlow": 0
  }
}

{
  "success": true,
  "data": {
    "trades": [
      {
        "id": "01990000-0000-7000-8000-000000000002",
        "ticket": null,
        "symbol": "ATIVO_EXEMPLO",
        "type": "BUY",
        "volume": 1,
        "openPrice": 10,
        "closePrice": 11,
        "openTime": "2026-09-06T12:00:00.000Z",
        "closeTime": "2026-09-06T12:10:00.000Z",
        "profit": 0,
        "commission": 0,
        "swap": 0,
        "sl": null,
        "tp": null,
        "durationSeconds": 600,
        "profitPercent": null,
        "strategy": null
      },
      {
        "id": "01990000-0000-7000-8000-000000000003",
        "ticket": null,
        "symbol": "ATIVO_EXEMPLO",
        "type": "BUY",
        "volume": 1,
        "openPrice": 10,
        "closePrice": 11,
        "openTime": "2026-09-06T11:00:00.000Z",
        "closeTime": "2026-09-06T11:10:00.000Z",
        "profit": -5,
        "commission": 0,
        "swap": 0,
        "sl": null,
        "tp": null,
        "durationSeconds": 600,
        "profitPercent": null,
        "strategy": null
      },
      {
        "id": "01990000-0000-7000-8000-000000000004",
        "ticket": null,
        "symbol": "ATIVO_EXEMPLO",
        "type": "BUY",
        "volume": 1,
        "openPrice": 10,
        "closePrice": 11,
        "openTime": "2026-09-06T10:00:00.000Z",
        "closeTime": "2026-09-06T10:10:00.000Z",
        "profit": 20,
        "commission": 0,
        "swap": 0,
        "sl": null,
        "tp": null,
        "durationSeconds": 600,
        "profitPercent": null,
        "strategy": null
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 3,
      "totalPages": 1,
      "hasNext": false,
      "hasPrev": false
    }
  }
}

Segurança primeiro

A chave só lê dados da conta a que pertence. Ela nunca aparece de novo depois de criada e pode ser revogada a qualquer momento. Não coloque a chave em URL nem em código público.

Comece a integrar hoje

A API está incluída no PRO. Teste grátis e gere sua chave em minutos.

Testar grátis

Cancele quando quiser. Login único Operebem.