Datos de mercado
Herramienta
search_coins
Resuelve una coin o token por nombre en texto libre o símbolo a su slug canónico, con un resumen de mercado clasificado por coincidencia. El punto de entrada: todas las demás herramientas de coins se direccionan por slug.
| Parámetro |
Tipo |
Descripción |
query
obligatorio
|
string |
Búsqueda en texto libre comparada con nombres y símbolos de coins. |
type
|
enum |
Restringe las coincidencias: coin o token. |
limit
|
integer |
Máximo de coincidencias a devolver (1–50, por defecto 10). |
Herramienta
get_coin
Perfil completo de una coin: ofertas, rango y cambios de rango, máximo/mínimo históricos y distancia hasta ellos, valoración totalmente diluida, enlaces, contratos y descripción.
| Parámetro |
Tipo |
Descripción |
slug
obligatorio
|
string |
Slug canónico de la coin, p. ej. bitcoin. |
Herramienta
get_prices
Precios spot actuales de hasta 100 coins en una llamada, opcionalmente convertidos a una divisa fiat. La forma más barata de responder preguntas de precios - se requiere exactamente un selector.
| Parámetro |
Tipo |
Descripción |
slugs
|
string |
Slugs de coins separados por comas - el selector preferido. |
symbols
|
string |
Símbolos ticker separados por comas; los símbolos ambiguos se resuelven a la coincidencia mejor clasificada. |
ids
|
string |
Ids numéricos de coins de Bitculator separados por comas. |
convert
|
string |
Símbolo de la divisa fiat a la que convertir los precios, p. ej. EUR. Por defecto USD. |
Herramienta
get_top_movers
Las mayores subidas o bajadas por cambio porcentual en las últimas 24 horas o 7 días.
| Parámetro |
Tipo |
Descripción |
direction
obligatorio
|
enum |
gainers o losers. |
interval
|
enum |
Ventana de cambio para clasificar: 24h o 7d (por defecto 24h). |
limit
|
integer |
Máximo de coins a devolver (1–50, por defecto 10). |
Herramienta
get_trending_coins
Las coins que más atención atraen ahora mismo en Bitculator, como filas de mercado compactas.
| Parámetro |
Tipo |
Descripción |
limit
|
integer |
Máximo de coins a devolver (1–20, por defecto 10). |
Histórico
Herramienta
get_price_history
Velas OHLCV de una coin en un rango de fechas. Retención: por minuto ~8 días, por media hora ~3 meses, por hora ~6 meses, diario = histórico completo. Devuelve las velas más recientes de la ventana, las más antiguas primero.
| Parámetro |
Tipo |
Descripción |
slug
obligatorio
|
string |
Slug canónico de la coin. |
interval
|
enum |
Intervalo de las velas: minutely, half-hourly, hourly o daily (por defecto daily). |
start
|
date |
Inicio de la ventana como YYYY-MM-DD; por defecto una ventana reciente adecuada al intervalo. |
end
|
date |
Fin de la ventana como YYYY-MM-DD; por defecto ahora. |
limit
|
integer |
Máximo de velas a devolver (1–500, por defecto 90). |
Herramienta
get_historical_price
El precio de una coin en una fecha pasada concreta, con hasta 3 días de respaldo cuando el día exacto no tiene datos.
| Parámetro |
Tipo |
Descripción |
slug
obligatorio
|
string |
Slug canónico de la coin. |
date
obligatorio
|
date |
La fecha como YYYY-MM-DD (2009-01-01 o posterior, no en el futuro). |
Herramienta
get_global_history
Serie temporal de la capitalización total del mercado cripto o del volumen total. La granularidad sigue el periodo: 24h por media hora, 7d por hora, 30d y all a diario.
| Parámetro |
Tipo |
Descripción |
metric
obligatorio
|
enum |
Qué serie devolver: marketcap o volume. |
period
|
enum |
Ventana: 24h, 7d, 30d o all (por defecto 24h). |
Sentimiento y global
Herramienta
get_global_market
Instantánea de todo el mercado: capitalización total, volumen total de 24 h, dominancia de BTC/ETH y recuentos de coins/tokens/exchanges/pares.
Esta herramienta no acepta parámetros.
Herramienta
get_fear_greed
El índice de sentimiento de Miedo y Codicia para todo el mercado, o para una coin cuando se pasa un slug, incluyendo subpuntuaciones por intervalo de 7d/30d.
| Parámetro |
Tipo |
Descripción |
coin
|
string |
Slug de coin opcional para una lectura por coin; omítelo para el índice de todo el mercado. |
Herramienta
get_altseason_index
El índice de altseason - si las altcoins están superando a Bitcoin - con histórico diario opcional.
| Parámetro |
Tipo |
Descripción |
days
|
integer |
Días de histórico diario a incluir (0–365; 0 devuelve solo la lectura actual). |
Herramienta
get_liquidations_summary
Los totales de liquidaciones de futuros de hoy con el reparto largo/corto y la dominancia. Los datos pueden ser null justo después del cierre diario.
Esta herramienta no acepta parámetros.
Exchanges
Herramienta
list_exchanges
Exchanges clasificados con volumen de 24 h, dominancia de volumen y recuentos de pares/activos. También resuelve nombres de exchanges a slugs.
| Parámetro |
Tipo |
Descripción |
type
|
enum |
Restringe a exchanges centralizados (cex) o descentralizados (dex). |
search
|
string |
Búsqueda en texto libre comparada con nombres de exchanges. |
sort
|
string |
Campos de ordenación separados por comas, prefijo "-" para descendente: volume, rank, volume_dominance, change_24h, change_7d, pairs, assets. |
limit
|
integer |
Máximo de exchanges a devolver (1–50, por defecto 10). |
Herramienta
get_exchange
Perfil completo de un exchange: rango, volumen y cambios, dominancia, pares y activos listados, y enlaces.
| Parámetro |
Tipo |
Descripción |
slug
obligatorio
|
string |
Slug canónico del exchange, p. ej. binance-exchange. |
Herramienta
get_exchange_trust_score
La puntuación de confianza de un exchange (0–10) con su desglose completo de 13 factores.
| Parámetro |
Tipo |
Descripción |
slug
obligatorio
|
string |
Slug canónico del exchange. |
Herramienta
get_coin_markets
Dónde cotiza una coin: sus mercados en los distintos exchanges con par, precio y volumen de 24 h, ordenados por volumen.
| Parámetro |
Tipo |
Descripción |
slug
obligatorio
|
string |
Slug canónico de la coin. |
exchange
|
string |
Slug de exchange opcional para restringir los resultados a una sola plataforma. |
instrument
|
enum |
Restringe a un tipo de instrumento: spot, future, option, swap o margin. |
limit
|
integer |
Máximo de mercados a devolver (1–50, por defecto 10). |
Análisis y utilidades
Herramienta
get_coin_technicals
La instantánea técnica multiindicador de una coin en una llamada: RSI, MACD, SMA, ADX, MFI, CCI, OBV, VWAP, volatilidad y más, cada uno con su último estado y puntuación.
| Parámetro |
Tipo |
Descripción |
slug
obligatorio
|
string |
Slug canónico de la coin. |
Herramienta
convert_currency
Convierte un importe entre cualesquiera divisas cripto y/o fiat (hasta 10 destinos por llamada) usando tasas en vivo, con precisión decimal completa.
| Parámetro |
Tipo |
Descripción |
from
obligatorio
|
string |
Slug de la divisa de origen, p. ej. bitcoin o united-states-dollar. |
to
obligatorio
|
string |
Slugs de las divisas de destino separados por comas, hasta 10. |
amount
|
number |
Importe de la divisa de origen a convertir (por defecto 1). |
Herramienta
calculate_dca
Backtestea una estrategia de promediado de coste (DCA) contra el histórico de precios real: total invertido, coins acumuladas, valor actual y ganancias/pérdidas.
| Parámetro |
Tipo |
Descripción |
slug
obligatorio
|
string |
Slug canónico de la coin. |
amount
obligatorio
|
number |
Importe en USD comprado en cada intervalo. |
interval
obligatorio
|
enum |
Cadencia de compra: daily, weekly, monthly, quarterly o yearly. |
start
obligatorio
|
date |
Fecha de la primera compra como YYYY-MM-DD (antes de hoy). |
end
|
date |
Fecha de la última compra como YYYY-MM-DD; por defecto hoy. |
series
|
boolean |
Incluir la serie compra a compra (salida voluminosa - déjalo en false salvo que se pida). |