Preguntas Frecuentes

¿Qué APIs soporta Backpack?

Backpack ofrece dos formas de integración, según si necesitas acciones de solicitud/respuesta o datos en streaming en tiempo real.

API REST

Usa la API REST para acciones bajo demanda, como obtener datos de mercado/cuenta y gestionar órdenes.

Los endpoints comunes incluyen:

• GET /markets

• GET /balances

• POST /orders

• DELETE /orders

API WebSocket

Usa la API WebSocket para streams en tiempo real de baja latencia

Casos de uso comunes incluyen:

• Suscribirse a actualizaciones del libro de órdenes

• Suscribirse a streams de velas (kline)

• Suscribirse a eventos de cuenta autenticados (p. ej., actualizaciones de órdenes y posiciones)

¿Se puede usar la API para operar futuros?

Sí. Backpack soporta tanto spot como futuros perpetuos mediante los mismos endpoints de órdenes y cuenta. Para operar perps, usa un símbolo de mercado perp Por ejemplo: POST /orders - SOL_USDC_PERP

¿Puedo retirar activos usando la API?

Para habilitar retiros, se requieren controles de seguridad estrictos (incluida la autenticación de dos factores).

Para configurar una dirección de retiro con 2FA obligatoria, usa: https://backpack.exchange/settings/withdrawal-addresses?twoFactorWithdrawalAddress=true

El parámetro twoFactorToken (https://docs.backpack.exchange/#tag/Capital/operation/request_withdrawal:~:text=asset%20to%20withdraw.-,twoFactorToken,-string)is currently disabled

¿Cuáles son los rate limits de la API? ¿Son diferentes por servidor o por subcuenta?

Los rate limits se aplican por subcuenta, no por servidor. Por defecto, cada subcuenta puede hacer hasta 2000 solicitudes por minuto en los endpoints REST estándar Los endpoints de datos históricos de mercado están limitados a 30 solicitudes por minuto por subcuenta. (“Endpoints históricos” se refiere a rutas REST que devuelven datos por rango de tiempo, como velas/trades).

Si alcanzas un límite, recibirás respuestas HTTP 429. Considera usar streams de WebSocket para datos de mercado de alta frecuencia.

¿Qué errores comunes ocurren al colocar órdenes?

Código de Error	Descripción	Resolución
INVALID_CLIENT_REQUEST'	Invalid signature	Verifica el método de construcción del query string (ordenamiento, valor de instrucción). También confirma que los valores booleanos en el query string estén en minúsculas. “True” debe ser “true”..
INVALID_CLIENT_REQUEST'	Request has expired	El tiempo que tardó la solicitud en llegar a los servidores del exchange excedió los valores de X-Window y window. Intenta aumentar la ventana
INVALID_CLIENT_REQUEST'	Quantity decimal too long	Ajusta la cantidad al stepSize
INVALID_CLIENT_REQUEST'	Invalid X-Signature Header	El query string se firmó con el par de claves incorrecto. Verifica que estés usando ED25519
429	Too many requests	Reduce la frecuencia de solicitudes; considera usar streaming vía WebSocket

¿Dónde puedo encontrar SDKs?

El SDK oficial actualmente solo está disponible en Rust: https://github.com/backpack-exchange/bpx-api-client Consulta la siguiente página para ver ejemplos mantenidos por la comunidad en varios lenguajes: https://support.backpack.exchange/exchange/api-and-developer-docs/api-clients

¿Cómo puedo obtener datos de mercado en tiempo real para un par de trading?

Usa streams de WebSocket para actualizaciones de mercado en vivo:

Book Ticker (bookTicker.<symbol>) Mejores precios bid/ask y cantidades en tiempo real. Ideal para mostrar el top del libro de órdenes.

Depth (depth.<symbol>) Actualizaciones incrementales del libro de órdenes. Primero obtén un snapshot inicial vía REST y luego aplica los deltas de profundidad del stream. Depth está disponible en tiempo real o en modos agregados (p. ej., 200 ms / 600 ms / 1000 ms) para reducir tráfico. Consulta la lista completa de streams aquí: https://docs.backpack.exchange/#tag/Streams

¿Cómo puedo mejorar la estabilidad de mi bot de trading?

Mejores prácticas recomendadas:

• Preferir suscripciones WebSocket para actualizaciones en tiempo real de órdenes/trades en lugar de hacer polling al REST

• Implementar reintentos + backoff exponencial para solicitudes REST y reconexiones de WS

• Mantener un caché local de datos de referencia usados con frecuencia (mercados, símbolos, filtros) y refrescarlo periódicamente

• Monitorear y alertar sobre errores críticos de la API (fallos de autenticación, solicitudes expiradas y 429 rate limits)