Desarrolladores

API pública de datos de mercado

Precios, velas, libro de órdenes y lista de pares. Sin registro, sin clave y gratis.

Inicio rápido

URL base: https://yubbit.com/api/v1

Autenticación: No requerida

curl https://yubbit.com/api/v1/ticker?symbol=BTC_USDT

Datos de mercado

Formato propio de Yubbit: precios en tiempo real, velas y libro de órdenes de un par o de todos los pares.

GET /api/v1/ping

Comprobación del estado del servicio.

GET /api/v1/time

Reloj del servidor para firmar o comprobar desfases.

GET /api/v1/markets

Precio en tiempo real y estadísticas de 24 h de cada par.

GET /api/v1/ticker?symbol=

Precio en tiempo real de un par. Si no se indica el símbolo, este endpoint devuelve todos los pares spot en formato CoinMarketCap (consulta la sección spot).

GET /api/v1/klines

Velas OHLCV, de la más antigua a la más reciente. open_time es la hora de apertura de la vela en segundos Unix, no en milisegundos.

GET /api/v1/orderbook?symbol=

Instantánea del libro de órdenes. Las ofertas van del mejor precio (el más alto) hacia abajo; las demandas, del mejor precio (el más bajo) hacia arriba. Cada nivel es [precio, cantidad]. best_ask / best_bid son los precios a los que se ejecuta una compra / venta de mercado.

Spot: formato de CoinMarketCap

Endpoints del mercado spot que siguen las especificaciones de listado de exchanges de CoinMarketCap: resumen, activos, ticker, libro de órdenes y operaciones.

GET /api/v1/summary

Resumen de 24 horas de todos los pares spot (resumen de CoinMarketCap). lowest_ask y highest_bid son los mejores precios del libro de órdenes, a los que se ejecuta una compra o venta de mercado.

GET /api/v1/assets

Todas las monedas negociadas en el mercado spot, identificadas por símbolo (CoinMarketCap A1). Los campos opcionales solo aparecen cuando Yubbit dispone de los datos: name, can_withdraw (false durante el mantenimiento), min_withdraw (solo USDT), maker_fee, taker_fee y contractAddress.

GET /api/v1/ticker

Último precio y volumen de 24 horas de todos los pares spot, identificados como BASE_QUOTE (CoinMarketCap A2). isFrozen es 1 mientras las operaciones estén pausadas por mantenimiento; de lo contrario, es 0.

GET /api/v1/orderbook/{market_pair}

Libro de órdenes de nivel 2 de un par (CoinMarketCap A3). Cada nivel es [precio, cantidad].

GET /api/v1/trades/{market_pair}

Operaciones spot recientes de un par de las últimas 24 horas.

Derivados: formato de CoinMarketCap

Contratos perpetuos en el formato de derivados de CoinMarketCap: contratos, especificaciones de contratos y libro de órdenes.

GET /api/v1/contracts

Todos los contratos perpetuos con precio, volumen de 24 horas, mejor oferta y demanda, interés abierto, comisiones y especificaciones del contrato (CoinMarketCap B1, con los campos B2 incluidos).

GET /api/v1/contract_specs

Especificaciones del contrato por ticker_id (CoinMarketCap B2). Los contratos son lineales (Vanilla): un contrato equivale a una unidad de la moneda base, con precio y liquidación en la moneda cotizada.

GET /api/v1/orderbook/{ticker_id}

Libro de órdenes de un contrato perpetuo (CoinMarketCap B3). Acepta los mismos parámetros de profundidad y nivel que el libro de órdenes spot.

Lo que debes saber

  • Yubbit.com puede reducir la velocidad de los datos cuando sea necesario.
  • Esta API es de solo lectura. No expone datos de cuentas, saldos ni órdenes, y no puede realizar operaciones.
  • El límite de solicitudes se aplica por IP. Si se supera, se devuelve un error 429 con una cabecera Retry-After.
  • Los endpoints mantienen la compatibilidad con versiones anteriores; los cambios incompatibles se publicarían en una versión como /api/v2.