# Read holdings

Source: https://docs.tradeit.app/sdk/holdings

Fetch an account's holdings from your server using the user's [OAuth access token](/sdk/authentication) and an `account.id` from [Read accounts](/sdk/accounts).

**Scopes:** `brokerage:read tool:execute`.

## Server side: fetch positions [#server-side-fetch-positions]

```js
const response = await fetch('https://api.tradeit.app/api/tool/execute', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${accessToken}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool_name: 'get_holdings',
    params: { account_id: accountId },
  }),
});
if (!response.ok) throw new Error(`Holdings request failed: ${response.status}`);
const holdings = await response.json();
```

**Returns:** [Holding[]](/models/holding). See [Get holdings](/api/get-holdings#example-response) for a sample response.