Método para obtener transacciones de compra/venta del usuario
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Request
Query Params:
| Param | Type | Required | Value |
|---|---|---|---|
| assetFormat | string | No | Formato de monedas crypto: base o rebased |
Response
Los siguientes corresponden a los atributos del objeto:
| Field | Type | Value |
|---|---|---|
| id | string | Identificador del convert |
| transactionId | string | Identificador de la transacción |
| type | string | Tipo de transacción, en este caso siempre "CONVERT" |
| subType | string | Tipo de convert, puede ser "BUY" o "SELL" |
| qtyCurrencyId | string | Identificador de la moneda que define la cantidad o "quantity" |
| baseCurrencyId | string | Moneda base del mercado |
| quoteCurrencyId | string | Moneda cotizada del mercado |
| quantity | string | Monto gastado o recibido |
| rate | string | Tipo de cambio de la operación |
| status | string | Estado de la transferencia, puede ser "PENDING", "COMPLETED", "FAILED" |
| createdAt | Datetime ISO8601 | Fecha de ejecución del convert |
Moneda base vs moneda cotizadaEn los mercado de compra/venta, la moneda base es la que se desea comprar o vender, mientras que la moneda cotizada es con la que se realiza el intercambio. Por ejemplo, en el par BTC/CLP, BTC es la moneda base y CLP la cotizada, indicando cuántas unidades de CLP se necesitan para adquirir 1 BTC.
Con esto, el atributo subType siempre indica la intención ("BUY" o "SELL") respecto a la moneda base, mientras que el rate son las unidades en la moneda cotizada que se necesitan para adquirir 1 de la moneda base.
Relación con órdenes de convertCada transacción de convert pertenece a una orden de convert (
/v1/convert_orders). Una orden puede generar una o más transacciones. La relación entre ambos se establece a través del campoclOrdId.Para consultar la orden asociada a una transacción, usa el endpoint Orden de convert por clOrdId con el valor del campo
clOrdId.
Además
Para consultar un convert en particular se puede hacer uso del endpoint:
GET /v1/converts/{id}/idPara consultar las dos contrapartes de un convert, es decir, el lado de la compra y la venta, se puede hacer uso del endpoint:
GET /v1/converts/{transactionId}
Recuerda que puedes revisar todos los endpoints del API y sus referencias en Swagger.