API pour les développeurs

Les données des outils en JSON, à lire depuis tes programmes, tes scripts ou un tableur. En lecture seule : l'API ne change rien à ton compte.

https://api.nexotrade.com

Ta clé

Elle se crée dans Paramètres › API, à partir du rang Elite. Tu peux en avoir jusqu'à 5 à la fois et les supprimer quand tu veux. Aller à Paramètres › API

La clé ne s'affiche qu'une fois, à sa création. Garde-la comme un mot de passe : dans une variable d'environnement ou dans les propriétés du script, jamais dans le code, dans une cellule ou dans un dépôt.

Elle va dans l'en-tête Authorization de chaque requête, jamais dans l'adresse :

Authorization: Bearer nxt_…

L'API ne répond pas aux pages web d'autres sites (elle n'a pas de CORS). Appelle-la depuis un serveur, un script ou Google Sheets, pour que ta clé ne finisse dans le navigateur de personne.

En créant une clé, tu acceptes les conditions d'utilisation de l'API. Lire les conditions

Les limites

Chaque clé peut faire 60 requêtes par minute et 10 000 par jour. Le jour commence à 00:00 UTC. La Zone du Bitcoin et l'indice de peur et d'avidité changent une fois par jour : les demander chaque minute n'apporte rien de nouveau.

Chaque réponse porte ces en-têtes :

Les erreurs

Une erreur arrive avec son code HTTP et ce corps. Ton programme doit regarder «codigo» : «mensaje» est pour les personnes et peut changer.

{
  "error": {
    "codigo": "ritmo",
    "mensaje": "Tu vas trop vite. Attends un peu et réessaie."
  }
}

Les endpoints

Tous se demandent avec GET et répondent en JSON. Les paramètres vont dans l'adresse, après «?».

{
  "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
}

Exemples

Les quatre demandent la Zone du Bitcoin du jour. Les trois premiers lisent la clé dans la variable d'environnement API_KEY : définis-la d'abord dans ton terminal, pas dans le code.

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

Avec Apps Script, la feuille note la note de chaque jour sur une nouvelle ligne.

1. Dans ton tableur, ouvre Extensions › Apps Script.
2. Dans Paramètres du projet › Propriétés du script, ajoute la propriété API_KEY avec ta clé comme valeur. Ainsi la clé n'est dans aucune cellule ni dans le code.
3. Dans l'éditeur, colle le code ci-dessous et enregistre-le.
4. Exécute zonaBtc une fois et donne l'autorisation. Il note la note du jour dans l'onglet «Zone du Bitcoin».
5. Pour qu'il note tout seul chaque jour, dans Déclencheurs ajoute-en un pour zonaBtc, basé sur le temps, une fois par jour.

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

Les sources et leurs licences

Certaines données viennent de sources qui demandent à être citées. Si tu les affiches, cite-les ainsi :

• L'indice de peur et d'avidité, aussi dans la zone : cite Alternative.me avec son lien. https://alternative.me/crypto/fear-and-greed-index/
• Les données des États-Unis du calendrier viennent de l'API FRED, qui demande cet avis : This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis. Ses conditions
• Les taux de la BCE du calendrier portent leur source dans le champ «fuente» de chaque donnée. Cite-la telle quelle, sans changer les chiffres.

Les réponses avec des données de ces sources portent leur citation dans «fuente», «fuentes» ou «aviso». Conditions d’utilisation de l’API

C’est de l’information, pas une recommandation d’investissement.