Skip to content

Refresh Balance

This endpoint allows you to ask the server to re-fetch on-chain balances for one of your trading vaults.

Request URL

https://ddp.definitive.fi/v1/trade/refresh_balance

Request Body

{
  "vaultId": "00000000-0000-0000-0000-000000000001", // UUID - optional, if provided, skips portfolio lookup
  "chain":   "base"                                 // optional, if vaultId is provided
}

Response

{
  "vaultId": "00000000-0000-0000-0000-000000000001"
}

Example

// by chain:
const resp1 = await AuthHelpers.request({
  path: "/v1/trade/refresh_balance",
  method: "POST",
  apiKey: API_KEY,
  apiSecret: API_SECRET,
  body: {
    chain: "base",
  },
});
 
// by vaultId:
const resp2 = await AuthHelpers.request({
  path: "/v1/trade/refresh_balance",
  method: "POST",
  apiKey: API_KEY,
  apiSecret: API_SECRET,
  body: {
    vaultId: "00000000-0000-0000-0000-000000000001",
  },
});