> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Position

> One wallet's shares and their current value

A small read for portfolio displays: the wallet's share balance, that balance at the current share price, and the share price itself. If you want the vault's full state alongside a position, use [Get Vault](/endpoints/vaults/get-vault) with `?address=`.

## Path Parameters

<ParamField path="vaultId" type="string" required>Vault ID.</ParamField>
<ParamField path="holderAddress" type="string" required>Wallet to read. Must be a valid `0x` address. Anything else answers `VALIDATION_ERROR` without touching the chain.</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="vaultId" type="string">The vault read.</ResponseField>
    <ResponseField name="holder" type="object">`holderAddress`, `shares`, `sharesRaw`, `value`, `readFailed`. When `readFailed` is true, `shares` and `value` are `null`, not zero.</ResponseField>
    <ResponseField name="sharePrice" type="string">Current share price as an 18-decimal string, or `null` when the vault read failed.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/lending-external-securities/api/vaults/{vaultId}/position/0x5ad87a0621175206b72d10e4b8577b192e7f40ab" \
    -H "X-API-Key: trusset_your_key_here"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    `https://api.trusset.org/lending-external-securities/api/vaults/${vaultId}/position/${wallet}`,
    { headers: { 'X-API-Key': 'trusset_your_key_here' } }
  );
  const { data } = await res.json();
  if (!data.holder.readFailed) {
    console.log(`${data.holder.shares} shares worth ${data.holder.value}`);
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "vaultId": "cmssh8t2u0003cghxkx1w1fwd",
      "holder": {
        "holderAddress": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab",
        "shares": "1000.0",
        "sharesRaw": "1000000000",
        "value": "1012.5",
        "readFailed": false
      },
      "sharePrice": "1.0125"
    }
  }
  ```
</ResponseExample>