API

Tema

VectrakpitalAPI

Saldos, cotizaciones, cambios, depósitos y retiros. La misma superficie que usa el portal, con una llave.

Empezar
Referencia
Vectrakpital

Montos enteros, en cadena, con decimales por activo

Todo monto es un entero en unidades mínimas y viaja entre comillas, porque un monto en pesos no cabe exacto en un número JSON. Los decimales son del activo y del mercado que lo reporta; léelos de la respuesta.

El modelo de montos

Nada se mueve solo

Un cambio o un retiro que creas es una solicitud. Una persona la aprueba, y sólo entonces sale el dinero. Un 201 no significa hecho.

Lo que espera a una persona

Tu llave es una delegación

Autentica como la persona que la emitió. Si a esa persona le reducen permisos, la llave se reduce con ella en la siguiente petición.

Autenticación y alcances

Qué reintentar

Toda respuesta trae un código estable. Unos fallos son de red y se reintentan; otros son el mundo diciendo que no, y no cambian por insistir.

Errores y reintentos

En una línea ​

bash
curl $VECTRAKPITAL_API/api/v1/client \
  -H "X-API-Key: vk_live_3f9a1c72b40de5a1.hR8xK2mQ..."
json
{
  "success": true,
  "data": {
    "name": "Acme Trading SAS",
    "status": "active",
    "canOperate": true,
    "permissions": ["portal:read", "portal:trade"]
  }
}

permissions es lo primero que conviene leer: es la intersección entre los alcances de tu llave y el puesto de quien la emitió, que es exactamente lo que el servidor exige. Si más tarde una llamada responde 403, compárala contra esto antes de suponer un fallo.

Antes de escribir código ​

Tres cosas deciden si una integración funciona, y las tres son fáciles de pasar por alto.

Los montos son enteros, viajan como cadena, y los decimales son del activo

"10000000000" no son diez mil millones: son 10 000 USDT, porque en este corredor USDT lleva 6 decimales. Lee assetDecimals de la respuesta y no lo fijes en tu código — el mismo símbolo lleva otra escala en otro mercado.

Y va entre comillas: COPM lleva 18 decimales, así que un monto ordinario en pesos supera con nueve órdenes de magnitud el entero más grande que JSON representa exacto. Enviado como número no falla, llega redondeado, y sigue siendo un monto válido.

Un 201 no significa que el dinero se movió

Todo cambio y todo retiro los aprueba una persona en Vectrakpital, sin un umbral por debajo del cual sea automático. Consulta el estado; no des por hecho que crear la solicitud fue el final.

Una llave puede estrecharse sin que la toques

Se emite desde el puesto de una persona y se interseca con ese puesto en cada petición. Si esa persona cambia de rol o se va, la llave lo nota. Emítelas desde un puesto que vaya a durar más que la integración.

Dónde probar ​

Hay un sandbox con los mismos endpoints y el mercado apagado, e independiente de producción: base distinta, llaves distintas. Empieza ahí — en producción cada solicitud que crees le llega a una persona.

URL base
Sandboxhttps://sanbox-exchange-back.vectrakpital.com
Producciónhttps://back.vectrakpital.com

Lo que no se comporta igual está en entornos, y vale la pena leerlo antes que después: las direcciones de depósito de sandbox no son direcciones reales, y la conciliación siempre cuadra ahí, así que un verde no significa lo que parece.