API para desarrolladores

Los datos de las herramientas en JSON, para leerlos desde tus programas, tus scripts o una hoja de cálculo. Solo se leen: la API no cambia nada de tu cuenta.

https://api.nexotrade.com

Tu clave

Se crea en Ajustes › API, desde el rango Elite. Puedes tener hasta 5 a la vez y borrarlas cuando quieras. Ir a Ajustes › API

La clave se enseña una sola vez, al crearla. Guárdala como una contraseña: en una variable de entorno o en las propiedades del script, nunca en el código, en una celda ni en un repositorio.

Va en la cabecera Authorization de cada petición, nunca en la dirección:

Authorization: Bearer nxt_…

La API no contesta a las páginas web de otros sitios (no tiene CORS). Llámala desde un servidor, un script o Google Sheets, para que tu clave no acabe en el navegador de nadie.

Al crear una clave aceptas las condiciones de uso de la API. Leer las condiciones

Los límites

Cada clave puede hacer 60 peticiones por minuto y 10.000 al día. El día empieza a las 00:00 UTC. La zona de Bitcoin y el índice de miedo y codicia cambian una vez al día: pedirlos cada minuto no trae nada nuevo.

Cada respuesta lleva estas cabeceras:

Los errores

Un error llega con su código HTTP y este cuerpo. Tu programa tiene que mirar «codigo»: «mensaje» es para personas y puede cambiar.

{
  "error": {
    "codigo": "ritmo",
    "mensaje": "Vas muy rápido. Espera un poco y vuelve a intentarlo."
  }
}

Las direcciones

Todas se piden con GET y contestan en JSON. Los parámetros van en la dirección, después 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
}

Ejemplos

Los cuatro piden la zona de Bitcoin de hoy. Los tres primeros leen la clave de la variable de entorno API_KEY: ponla antes en tu terminal, no en el 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

Con Apps Script, la hoja apunta la nota de cada día en una fila nueva.

1. En tu hoja de cálculo, abre Extensiones › Apps Script.
2. En Configuración del proyecto › Propiedades del script, añade la propiedad API_KEY con tu clave como valor. Así la clave no queda en ninguna celda ni en el código.
3. En el editor, pega el código de abajo y guárdalo.
4. Ejecuta zonaBtc una vez y dale permiso. Apunta la nota de hoy en la pestaña «Zona de Bitcoin».
5. Para que se apunte sola cada día, en Activadores añade uno para zonaBtc, por tiempo, una vez al día.

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 de Bitcoin") || libro.insertSheet("Zona de 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]);
}

Las fuentes y sus licencias

Algunos datos vienen de fuentes que piden que se las cite. Si los enseñas, cítalas así:

• El índice de miedo y codicia, también dentro de la zona: cita a Alternative.me con su enlace. https://alternative.me/crypto/fear-and-greed-index/
• Los datos de Estados Unidos del calendario salen de la API de FRED, que pide este aviso: This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis. Sus condiciones
• Los tipos del BCE del calendario llevan su fuente en el campo «fuente» de cada dato. Cítala tal cual, sin cambiar las cifras.

Las respuestas con datos de esas fuentes llevan su cita en «fuente», «fuentes» o «aviso». Condiciones de uso de la API

Es información, no una recomendación de inversión.