API Crypto.com

Crypto.com

APIs admitidas

• WebSocket API: conéctese a un servidor websocket y obtenga actualizaciones de datos de mercado en tiempo real, cambios de cuenta y más.
• REST API: envíe solicitudes HTTP para obtener datos de mercado, colocar órdenes, datos de cuenta...

Propiedades

Utilice la propiedad Channel para seleccionar el tipo de canal:

• cccMarket: conectarse a la API WebSocket de mercado para datos de mercado públicos.
• cccUser: se conecta a la API WebSocket de usuario para datos privados de cuenta (requiere autenticación).

Puede configurar las siguientes propiedades en la propiedad CryptoCom.

• ApiKey: puede solicitar una nueva clave API en su cuenta de Crypto.com; simplemente copie el valor en esta propiedad. Requerida para canales privados y llamadas autenticadas a la API REST.
• ApiSecret: es el valor secreto de la api.
• Resubscribe: si está habilitado, tras una reconexión el cliente se suscribe de nuevo automáticamente a los canales que estaban activos antes de la desconexión (por defecto false).

Conexión

Cuando el cliente se conecta correctamente a los servidores de Crypto.com, se lanza el evento OnConnect. Una vez lanzado el evento OnConnect, puede comenzar a enviar y recibir mensajes hacia/desde los servidores de Crypto.com. Si se conecta al canal de usuario, debe esperar a que se lance el evento OnCryptoComAuthentication y comprobar que el parámetro success es true antes de suscribirse a cualquier canal privado.

oClient := TsgcWebSocketClient.Create(nil);
oCryptoCom := TsgcWS_API_CryptoCom.Create(nil);
oCryptoCom.Client := oClient;
oCryptoCom.CryptoCom.ApiKey := 'your_api_key';
oCryptoCom.CryptoCom.ApiSecret := 'your_api_secret';
oCryptoCom.Channel := cccMarket;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#CryptoCom Connected');
end;

Eventos

El cliente Crypto.com implementa los siguientes eventos para controlar el flujo de conexión y obtener los datos enviados desde el servidor WebSocket:

• OnConnect: se activa cuando el cliente websocket se conecta al servidor WebSocket.
• OnDisconnect: se dispara cuando el cliente WebSocket se desconecta del servidor WebSocket.
• OnCryptoComAuthentication: se dispara cuando el cliente se autentica contra el servidor WebSocket privado.
• OnCryptoComSubscribe: se llama cuando el cliente se suscribe a un canal websocket.
• OnCryptoComUnSubscribe: cuando el cliente cancela la suscripción a un canal WebSocket.
• OnCryptoComData: cuando el cliente recibe datos del servidor.
• OnCryptoComError: cuando se produce algún error durante la conexión websocket de Crypto.com.
• OnCryptoComHTTPException: cuando se produce algún error durante la solicitud REST.

WebSocket API

El feed WebSocket proporciona actualizaciones de datos de mercado en tiempo real para órdenes y operaciones.

Puede suscribirse a los siguientes canales de mercado (públicos):

Método	Descripción
SubscribeTicker	Suscribirse al flujo de ticker de un instrumento. Proporciona datos de precio y volumen en tiempo real.
SubscribeTrade	Suscribirse al stream de operaciones recientes de un instrumento.
SubscribeCandlestick	Suscríbase al flujo de velas japonesas. Admite múltiples intervalos (p. ej., 5m, 15m, 30m, 1h, 4h, 1D).
SubscribeBook	Suscríbase al flujo del libro de órdenes. Admite niveles de profundidad configurables (p. ej., 10, 50).

Puede suscribirse a los siguientes canales de usuario (privados, requieren autenticación):

Método	Descripción
SubscribeOrders	Suscribirse a actualizaciones de órdenes. Opcionalmente, filtrar por nombre de instrumento.
SubscribeUserTrades	Suscribirse a actualizaciones de operaciones del usuario. Opcionalmente, filtrar por nombre de instrumento.
SubscribeBalance	Suscríbase a las actualizaciones de saldo de su cuenta.

Vea a continuación un ejemplo de suscripción a canales de mercado.

procedure OnConnect(Connection: TsgcWSConnection);
begin
  oCryptoCom.SubscribeTicker('BTC_USDT');
  oCryptoCom.SubscribeBook('BTC_USDT', '10');
end;

REST API

La API REST proporciona métodos públicos y privados para solicitar datos de mercados y cuentas privadas. Acceda a la API REST a través de la propiedad REST_API del componente.

Método	Público / Privado	Descripción
GetInstruments	Público	Obtener la lista de instrumentos disponibles.
GetTicker	Público	Obtener información del ticker para uno o todos los instrumentos.
GetOrderBook	Público	Obtiene el libro de órdenes para un instrumento.
GetTrades	Público	Obtiene las operaciones más recientes de un instrumento.
GetCandlestick	Público	Obtiene datos de velas/kline para un instrumento.
CreateOrder	Privado	Crear una nueva orden. Admite órdenes limitadas y de mercado.
CancelOrder	Privado	Cancela una orden existente.
CancelAllOrders	Privado	Cancela todas las órdenes abiertas de un instrumento.
GetOpenOrders	Privado	Obtener la lista de órdenes abiertas.
GetOrderDetail	Privado	Obtener detalles de un pedido específico.
GetOrderHistory	Privado	Obtener el historial de órdenes.
GetAccountSummary	Privado	Obtener información resumida de la cuenta.

A continuación se muestra un ejemplo del uso de la REST API.

oCryptoCom := TsgcWS_API_CryptoCom.Create(nil);
oCryptoCom.CryptoCom.ApiKey := 'your_api_key';
oCryptoCom.CryptoCom.ApiSecret := 'your_api_secret';
// Get instruments
oCryptoCom.REST_API.GetInstruments;
// Create an order
oCryptoCom.REST_API.CreateOrder('BTC_USDT', 'BUY', 'MARKET', '', '0.001');
// Get account summary
oCryptoCom.REST_API.GetAccountSummary;