> ## 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.

# User Fundings

> Streams funding payments.

```json Message theme={null}
{
  "channel": "userFundings",
  "data": {
    "user": "0x1111111111111111111111111111111111111111",
    "isSnapshot": false,
    "blockNumber": 123,
    "fundings": [
      {
        "time": 1792108800000,
        "coin": "BTC",
        "usdc": "-0.01234567",
        "szi": "0.1",
        "fundingRate": "0.00001",
        "ledger": {
          "id": "opaque-projection-row-id",
          "time": 1792108800000,
          "hash": "0xabc",
          "delta": {
            "type": "funding",
            "coin": "BTC",
            "usdc": "-0.01234567",
            "szi": "0.1",
            "rate": "0.00001"
          }
        }
      }
    ]
  }
}
```

Hyperliquid

## Subscribe

```json theme={null}
{
  "method": "subscribe",
  "subscription": {
    "type": "userFundings",
    "user": "0x1111111111111111111111111111111111111111"
  }
}
```

## Response

```json Message theme={null}
{
  "channel": "userFundings",
  "data": {
    "user": "0x1111111111111111111111111111111111111111",
    "isSnapshot": false,
    "blockNumber": 123,
    "fundings": [
      {
        "time": 1792108800000,
        "coin": "BTC",
        "usdc": "-0.01234567",
        "szi": "0.1",
        "fundingRate": "0.00001",
        "ledger": {
          "id": "opaque-projection-row-id",
          "time": 1792108800000,
          "hash": "0xabc",
          "delta": {
            "type": "funding",
            "coin": "BTC",
            "usdc": "-0.01234567",
            "szi": "0.1",
            "rate": "0.00001"
          }
        }
      }
    ]
  }
}
```

## Response Fields

**channel** `string`

Always `userFundings`.

**data.user** `string`

Account owner's wallet address, normalized to lowercase.

**data.isSnapshot** `boolean`

`true` for the initial snapshot, including an empty one; `false` for live updates.

**data.blockNumber** `number`

Latest committed Notional block covered by this message.

**data.fundings\[]** `object`

Funding payments, including assigned-market funding. The initial snapshot contains the latest
100 matching rows, oldest first. Live batches contain at most 100 new or changed rows.

**child attributes**

**time** `number`

Funding time in Unix milliseconds.

**coin** `string`

Market label; assigned HIP-3 funding uses the isolated market name.

**usdc** `string`

Signed decimal amount in USDC: positive means received; negative means paid.

**szi** `string`

Signed position size.

**fundingRate** `string`

Optional hourly rate copied from `ledger.delta.rate`. Omitted when unavailable,
including assigned HIP-3 funding; absence does not mean zero.

**ledger** `object`

[Ledger row](/api-reference/info-endpoints/ledger#response-fields),
with `delta.type: "funding"`. Upsert by `ledger.id`; separate funding legs can share
a market and timestamp.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.