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

# Get user fundings

> Funding payments.

```json 200 theme={null}
[
  {
    "time": 1701234567890,
    "hash": "0x1234abcd...",
    "delta": {
      "coin": "BTC",
      "type": "funding",
      "usdc": "-2.50",
      "szi": "0.1",
      "rate": "0.0001"
    },
    "id": "row-1"
  }
]
```

POST
`/read`

Also available through `POST /info`.

## Request Body

**type** `string` *required*

Must be `"userFundings"`.

**user** `string` *required*

User wallet address.

**startTime** `integer`

Inclusive lower bound in Unix milliseconds. Omit to select the latest page.

**endTime** `integer`

Inclusive upper bound in Unix milliseconds. Omit for no upper bound.

**afterId** `string`

Exclusive row `id` lower bound at `startTime`, in code-unit order. Requires `startTime`; later
timestamps are unaffected.

**limit** `integer`

Maximum entries: 1 to 100,000. Default: 2,000.

Rows are returned oldest first within the selected page. With `startTime`, the
page contains the earliest matching entries at or after that time.

To traverse retained history, set `startTime` to `0` (or your desired lower bound)
and keep one fixed `endTime` for every request. After a full page, set `startTime`
to the last row's timestamp and `afterId` to that same row's `id`. Keep `limit`
fixed and stop when a page contains fewer entries. Deduplicate any overlapping rows by `id`.

Pages are separate reads; `endTime` is a time filter, not a fixed snapshot. When overlapping
requests, fail if a previously returned row in the requested overlap disappears or changes timestamp.
Report failed or inconsistent reads as incomplete instead of returning a partial export.

## Response

```json 200 theme={null}
[
  {
    "time": 1701234567890,
    "hash": "0x1234abcd...",
    "delta": {
      "coin": "BTC",
      "type": "funding",
      "usdc": "-2.50",
      "szi": "0.1",
      "rate": "0.0001"
    },
    "id": "row-1"
  }
]
```

## Response Fields

**id** `string`

Stable row ID for deduplication.

**time** `number`

Funding settlement time in Unix milliseconds.

**hash** `string`

Committed funding event identifier; legacy funding can use a synthetic ID.

**delta** `object`

**child attributes**

**coin** `string`

Perpetual market symbol; assigned HIP-3 funding uses the isolated market name.

**type** `string`

Always `funding`.

**usdc** `string`

Signed funding payment in USDC. Positive is received; negative is paid.

**szi** `string`

Signed position size at settlement.

**rate** `string`

Hourly funding rate as a decimal ratio. Omitted for assigned HIP-3 funding; absence means
unavailable, not zero.


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