API de datos macro para agentes de IA

#Datos macro para agentes de IA y LLM

«¿Sube el rendimiento a 10 años de EE. UU.?», «¿Cómo se ha movido la liquidez neta frente a Bitcoin?», «¿Qué series macro se mueven con BTC ahora mismo?»: un agente de IA lee el contexto macro mediante la herramienta MCP get_macro_data, una serie del catálogo a la vez o como indicadores derivados.

{
  "name": "get_macro_data",
  "arguments": {
    "series": "DGS10",
    "fields": ["macro"]
  }
}

• Para el LLM: una serie se nombra por su identificador de catálogo (DGS10 es el rendimiento a 10 años de EE. UU.), nunca se adivina: get_system_info lista el catálogo.
• Para desarrolladores: /v1/macro?series= y /v1/macro/series dan a tu propio agente de IA una herramienta y su catálogo para el tool calling, la misma pareja en la que se apoya el servidor MCP.
• 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.

#Series macro diarias

Unas veinte series oficiales de EE. UU., más el oro, repartidas en ocho categorías. /v1/macro devuelve el último valor de UNA serie, indicada con ?series= (obligatorio); /v1/macro/series es el catálogo, con el último valor de cada serie; /v1/macro/history el historial de una serie, indicada con ?series=.

# The catalogue of the series served
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/series"

# The history of one series
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/macro/history?series=DGS10&limit=90"

#Indicadores derivados

Cuatro lecturas compuestas, calculadas bajo demanda a partir de las series brutas y del precio de Bitcoin.

La correlación móvil de Bitcoin con el dólar, el S&P 500, el oro y el VIX, a treinta y noventa días, calculada sobre los rendimientos diarios en fechas comunes. Una correlación sigue siendo null mientras el historial alineado sea insuficiente.

La liquidez neta: el balance de la Fed, menos la cuenta general del Tesoro, menos los repos inversos a un día. La respuesta incluye la fórmula y sus componentes, y la unidad es explícita, ya que las tres series de origen no usan la misma.

Una puntuación de −100 a +100, construida sobre la dinámica de M2, del balance de la Fed y del dólar, a treinta y noventa días. Una masa monetaria al alza y un dólar a la baja empujan la puntuación hacia arriba. Cada componente lleva su tasa de variación en porcentaje, change_pct.

Una puntuación de 0 a 100 sobre cinco señales: VIX bajo, dólar en retroceso, pendiente de la curva de tipos positiva, S&P por encima de su media de cincuenta días, oro en retroceso. Una señal sin datos se excluye del cálculo en lugar de contarse como desfavorable.

#Macro intradía

Cinco instrumentos macro en velas OHLC, para comparar las cripto por horas en lugar de por días: EUR/USD, USD/JPY, petróleo WTI, el índice del dólar ICE y el oro tokenizado, cada uno en seis temporalidades (1m a 1d, sin 30m). Los tipos a 10 y 30 años, el VIX, el S&P 500 y el Nasdaq son series diarias de FRED, servidas por /v1/macro.

curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/macro/intraday/history?series=PAXGUSDT&timeframe=1h&limit=200"

Pedir una temporalidad que una serie no sirve devuelve 422 timeframe_not_served con la lista de las que sí sirve, en lugar de una lista vacía, que haría pensar en un hueco en los datos. data es la lista de velas, de la más reciente a la más antigua; series y timeframe se repiten en el sobre.