data_object API v1 · REST & WEBSOCKET

API Docs

Integra datos de mercado en vivo, cuentas y órdenes de Cripto Andes directamente en tu aplicación.

https://api.criptoandes.com/v1

Introducción

La API de Cripto Andes te permite consultar precios en tiempo real, gestionar tu cuenta y ejecutar órdenes de forma programática. Todas las respuestas se entregan en formato JSON sobre HTTPS.

dns Base URL api.criptoandes.com/v1

description Formato JSON · UTF-8

bolt Versión actual v1 (estable)

Autenticación

Los endpoints públicos (precios, order book, trades) no requieren autenticación. Para endpoints privados (cuenta, órdenes, wallet) genera una API Key desde tu panel y envíala en el encabezado X-API-KEY de cada solicitud.

curl -X GET "https://api.criptoandes.com/v1/account" \
  -H "X-API-KEY: tu_api_key"
  -H "X-API-SECRET: tu_api_secret"

⚠️ Nunca compartas tu API Secret ni lo incluyas en código del lado del cliente (frontend).

Límites de tasa

Cada API Key tiene los siguientes límites por defecto. Si los superas, recibirás un código 429.

Tipo de endpoint	Límite	Ventana
Endpoints públicos	60 solicitudes	por minuto
Endpoints privados	120 solicitudes	por minuto
Creación de órdenes	30 solicitudes	por minuto
Conexiones WebSocket	5 conexiones	simultáneas

Endpoints · Mercado

Datos públicos de mercado. No requieren autenticación.

GET /v1/ticker/{symbol} Precio y variación 24h de un par

GET /v1/orderbook/{symbol} Libro de órdenes (bids y asks)

GET /v1/trades/{symbol} Últimas operaciones ejecutadas

GET /v1/markets Lista de todos los pares disponibles

Respuesta de ejemplo

{
  "symbol": "BTCUSDT",
  "price": "64512.30",
  "change_24h": "0.38",
  "high_24h": "65157.42",
  "low_24h": "63867.18",
  "volume_24h": "32412000"
}

Endpoints · Cuenta y Wallet

Requieren autenticación con tu API Key.

GET /v1/account Información general de la cuenta

GET /v1/balances Saldos disponibles por moneda

GET /v1/deposits Historial de depósitos

GET /v1/withdrawals Historial de retiros

Endpoints · Órdenes

Crea, consulta y cancela órdenes de compra/venta. Requieren autenticación.

POST /v1/orders Crear una nueva orden

GET /v1/orders Listar órdenes abiertas

GET /v1/orders/{id} Detalle de una orden

DELETE /v1/orders/{id} Cancelar una orden

Cuerpo de la solicitud · POST /v1/orders

{
  "symbol": "BTCUSDT",
  "side": "buy",
  "type": "limit",
  "price": "64500.00",
  "amount": "0.05"
}

WebSockets en tiempo real

Suscríbete a canales para recibir precios, order book y trades sin necesidad de hacer polling.

const ws = new WebSocket("wss://ws.criptoandes.com/v1/stream");

ws.onopen = () => {
  ws.send(JSON.stringify({
    action: "subscribe",
    channels: ["ticker@BTCUSDT", "orderbook@BTCUSDT"]
  }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  console.log(msg);
};

ticker@{symbol} Precio y cambio 24h en vivo

orderbook@{symbol} Actualizaciones del libro de órdenes

trades@{symbol} Operaciones ejecutadas en vivo

Códigos de error

Código	Significado
200	OK — la solicitud se procesó correctamente
400	Bad Request — parámetros inválidos o faltantes
401	Unauthorized — API key inválida o ausente
403	Forbidden — permisos insuficientes para esta acción
404	Not Found — el recurso solicitado no existe
429	Too Many Requests — superaste el límite de tasa
500	Internal Server Error — error inesperado del servidor

Ejemplos de código

Cómo consultar el precio de BTC/USDT en distintos lenguajes.

curl -X GET "https://api.criptoandes.com/v1/ticker/BTCUSDT" \
  -H "X-API-KEY: tu_api_key"

const res = await fetch("https://api.criptoandes.com/v1/ticker/BTCUSDT", {
  headers: { "X-API-KEY": "tu_api_key" }
});
const data = await res.json();
console.log(data);

import requests

url = "https://api.criptoandes.com/v1/ticker/BTCUSDT"
headers = {"X-API-KEY": "tu_api_key"}

response = requests.get(url, headers=headers)
print(response.json())

¿Necesitas ayuda con la integración?

Nuestro equipo técnico responde dudas de desarrolladores todos los días.

Contactar soporte