Datos de Supra. Diseñados para integrarse.

Acceso comercial, documentación pública

La documentación de Supra Core y la especificación OpenAPI son públicas. El servicio API es comercial y autenticado: cada solicitud, incluida health, requiere una clave API válida asociada a un acceso habilitado. Los planes disponibles, usos permitidos y condiciones comerciales se acuerdan por separado con TCP Labs.

Usa el contrato público para evaluar una integración antes de solicitar acceso. El servicio es de solo lectura: no ejecuta operaciones, firma transacciones, gestiona wallets ni custodia activos. Los bots que lo utilicen deben limitarse a supervisión, análisis y notificaciones.

Endpoints de solo lectura

Todas las rutas siguientes usan GET. Las listas de eventos FA y Legacy permanecen separadas; los eventos farm se incluyen en las respuestas de eventos de liquidez.

Mantén los precios e importes DECIMAL como cadenas exactas. Conserva los valores no disponibles y sus motivos; una respuesta correcta vacía no es un error. Para mostrar valores en USD usa change_24h_usd_pct, no la variación separada denominada en el par. Los puntos arrastrados del gráfico no actualizan un mercado inactivo. Consulta el contrato de cada endpoint para filtros, paginación y campos de evidencia.

Autenticación y primera solicitud

Envía X-API-Key o Authorization: Bearer. Guarda las claves del servicio en tu backend, no en un paquete público del navegador ni en una URL. En el acceso autenticado mediante base de datos, la clave, el cliente y el plan deben estar habilitados; se comprueban la caducidad y las IP permitidas.

El ejemplo lee la URL base y la clave del servicio desde tu entorno local. TCP Labs facilita la dirección del servicio junto con los datos de acceso. Esta página no contacta con la API.

curl --get "${SUPRA_CORE_API_BASE_URL}/api/v1/market/current" \
  --header "X-API-Key: ${SUPRA_CORE_API_KEY}" \
  --data-urlencode "network=mainnet" \
  --data-urlencode "limit=20" \
  --data-urlencode "offset=0"

Las respuestas correctas usan ok: true con data y meta. Los errores usan ok: false con un objeto error que contiene code y message. Los parámetros inválidos devuelven 400, la autenticación rechazada 401, una ruta desconocida 404 y un método no admitido 405.

Límites y solicitudes fiables

Los límites se asignan al plan habilitado. El limitador cuenta las solicitudes en ventanas fijas de un minuto y un día UTC por clave API e IP del cliente. Superar cualquiera de las cuotas devuelve 429 con RATE_LIMITED. El recuento incluye los intentos limitados; una ventana nueva inicia un contador nuevo. Son cuotas por ventana, no una espera obligatoria entre solicitudes.

burst_limit es informativo en el contrato actual: no es un límite aplicado a solicitudes simultáneas ni un contador burst separado. No deduzcas capacidad adicional. La cabecera Retry-After no está garantizada.

Lee la documentación API completa para consultar todos los parámetros, ejemplos y contratos de respuesta.

Ante un 429, reduce la carga y reintenta más tarde con espera progresiva limitada y variación aleatoria. Almacena en caché las lecturas compartidas y coordina los workers. No reintentes parámetros inválidos o claves rechazadas sin corregirlos. La paginación limita filas, no cuotas: los listados de mercado y eventos admiten hasta 500 filas por página; las rutas de velas y gráficos tienen sus propios límites documentados.