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_USDTDatos 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.
