API Coinbase

Coinbase

 

APIs admitidas

• WebSockets API: conéctese a un servidor websocket público y obtenga actualizaciones de datos de mercado en tiempo real.
• API REST: la API REST dispone de puntos finales para la gestión de cuentas y órdenes, así como datos de mercado públicos.

 

 

Usos más comunes

• WebSockets API
  • Cómo conectarse a la WebSocket API
  • Cómo suscribirse a un canal WebSocket

• REST API

  • Cómo obtener datos de mercado
  • Cómo usar la REST API privada
  • Cómo realizar órdenes
  • Cómo usar la cuenta SandBox
  • Tiempo de solicitudes privadas

 

WebSockets API

El feed WebSocket está disponible públicamente y proporciona actualizaciones de datos de mercado en tiempo real para órdenes y operaciones. Se admiten dos endpoints en producción:

 

• Market Data es el feed que proporciona actualizaciones tanto de órdenes como de operaciones. La mayoría de los canales están disponibles ahora sin autenticación.
• Datos de pedidos del usuario proporciona actualizaciones sobre los pedidos del usuario.

 

Puede suscribirse a los siguientes canales:

 

Método	Argumentos	Descripción
SubscribeHeartBeat		Pings del servidor en tiempo real para mantener todas las conexiones abiertas
SubscribeStatus	aProductId: id del producto	Envía todos los productos y divisas en un intervalo predefinido
SubscribeCandles	aProductId: id del producto	Actualizaciones en tiempo real de velas de producto
SubscribeTicker	aProductId: id del producto	Actualizaciones de precio en tiempo real cada vez que se produce una coincidencia
SubscribeTickerBatch	aProductId: id del producto	Actualizaciones de precio en tiempo real cada 5000 milisegundos
SubscribeLevel2	aProductId: id del producto	Todas las actualizaciones y la forma más sencilla de mantener la instantánea del libro de órdenes
SubscribeMarketTrades	aProductId: id del producto	Actualizaciones en tiempo real cada vez que se produce una operación de mercado
SubscribeUser	aProductId: id del producto	Solo envía mensajes que incluyan al usuario autenticado
SubscribeFuturesBalanceSummary		Actualizaciones en tiempo real cada vez que cambia el saldo de futuros de un usuario

 

Los canales User y FuturesBalanceSummary requieren autenticación, por lo que primero deberá solicitar sus claves API en su cuenta de Coinbase y luego establecer los valores en la propiedad Coinbase del componente:

 

• ApiKey

• ApiSecret

 

La autenticación proporcionará una serie de ventajas:

1. Los mensajes en los que usted es una de las partes se expanden y tienen campos más útiles
2. Recibirá mensajes privados, como información del ciclo de vida sobre las órdenes stop que haya colocado

 

 

 

REST API

Endpoints Privados

Los endpoints privados están disponibles para la gestión de órdenes y la gestión de cuentas.

Antes de poder firmar cualquier solicitud, debe crear una clave API a través del sitio web de Coinbase Pro. La clave API estará asociada a un perfil específico. Al crear una clave, dispondrá de 3 datos que debe recordar:

 

• Clave
• Secreto
• Frase de contraseña

 

La clave y el secreto serán generados aleatoriamente y proporcionados por Coinbase Pro; la frase de contraseña será proporcionada por usted para proteger aún más el acceso a su API. Coinbase Pro almacena el hash salado de su frase de contraseña para verificación, pero no puede recuperarla si la olvida.

 

Puede restringir la funcionalidad de las claves API. Antes de crear la clave, debe elegir los permisos que desea que tenga. Los permisos son:

 

• Ver - Permite permisos de lectura de una clave. Esto incluye todos los endpoints GET.
• Transfer - Permite a una clave transferir divisa en nombre de una cuenta, incluyendo depósitos y retiros. Habilítelo con precaución: las transferencias de claves API OMITIRÁN la autenticación de dos factores.
• Trade - Permite a una clave introducir órdenes, así como recuperar datos de operaciones. Esto incluye POST /orders y varios endpoints GET.

 

Cuentas

 

Método	Arguments	Descripción
ListAccounts		Obtiene una lista de cuentas de trading del perfil de la clave API.
GetAccount	aAccountId: identificador de la cuenta	Información de una única cuenta. Utilice este endpoint cuando conozca el account_id. La clave API debe pertenecer al mismo perfil que la cuenta.

 

Órdenes

 

Método	Arguments	Descripción
PlaceNewOrder	aOrder: clase que contiene todos los campos posibles de una orden	Coloca una nueva orden. Úselo solo si necesita acceder a opciones avanzadas de órdenes.
PlaceMarketOrder	aSide: compra o venta aProductId: identificador del producto aQuoteSize: La cantidad del segundo activo en el par de trading. aBaseSize: La cantidad del primer activo en el par de negociación aClient_oid: ID de orden seleccionado por usted para identificar su orden	Coloca una nueva orden de mercado.
PlaceLimitOrder	aSide: compra o venta aProductId: identificador del producto aQuoteSize: La cantidad del segundo activo en el par de trading. aBaseSize: La cantidad del primer Activo en el Par de Trading aLimitPrice: precio límite Client_oid: ID de orden seleccionado por usted para identificar su orden	Coloca una nueva orden Limit.
PlaceStopOrder	aSide: compra o venta ProductId: id del producto aBaseSize: La cantidad del primer activo en el par de trading StopPrice: precio de la orden stop aLimitPrice: precio límite aStopDirection: pérdida o entrada Client_oid: ID de orden seleccionado por usted para identificar su orden	Coloca una nueva orden de stop
CancelOrder	aOrderId: id de la orden	Cancela una orden colocada previamente. La orden debe pertenecer al perfil al que pertenece la clave API.
EditOrder	aOrderId: id de la orden aPrice: precio aSize: Cantidad	Editar una orden con un nuevo tamaño o un nuevo precio especificado
EditOrderPreview	aOrderId: id de la orden aPrice: precio aSize: Cantidad	Previsualizar una solicitud de edición de orden con un nuevo tamaño o un nuevo precio especificados.
ListOrders		Obtiene una lista de pedidos filtrada por parámetros de consulta opcionales (product_id, order_status, etc).
GetOrder	aOrderId: id de la orden	Obtener una orden individual por ID de orden.
PreviewOrder		Vista previa de una orden.
ClosePosition	aOrderId: id de la orden aProductId: id del producto aSize: cantidad	Coloca una orden para cerrar cualquier posición abierta de un product_id especificado.

 

 

 

 

Datos de Mercado

 

Método	Arguments	Descripción
GetPublicProducts		Obtener una lista de los pares de divisas disponibles para operar.
GetPublicProduct	aProductId: id del producto	Obtiene información de un único producto mediante su ID de producto.
GetPublicProductBook	aProductId: id del producto	Obtiene una lista de ofertas/demandas para un único producto. El nivel de detalle mostrado puede personalizarse con el parámetro limit.
GetPublicProductCandles	aProductId: id del producto aStart: inicio del intervalo de tiempo aEnd: fin del intervalo de tiempo aGranularity: El marco temporal que representa cada vela.	Obtiene las tasas de un producto específico por ID de producto, agrupadas en intervalos.
GetTrades	aProductId: id del producto	Obtenga información de instantánea por ID de producto sobre las últimas operaciones (ticks) y la mejor oferta/demanda.
GetTime		Obtiene la hora actual de la API avanzada de Coinbase.

 

 

Rellenos

 

Método	Arguments	Descripción
GetFillsByOrderId		Obtener una lista de ejecuciones filtrada por id de orden
GetFillsByProductId		Obtener una lista de operaciones filtradas por ID de producto
GetFillsByTradeId		Obtener una lista de ejecuciones filtradas por identificador de operación

Convertir

Método	Arguments	Descripción
CreateConvertQuote		Crea una cotización de conversión entre divisas.
CommitConvertTrade		Confirmar una operación de conversión.
GetConvertTrade		Obtener detalles de la operación de conversión.

Tarifas

Método	Arguments	Descripción
GetTransactionSummary		Obtener el resumen de comisiones de transacción.

Productos (autenticados)

Método	Arguments	Descripción
ListProducts		Listar los productos disponibles.
GetProduct	aProductId: id del producto	Obtener un producto específico.
GetProductBook	aProductId: id del producto	Obtiene el libro de órdenes del producto.
GetProductCandles	aProductId: id del producto	Obtener velas OHLCV del producto.
GetMarketTrades	aProductId: id del producto	Obtener las operaciones de mercado recientes.
GetBestBidAsk		Obtiene los mejores precios de oferta/demanda.

Carteras

Método	Arguments	Descripción
ListPortfolios		Listar todos los portafolios.
CreatePortfolio		Crear una nueva cartera.
DeletePortfolio		Eliminar una cartera.
GetPortfolioBreakdown		Obtener el desglose detallado de la cartera.
MovePortfolioFunds		Mover fondos entre carteras.

Perpetuos

Método	Arguments	Descripción
GetPerpetualsPortfolioSummary		Obtener el resumen del portfolio de perpetuos.
ListPerpetualsPositions		Listar posiciones de perpetuos.
GetPerpetualsPosition		Obtenga una posición de perpetuos específica.