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

# pUSD Balances

<div className="venue-tags" aria-label="Supported venues">
  <span className="venue-tag">Polymarket</span>
</div>

Returns the user's available, pending, and confirmed pUSD amounts. pUSD is the dollar-denominated
balance used for Polymarket trading through Notional.

## Endpoint

```text theme={null}
POST /info
```

## Request Body

| Parameter | Type   | Description                                                                     |
| --------- | ------ | ------------------------------------------------------------------------------- |
| `type`\*  | string | Must be `"polymarketBalances"`                                                  |
| `user`\*  | string | 20-byte EVM wallet address, e.g., `"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"` |

```json theme={null}
{
  "type": "polymarketBalances",
  "user": "0x1111111111111111111111111111111111111111"
}
```

## Response

<Tabs sync={false}>
  <Tab title="200: Available">
    ```json theme={null}
    {
      "balances": [
        {
          "assetIdHex": "800101c011a7e12a19f7b1f670d46f03b03f3342e82dfb",
          "chain": "polygon",
          "local": "120",
          "localDeficit": "0",
          "pending": "40",
          "confirmed": "300"
        }
      ]
    }
    ```
  </Tab>

  <Tab title="200: Pending">
    ```json theme={null}
    {
      "balances": [
        {
          "assetIdHex": "800101c011a7e12a19f7b1f670d46f03b03f3342e82dfb",
          "chain": "polygon",
          "local": "0",
          "localDeficit": "0",
          "pending": "40",
          "confirmed": "0"
        }
      ]
    }
    ```
  </Tab>

  <Tab title="200: Deficit">
    ```json theme={null}
    {
      "balances": [
        {
          "assetIdHex": "800101c011a7e12a19f7b1f670d46f03b03f3342e82dfb",
          "chain": "polygon",
          "local": "0",
          "localDeficit": "25",
          "pending": "0",
          "confirmed": "0"
        }
      ]
    }
    ```
  </Tab>
</Tabs>

## Balance States

| Field          | Spendable on Polymarket | Usable as margin collateral | Meaning                                        |
| -------------- | ----------------------- | --------------------------- | ---------------------------------------------- |
| `local`        | Yes                     | No                          | Spendable only on Polymarket, e.g., `"120"`    |
| `pending`      | No                      | No                          | Waiting for Polygon confirmation, e.g., `"40"` |
| `confirmed`    | Yes                     | Yes                         | Confirmed and available as collateral, `"300"` |
| `localDeficit` | No                      | No                          | Amount that must be repaid, e.g., `"0"`        |

`assetIdHex` is the unprefixed 23-byte Polygon ERC-20 AssetId. Amounts are decimal strings in pUSD
units.

## Using the Balance

* A buy reserves `local` pUSD first, then `confirmed` pUSD.
* `pending` pUSD cannot fund an order.
* A positive `localDeficit` must be repaid before placing another buy.
* A sell consumes held outcome shares rather than pUSD.