Catálogo de endpoints: las rutas de las herramientas MCP
Todo lo que se puede llamar, en una página. Los parámetros de cada ruta se leen del contrato OpenAPI, así que no pueden desviarse de lo que se sirve. El detalle (campos de respuesta, unidades, trampas) está en la página de la familia, enlazada al principio de cada sección, y en la referencia interactiva.
Host: https://api.bytnode.com. Cada ruta exige la cabecera X-API-KEY (salvo /v1/health) y acepta ?fields= (salvo /v1/health, /v1/status y POST /v1/indicators, que eligen su salida de otro modo). La columna Parámetros lista symbol donde la ruta lo admite; las rutas de mercado global (macro, on-chain, ETF, mercado global, sentimiento, sistema) no lo admiten y lo rechazan.
Un agente de IA no necesita este catálogo: descubre las once herramientas del servidor MCP, lee sus descripciones y llama a estas rutas a través de ellas.
#Sistema y metadatos
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/health no key | Si la API responde. | — | — |
GET /v1/status | Frescura de cada flujo de datos, flujo por flujo. | — | price_volume |
GET /v1/symbols | Los símbolos habilitados. | — | price_volume |
GET /v1/capabilities | Lo que se puede calcular para este símbolo y lo que no. | symbol (required) | price_volume |
GET /v1/limits | Lo que puede hacer tu clave: familias, ventanas de historial, velocidad y cuota restantes. | — | — |
POST /v1/ws/token | Un token WebSocket de corta duración para una página web: 60 segundos, una conexión, nunca tu clave. | — | — |
#Snapshot
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/snapshot | Hasta 52 campos en una petición. | one parameter per field (value = depth or true) | snapshot |
#Precio y volumen
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/klines | La última vela OHLCV cerrada, todas las temporalidades de 1m a 1w. | timeframe (required), live, symbol (required) | price_volume |
GET /v1/klines/history | Velas OHLCV, todas las temporalidades de 1m a 1w, de la más reciente a la más antigua. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | price_volume |
GET /v1/price-change | Variación en % en las ocho temporalidades. | symbol (required) | price_volume |
GET /v1/trades/spot | Operaciones spot individuales. | limit, since_ms, until_ms, before_ms, after_id, order, symbol (required) | trades |
GET /v1/trades/futures | Operaciones de futuros individuales. | limit, since_ms, until_ms, before_ms, after_id, order, symbol (required) | trades |
GET /v1/trades/large | Grandes órdenes, filtradas por importe. | min_usd, limit, since_ms, until_ms, before_ms, after_id, order, symbol (required) | trades |
GET /v1/trades-kline/futures/seconds | Operaciones de futuros agregadas al segundo, todos los mercados. | limit, since_ms, until_ms, order, symbol (required), before_ms | trades |
GET /v1/trades-kline | Vela de operaciones, spot y futuros sumados. | symbol (required), timeframe (required), live | microstructure |
GET /v1/trades-kline/history | Historial de las velas de operaciones. | symbol (required), timeframe (required), since_ms, until_ms, limit, before_ms, order | microstructure |
GET /v1/trades-kline/spot | Vela de operaciones, solo spot. | symbol (required), timeframe (required), live | microstructure |
GET /v1/trades-kline/spot/history | Historial spot. | symbol (required), timeframe (required), since_ms, until_ms, limit, before_ms, order | microstructure |
GET /v1/trades-kline/futures | Vela de operaciones, solo futuros. | symbol (required), timeframe (required), live | microstructure |
GET /v1/trades-kline/futures/history | Historial de futuros. | symbol (required), timeframe (required), since_ms, until_ms, limit, before_ms, order | microstructure |
#Derivados
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/oi | Interés abierto actual, sumado en los mercados. | symbol (required) | derivatives |
GET /v1/oi/history | Interés abierto agregado, por bucket. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/oi/change | Variación del interés abierto. | symbol (required) | derivatives |
GET /v1/oi/change/history | Historial del delta del interés abierto. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/funding/rate | Último funding aplicado. | live, symbol (required) | derivatives |
GET /v1/funding/rate/history | Historial de la tasa aplicada. | since_ms, until_ms, limit, symbol (required), before_ms, order | derivatives |
GET /v1/funding/next | Próximo funding estimado. | symbol (required) | derivatives |
GET /v1/funding/cumulative | Funding acumulado en 24 h. | symbol (required) | derivatives |
GET /v1/funding/cumulative/history | Historial del funding acumulado. | since_ms, until_ms, limit, symbol (required), before_ms, order | derivatives |
GET /v1/liquidations/events | Liquidaciones individuales. | limit, min_usd, symbol (required) | derivatives |
GET /v1/liquidations/cumulative | Liquidaciones acumuladas, largos frente a cortos. | symbol (required) | derivatives |
GET /v1/liquidations/cumulative/history | Historial de las liquidaciones acumuladas. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/liquidations/big-small-ratio | Grandes liquidaciones frente a pequeñas. | timeframe (required), symbol (required) | derivatives |
GET /v1/liquidations/big-small-ratio/history | Historial del ratio. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/basis | Diferencial de futuros frente a spot. | symbol (required) | derivatives |
GET /v1/basis/history | Historial de la base. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/spread/interexchange | Prima de cada mercado frente a la referencia. | timeframe (required), live, symbol (required) | microstructure |
GET /v1/spread/interexchange/history | Historial de las primas. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
#Flujo y microestructura
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/cvd | Delta de volumen acumulado, spot y futuros. | timeframe (required), live, symbol (required) | microstructure |
GET /v1/cvd/history | Historial del CVD, spot y futuros. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/cvd/spot | Delta de volumen acumulado, solo spot. | timeframe (required), live, symbol (required) | microstructure |
GET /v1/cvd/spot/history | Historial del CVD, solo spot. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/cvd/futures | Delta de volumen acumulado, solo futuros. | timeframe (required), live, symbol (required) | microstructure |
GET /v1/cvd/futures/history | Historial del CVD, solo futuros. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/orderbook | Profundidad del libro por rango de precio, spot y futuros. | timeframe (required), symbol (required) | microstructure |
GET /v1/orderbook/history | Historial del libro de órdenes, spot y futuros. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/orderbook/spot | Profundidad del libro por rango de precio, solo spot. | timeframe (required), symbol (required) | microstructure |
GET /v1/orderbook/spot/history | Historial del libro de órdenes, solo spot. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/orderbook/futures | Profundidad del libro por rango de precio, solo futuros. | timeframe (required), symbol (required) | microstructure |
GET /v1/orderbook/futures/history | Historial del libro de órdenes, solo futuros. | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/buy-sell-ratio | Ratio compra / venta del último bucket cerrado, spot y futuros. | timeframe (required), symbol (required) | microstructure |
GET /v1/buy-sell-ratio/history | Historial del ratio compra / venta, spot y futuros. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/buy-sell-ratio/spot | Ratio compra / venta del último bucket cerrado, solo spot. | timeframe (required), symbol (required) | microstructure |
GET /v1/buy-sell-ratio/spot/history | Historial del ratio compra / venta, solo spot. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/buy-sell-ratio/futures | Ratio compra / venta del último bucket cerrado, solo futuros. | timeframe (required), symbol (required) | microstructure |
GET /v1/buy-sell-ratio/futures/history | Historial del ratio compra / venta, solo futuros. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/trades/avg-size | Tamaño medio de las operaciones, spot y futuros. | timeframe (required), symbol (required) | microstructure |
GET /v1/trades/avg-size/history | Historial del tamaño medio, spot y futuros. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/trades/avg-size/spot | Tamaño medio de las operaciones, solo spot. | timeframe (required), symbol (required) | microstructure |
GET /v1/trades/avg-size/spot/history | Historial del tamaño medio, solo spot. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/trades/avg-size/futures | Tamaño medio de las operaciones, solo futuros. | timeframe (required), symbol (required) | microstructure |
GET /v1/trades/avg-size/futures/history | Historial del tamaño medio, solo futuros. | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
#Indicadores técnicos
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
POST /v1/indicators | Diecinueve tipos de indicadores, hasta 50 instancias por llamada. | — | indicators |
#Opciones
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/options/summary | Resumen del activo. | asset (required) | options |
GET /v1/options/oi | Interés abierto de opciones. | asset (required) | options |
GET /v1/options/oi/history | Historial del interés abierto. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/oi/change | Variación del interés abierto. | timeframe (required), asset (required) | options |
GET /v1/options/oi/change/history | Historial del delta. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/oi/distribution | Reparto del OI por strike y por vencimiento. | expiry, asset (required) | options |
GET /v1/options/volume | Volumen de opciones en USD. | asset (required) | options |
GET /v1/options/volume/history | Historial del volumen. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/put-call-ratio | Ratio put / call. | asset (required) | options |
GET /v1/options/put-call-ratio/history | Historial del put / call. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/max-pain | Max pain por vencimiento. | asset (required) | options |
GET /v1/options/max-pain/history | Historial del max pain. | expiry (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/iv | Volatilidad implícita ponderada. | asset (required) | options |
GET /v1/options/iv/klines | La última vela OHLC cerrada de la volatilidad implícita. | timeframe (required), asset (required) | options |
GET /v1/options/iv/klines/history | Velas OHLC de la volatilidad implícita, de la más reciente a la más antigua. | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/greeks | Griegas agregadas. | asset (required) | options |
GET /v1/options/expiry | Resumen por vencimiento. | asset (required) | options |
#Red de Bitcoin
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/btc/network | Altura, dificultad, próximo ajuste. | — | onchain |
GET /v1/btc/network/history | Historial de la red. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/mempool | Transacciones pendientes, peso, comisiones. | — | onchain |
GET /v1/btc/mempool/history | Historial del mempool. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/fees | Comisiones recomendadas por prioridad. | — | onchain |
GET /v1/btc/fees/history | Historial de las comisiones. | since_ms, until_ms, limit, timeframe, before_ms, order | onchain |
GET /v1/btc/mining | Concentración de pools, recompensas. | — | onchain |
GET /v1/btc/mining/history | Historial de la minería. | dataset, since_ms, until_ms, limit, before_ms, order | onchain |
#Valoración on-chain de Bitcoin
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/btc/mvrv | MVRV y zona de valoración. | — | onchain |
GET /v1/btc/mvrv/history | Historial del MVRV. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/nvt | NVT y su señal suavizada. | — | onchain |
GET /v1/btc/nvt/history | Historial del NVT. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/active-addresses | Direcciones activas y momentum. | — | onchain |
GET /v1/btc/active-addresses/history | Historial de las direcciones activas. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/revenue-per-difficulty | Estrés de los mineros. | — | onchain |
GET /v1/btc/revenue-per-difficulty/history | Historial del estrés de los mineros. | since_ms, until_ms, limit, before_ms, order | onchain |
#On-chain de Ethereum
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/eth/supply | Oferta, staking, quemado, emisión neta. | — | onchain |
GET /v1/eth/supply/history | Historial de la oferta. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/gas | Precio del gas y congestión. | — | onchain |
GET /v1/eth/gas/history | Historial del gas. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/gas-momentum | Momentum del gas y régimen. | — | onchain |
GET /v1/eth/gas-momentum/history | Historial del momentum. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/staking | Ratio y rendimiento del staking. | — | onchain |
GET /v1/eth/staking/history | Historial del staking. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/deflation | Quema frente a emisión. | — | onchain |
GET /v1/eth/deflation/history | Historial de la deflación. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/defi | TVL de Ethereum y volumen de DEX. | — | onchain |
GET /v1/eth/defi/history | Historial DeFi. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/squeeze | Índice de squeeze. | — | onchain |
GET /v1/eth/squeeze/history | Historial del squeeze. | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/price-btc | Ratio ETH/BTC y momentum. | — | onchain |
GET /v1/eth/price-btc/history | Historial del ratio. | since_ms, until_ms, limit, before_ms, order | onchain |
#Macro
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/macro | Último valor de una serie (series obligatorio). | series (required) | macro |
GET /v1/macro/series | Catálogo de las series disponibles. | category | macro |
GET /v1/macro/history | Historial de una serie. | since_ms, until_ms, limit, series (required), before_ms, order | macro |
GET /v1/macro/correlations | Correlaciones BTC frente a macro. | — | macro |
GET /v1/macro/net-liquidity | Liquidez neta. | — | macro |
GET /v1/macro/net-liquidity/history | Historial de la liquidez neta. | since_ms, until_ms, limit, before_ms, order | macro |
GET /v1/macro/momentum | Puntuación de momentum macro. | — | macro |
GET /v1/macro/risk | Régimen risk-on / risk-off. | — | macro |
GET /v1/macro/intraday/series | Catálogo de los instrumentos intradía. | — | macro |
GET /v1/macro/intraday/history | Velas OHLC de un instrumento macro. | since_ms, until_ms, limit, series (required), timeframe (required), before_ms, order | macro |
#ETF, tokenomics y sentimiento
| Ruta | Descripción | Parámetros | Familia de datos |
|---|---|---|---|
GET /v1/etf/fundamentals | Ancla trimestral por emisor. | asset (required) | etf |
GET /v1/etf/fundamentals/history | Historial de los fundamentales. | ticker, since_ms, until_ms, limit, asset (required), before_ms, order | etf |
GET /v1/tokenomics | Oferta, capitalización y FDV del símbolo. | symbol (required) | tokenomics |
GET /v1/tokenomics/history | Historial de tokenomics. | since_ms, until_ms, limit, symbol (required), before_ms, order | tokenomics |
GET /v1/global | Capitalización total y dominancia. | — | price_volume |
GET /v1/global/history | Historial del mercado global. | since_ms, until_ms, limit, timeframe, before_ms, order | price_volume |
GET /v1/fear-greed | Fear & Greed del día. | — | sentiment |
GET /v1/fear-greed/history | Historial desde 2018. | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/fear-greed/cmc | Fear & Greed de CoinMarketCap, actualizado durante el día. | — | sentiment |
GET /v1/fear-greed/cmc/history | Un punto al día desde 2023. | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/altcoin-season | Altcoin Season Index, capitalización de las altcoins, extremos de un año. | — | sentiment |
GET /v1/altcoin-season/history | Un punto al día, los últimos 90 días y en adelante. | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/indices/cmc20 | Índice CMC20, variación en 24 h y sus 20 componentes. | — | sentiment |
GET /v1/indices/cmc20/history | Un valor al día desde 2024. | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/indices/cmc100 | Índice CMC100, variación en 24 h y sus 100 componentes. | — | sentiment |
GET /v1/indices/cmc100/history | Un valor al día desde 2024. | since_ms, until_ms, limit, before_ms, order | sentiment |