Geliştiriciler için API

Araçların verileri JSON olarak; programlarından, betiklerinden ya da bir e-tablodan okuman için. Yalnızca okunur: API hesabında hiçbir şeyi değiştirmez.

https://api.nexotrade.com

Anahtarın

Ayarlar › API’de, Elite rütbesinden itibaren oluşturulur. Aynı anda en fazla 5 tane olabilir ve istediğin zaman silebilirsin. Ayarlar › API’ye git

Anahtar yalnızca bir kez, oluşturulurken gösterilir. Onu bir parola gibi sakla: bir ortam değişkeninde ya da komut dosyası özelliklerinde; asla kodda, bir hücrede ya da bir depoda değil.

Her isteğin Authorization başlığına girer, asla adrese değil:

Authorization: Bearer nxt_…

API başka sitelerin web sayfalarına yanıt vermez (CORS yok). Anahtarın kimsenin tarayıcısına düşmesin diye onu bir sunucudan, bir betikten ya da Google Sheets’ten çağır.

Bir anahtar oluşturduğunda API kullanım koşullarını kabul etmiş olursun. Koşulları oku

Limitler

Her anahtar dakikada 60, günde 10.000 istek yapabilir. Gün 00:00 UTC’de başlar. Bitcoin Bölgesi ve korku ve açgözlülük endeksi günde bir kez değişir: onları her dakika istemek yeni bir şey getirmez.

Her yanıt şu başlıkları taşır:

Hatalar

Bir hata, HTTP kodu ve bu gövdeyle gelir. Programın «codigo» alanına bakmalı: «mensaje» insanlar içindir ve değişebilir.

{
  "error": {
    "codigo": "ritmo",
    "mensaje": "Çok hızlı gidiyorsun. Biraz bekle ve tekrar dene."
  }
}

Uç noktalar

Hepsi GET ile istenir ve JSON ile yanıt verir. Parametreler adreste, «?» işaretinden sonra yer alır.

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

Örnekler

Dördü de bugünün Bitcoin Bölgesi’ni ister. İlk üçü anahtarı API_KEY ortam değişkeninden okur: onu önce terminalinde ayarla, kodda değil.

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

Apps Script ile tablo her günün puanını yeni bir satıra yazar.

1. E-tablonda Uzantılar › Apps Script’i aç.
2. Proje Ayarları › Komut Dosyası Özellikleri’nde, değeri anahtarın olan API_KEY özelliğini ekle. Böylece anahtar hiçbir hücrede ya da kodda kalmaz.
3. Düzenleyicide aşağıdaki kodu yapıştır ve kaydet.
4. zonaBtc’yi bir kez çalıştır ve izin ver. Bugünün puanını «Bitcoin Bölgesi» sekmesine yazar.
5. Her gün kendiliğinden yazması için Tetikleyiciler’de zonaBtc için zamana dayalı, günde bir kez çalışan bir tane ekle.

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("Bitcoin Bölgesi") || libro.insertSheet("Bitcoin Bölgesi");
  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]);
}

Kaynaklar ve lisansları

Bazı veriler, kaynak gösterilmesini isteyen yerlerden gelir. Onları gösterirsen kaynağı şöyle belirt:

• Korku ve açgözlülük endeksi, bölgenin içinde de: Alternative.me kaynağını bağlantısıyla belirt. https://alternative.me/crypto/fear-and-greed-index/
• Takvimdeki ABD verileri FRED API’sinden gelir ve şu uyarıyı ister: This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis. Koşulları
• Takvimdeki ECB faiz oranları her verinin «fuente» alanında kaynağını taşır. Rakamları değiştirmeden olduğu gibi aktar.

Bu kaynaklardan veri içeren yanıtlar kaynağı «fuente», «fuentes» ya da «aviso» alanında taşır. API kullanım koşulları

Bu bir bilgidir, yatırım tavsiyesi değildir.