Refresh Balance

Forces a refresh of a portfolio's vault balance data from the blockchain. You must specify either a vault ID or a chain to refresh.

Endpoint

Organization API only — this endpoint requires an organization-level API key.

POST https://ddp.definitive.fi/v2/organization/portfolios/{portfolioId}/balance/refresh

Path Parameters

Parameter	Type	Required	Description
portfolioId	string	Yes	UUID of the portfolio

Request Body

Field	Type	Required	Description
vaultId	string	No	UUID of a specific vault to refresh
chain	string	No	Chain identifier (e.g. `ethereum`) — used to auto-select the vault for chain

⚠️ You must provide at least one of: vaultId or chain. If neither is provided, the request will fail.

Request Body Examples

Refresh by Chain

const json = await AuthHelpers.signAndSend({
  path: "/v2/organization/portfolios/00000000-0000-0000-0000-000000000001/balance/refresh",
  method: "POST",
  body: {
    chain: "ethereum",
  },
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET,
});

Refresh by Vault ID

const json = await AuthHelpers.signAndSend({
  path: "/v2/organization/portfolios/00000000-0000-0000-0000-000000000001/balance/refresh",
  method: "POST",
  body: {
    vaultId: "00000000-0000-0000-0000-000000000003",
  },
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET,
});

Response

{
  vaultId: "00000000-0000-0000-0000-000000000003";
}

Notes

If chain is provided, the API will automatically resolve the correct vault on that chain.
If multiple vaults exist for the chain, the first matching one is selected.
This operation may take a few seconds depending on the underlying chain’s confirmation time.