API de derivados cripto

#Datos de derivados cripto para agentes de IA y LLM

«¿El funding de BTC es positivo?», «¿Cuánto open interest ha sumado ETH hoy?», «¿Qué lado se liquidó en la última hora?»: un agente de IA conectado por MCP responde con esta familia, para un par o hasta diez comparados, mediante la herramienta get_pair_data.

{
  "name": "get_pair_data",
  "arguments": {
    "symbol": ["BTCUSDT", "ETHUSDT"],
    "fields": ["funding_next", "oi", "liquidations_cumulative"],
    "timeframe": "1h"
  }
}

• Para el LLM: un rate_pct de funding es un porcentaje para una ventana de ocho horas, no una tasa anual; apr_pct lo anualiza. Citarlo como rendimiento anual es el error clásico.
• Para desarrolladores: en tu propio agente de IA, /v1/funding/rate y /v1/oi son dos herramientas sencillas para el tool calling; el servidor MCP ya las expone, con los mismos nombres y unidades.
• Dónde funciona: Claude, ChatGPT, Cursor y cualquier cliente MCP, incluidos los frameworks de agentes compatibles con MCP, como LangChain o n8n.

Conecta tu agente de IA con la guía del servidor MCP, o enséñale BytNode con los Agent Skills de código abierto.

#Interés abierto

El interés abierto total, sumado en todos los mercados, una fila por intervalo cerrado de timeframe (obligatorio, 1m a 1d): para cada mercado su último valor en el intervalo, como un cierre. El valor actual es /v1/oi.

La variación del interés abierto: el capital que entra o sale. El porcentaje se recalcula a partir de los totales agregados, para ser coherente con la suma.

#Funding

Tres lecturas del mismo fenómeno: la última tasa aplicada, la próxima estimada y el total acumulado en las últimas veinticuatro horas. Todas son compuestos ponderados por el interés abierto (el mercado que lleva más posiciones pesa más) y normalizados a una base de ocho horas antes de ponderar, porque algunos pares liquidan cada cuatro horas o cada hora.

curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/funding/cumulative?symbol=BTCUSDT"

#Liquidaciones

Las liquidaciones individuales, de todos los mercados. Aquí la cobertura es estructuralmente menor que en las operaciones: no todos los mercados publican un flujo público de liquidaciones.

La relación entre las grandes liquidaciones (al menos 100 000 $) y las pequeñas. Distingue una purga de grandes cuentas de una cascada de pequeños tenedores.

#Base

La diferencia entre el precio de futuros y el precio spot, una media ponderada por el interés abierto sobre los mercados que tienen ambos mercados. Los dos precios se ponderan igual, lo que garantiza que basis_value = futures_price − spot_price siga siendo cierto.

#Diferenciales entre mercados

La única superficie de BytNode que nombra los mercados, porque un diferencial no tiene sentido sin ellos. El modelo es una prima por mercado: un precio de referencia multimercado y después la diferencia de cada mercado con esa referencia. Cualquier par se deduce en el cliente, por la diferencia de dos primas.

{
  "status": "ok",
  "server_time": "2026-10-14T09:06:22.870Z",
  "data_type": "spread_interexchange",
  "symbol": "BTCUSDT",
  "timeframe": "1h",
  "market": "futures",
  "data": {
    "time": "2026-10-14T08:00:00.000Z",
    "is_closed": true,
    "ref_price": 83706.7967743,
    "weighting": "volume",
    "max_spread_bps": 18.8831076757,
    "high_venue": "venue_a",
    "high_price": 83720.69106,
    "low_venue": "venue_b",
    "low_price": 83562.6266143,
    "venues": [
      { "venue": "venue_a", "price": 83720.69106, "premium_bps": 1.65987545135 },
      { "venue": "venue_c", "price": 83715.3204619, "premium_bps": 1.01827903431 }
    ]
  }
}