Tu saldo disponible para dispersar

GET/treasury/positionProbar

ServidorURL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)

Parámetros de consultaassetPor defecto `BS`, que es el activo con el que se dispersa

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

GET

/treasury/position

const url = 'http://localhost:3000/v1/treasury/position?asset=BS';
const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'http://localhost:3000/v1/treasury/position?asset=BS' \
  --header 'x-api-key: <x-api-key>'

Scope treasury:read. Dos cifras: el saldo con el que dispersas (prefundingBalance) y lo que debes ahora mismo (creditDrawn).

Con cierre diario (creditEnabled: true) no fondeas por adelantado: prefundingBalance se queda en 0 —normal, no es una alarma— y creditDrawn crece durante el día hasta que liquidas en el cierre.

Prefondeado (creditEnabled: false): creditDrawn es siempre 0 y una dispersión sin saldo se rechaza con 422 insufficient_tenant_funds antes de tocar el riel.

Authorizations

ApiKeyAuth

Parameters

Query Parameters

asset

string

Allowed values: BS USD USDC VESC

Por defecto BS, que es el activo con el que se dispersa

Responses

200

Posición del tenant

application/json

object

tenantId

string format: uuid

asset

string

Allowed values: BS USD USDC VESC

prefundingBalance

Minor units disponibles para dispersar

string

platformRevenueFromTenant

string

creditEnabled

true = operas con cierre diario y no te bloqueamos por saldo. false = prefondeado.

boolean

creditDrawn

Lo que debes ahora mismo, en minor units y en positivo. Es lo que se liquida en el cierre. 0 si estás al día.

string

creditLimit

Techo acordado de tu línea. null si no hay techo

string

nullable

creditAvailable

Lo que te queda de la línea. null si no hay techo

string

nullable

Examples

Con cierre diario, a media jornada

{
  "tenantId": "3f1a0c22-9b41-4a77-8f0e-6d2c5b7a1e34",
  "asset": "BS",
  "prefundingBalance": "0",
  "platformRevenueFromTenant": "415900",
  "creditEnabled": true,
  "creditDrawn": "4537190",
  "creditLimit": null,
  "creditAvailable": null
}

Prefondeado

{
  "tenantId": "3f1a0c22-9b41-4a77-8f0e-6d2c5b7a1e34",
  "asset": "BS",
  "prefundingBalance": "500000000",
  "platformRevenueFromTenant": "415900",
  "creditEnabled": false,
  "creditDrawn": "0",
  "creditLimit": null,
  "creditAvailable": null
}