API para desenvolvedores

Os dados das ferramentas em JSON, para ler nos seus programas, nos seus scripts ou numa planilha. Só leitura: a API não muda nada na sua conta.

https://api.nexotrade.com

Sua chave

Ela é criada em Configurações › API, a partir do rank Elite. Você pode ter até 5 ao mesmo tempo e apagá-las quando quiser. Ir para Configurações › API

A chave aparece uma única vez, ao criá-la. Guarde-a como uma senha: numa variável de ambiente ou nas propriedades do script, nunca no código, numa célula nem num repositório.

Ela vai no cabeçalho Authorization de cada requisição, nunca no endereço:

Authorization: Bearer nxt_…

A API não responde a páginas web de outros sites (não tem CORS). Chame-a de um servidor, um script ou do Google Sheets, para que sua chave não acabe no navegador de ninguém.

Ao criar uma chave, você aceita as condições de uso da API. Ler os termos

Os limites

Cada chave pode fazer 60 requisições por minuto e 10.000 por dia. O dia começa às 00:00 UTC. A Zona do Bitcoin e o índice de medo e ganância mudam uma vez por dia: pedi-los a cada minuto não traz nada novo.

Cada resposta traz estes cabeçalhos:

Os erros

Um erro chega com seu código HTTP e este corpo. Seu programa deve olhar «codigo»: «mensaje» é para pessoas e pode mudar.

{
  "error": {
    "codigo": "ritmo",
    "mensaje": "Você está indo rápido demais. Espere um pouco e tente de novo."
  }
}

Os endpoints

Todos são pedidos com GET e respondem em JSON. Os parâmetros vão no endereço, depois de «?».

{
  "hoy": {
    "fecha": "2026-10-27",
    "nota": 63,
    "tramo": "alta",
    "cobertura": 1,
    "comparaciones": [
      {
        "dias": 1,
        "nota": 61,
        "diferencia": 2
      }
    ],
    "enElTramo": 4
  },
  "atrasada": false,
  "version": 3,
  "partes": {
    "mayer": 71,
    "semanas200": 66,
    "funding": 48,
    "miedo": 55
  },
  "serie": null,
  "fuentes": [
    {
      "fuente": "Alternative.me",
      "enlace": "https://alternative.me/crypto/fear-and-greed-index/"
    }
  ]
}

{
  "hoy": {
    "fecha": "2026-10-28",
    "valor": 54,
    "tramo": "neutral",
    "comparaciones": [
      {
        "dias": 1,
        "valor": 50,
        "diferencia": 4
      }
    ]
  },
  "atrasado": false,
  "serie": null,
  "fuente": {
    "fuente": "Alternative.me",
    "enlace": "https://alternative.me/crypto/fear-and-greed-index/"
  }
}

{
  "hora": "2026-10-28T10:00:00.000Z",
  "monedas": [
    {
      "moneda": "BTC",
      "media8h": 0.0081
    },
    {
      "moneda": "ETH",
      "media8h": 0.0064
    }
  ],
  "serie": {
    "moneda": "BTC",
    "tramos": [
      {
        "t": "2026-10-28T00:00:00.000Z",
        "media": 0.0079
      }
    ]
  }
}

{
  "semana": "actual",
  "hora": "2026-10-28T10:00:00.000Z",
  "vieja": false,
  "eventos": [
    {
      "id": "us-ipc-anual",
      "titulo": "IPC (anual)",
      "pais": "US",
      "impacto": "alto",
      "hora": "2026-10-29T12:30:00.000Z",
      "soloFecha": false,
      "actual": null,
      "prevision": 2.9,
      "anterior": 3,
      "unidad": "%",
      "decimales": 1,
      "fuente": null
    }
  ],
  "aviso": {
    "texto": "This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis.",
    "enlace": "https://fred.stlouisfed.org/docs/api/terms_of_use.html"
  }
}

{
  "moneda": "bitcoin",
  "horizonte": "1h",
  "version": "completa",
  "calculadaEn": "2026-10-28T10:00:00.000Z",
  "datosDe": "2026-10-28T09:59:30.000Z",
  "enDirecto": true,
  "zonas": [
    {
      "desde": 64200,
      "hasta": 64550,
      "lado": "largos",
      "fuerza": 82,
      "confianza": 0.74,
      "estado": "activa",
      "nacio": "2026-10-27T22:10:00.000Z"
    }
  ],
  "tiempo": {
    "en": null,
    "desde": "2026-09-28T10:05:00.000Z",
    "hasta": "2026-10-28T10:00:00.000Z"
  },
  "filtro": {
    "antiguedad": "todas",
    "apalancamientos": null,
    "minima": 0,
    "escalones": [
      5,
      10,
      25,
      50,
      100
    ],
    "disponible": true
  },
  "vieja": false,
  "mejora": null
}

Exemplos

Os quatro pedem a Zona do Bitcoin de hoje. Os três primeiros leem a chave da variável de ambiente API_KEY: defina-a antes no seu terminal, não no código.

curl -H "Authorization: Bearer $API_KEY" https://api.nexotrade.com/v1/zona-btc

import os
import requests

r = requests.get(
    "https://api.nexotrade.com/v1/zona-btc",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    timeout=10,
)
r.raise_for_status()
hoy = r.json()["hoy"]
print(hoy["fecha"], hoy["nota"], hoy["tramo"])

const r = await fetch('https://api.nexotrade.com/v1/zona-btc', {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
const { hoy } = await r.json();
console.log(hoy.fecha, hoy.nota, hoy.tramo);

Google Sheets

Com o Apps Script, a planilha anota a nota de cada dia numa linha nova.

1. Na sua planilha, abra Extensões › Apps Script.
2. Em Configurações do projeto › Propriedades do script, adicione a propriedade API_KEY com sua chave como valor. Assim a chave não fica em nenhuma célula nem no código.
3. No editor, cole o código abaixo e salve.
4. Execute zonaBtc uma vez e dê a permissão. Ele anota a nota de hoje na aba «Zona do Bitcoin».
5. Para anotar sozinho todo dia, em Acionadores adicione um para zonaBtc, por tempo, uma vez por dia.

function zonaBtc() {
  const clave = PropertiesService.getScriptProperties().getProperty('API_KEY');
  const r = UrlFetchApp.fetch('https://api.nexotrade.com/v1/zona-btc', {
    headers: { Authorization: 'Bearer ' + clave },
    muteHttpExceptions: true,
  });
  if (r.getResponseCode() !== 200) throw new Error('HTTP ' + r.getResponseCode() + ': ' + r.getContentText());
  const hoy = JSON.parse(r.getContentText()).hoy;
  if (!hoy) return;

  const libro = SpreadsheetApp.getActiveSpreadsheet();
  const hoja = libro.getSheetByName("Zona do Bitcoin") || libro.insertSheet("Zona do Bitcoin");
  if (hoja.getLastRow() === 0) hoja.appendRow(['fecha', 'nota', 'tramo']);
  const fechas = hoja.getRange(1, 1, hoja.getLastRow(), 1).getDisplayValues().flat();
  if (!fechas.includes(hoy.fecha)) hoja.appendRow(["'" + hoy.fecha, hoy.nota, hoy.tramo]);
}

As fontes e suas licenças

Alguns dados vêm de fontes que pedem para ser citadas. Se você os mostrar, cite-as assim:

• O índice de medo e ganância, também dentro da zona: cite Alternative.me com o link. https://alternative.me/crypto/fear-and-greed-index/
• Os dados dos Estados Unidos do calendário vêm da API do FRED, que pede este aviso: This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis. As condições dele
• As taxas do BCE do calendário trazem a fonte no campo «fuente» de cada dado. Cite-a como está, sem mudar os números.

As respostas com dados dessas fontes trazem a citação em «fuente», «fuentes» ou «aviso». Condições de uso da API

É informação, não uma recomendação de investimento.