Método para obtener transacciones de compra/venta del usuario
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 cotizada
En 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.
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.