`userFundings`

Funding settlements. There is no side filter. fundingType is collected (amount > 0) or paid (amount < 0); the alias direction is accepted and is not a sort key. Zero amounts appear only when that filter is omitted. The live stream is userFundings.

POST/infotype userFundings

Render Funding History (collected and paid settlements).paged { data, hasMore, total? }

Request body

typestringrequired

Must be `userFundings`.

"userFundings"

userstring · addressrequired

Account to query. No auth — the body `user` is the subject.

accountTypestring[]optional

Instrument tab: `["perp"]`, `["outcome"]`, or both (`perps` is accepted as an alias).

coinstringoptional

Single instrument — a name (`BTC`, `BTC-USDC`) or the numeric id from `perpMeta`. Prefer this over `contract` for one market.

contractstringoptional

`active` = instruments where this user currently has an open perps position (`szi ≠ 0`). Empty list when there is no position. Do not combine with `coin`.

"all""active"

endTimeMsinteger · uint64optional

Inclusive window end, Unix milliseconds. Alias: `endTime`.

fundingTypestringoptional

`collected` = `amount > 0`, `paid` = `amount < 0`. Alias `direction` is accepted; it is not a sort key.

"collected""paid"

limitinteger · int64optional

Page size. Default `300`; max `2000` (export). Values above 2000 are clamped. `<= 0` is rejected.

offsetinteger · int64optional

Skip this many newest-first rows. Omit or `0` for the first page; page N is `(N - 1) * limit`. Max `200000`. Alias: `from` on some types.

startTimeMsinteger · uint64optional

Inclusive window start, Unix milliseconds. Alias: `startTime`.

Request example

curl -X POST https://rpc.txflow-testnet.xyz/info \
  -H "Content-Type: application/json" \
  -H "x-api-version: 2026-08-16" \
  -d '{
  "type": "userFundings",
  "user": "0x0000000000000000000000000000000000000001",
  "offset": 0,
  "limit": 20
}'

Try it

POST https://rpc.txflow-testnet.xyz/info

Response 200

codeinteger

`0` on success.

dataobject

dataFundingRow[]

Newest-first rows for this page.

hasMoreboolean

`true` when more rows exist after this page. Prefer this over guessing from a missing `total`.

totalinteger · uint64

Omitted when the count is unknown.

successboolean

Response example

{
  "success": true,
  "code": 0,
  "data": {
    "data": [
      {
        "time": 1720000000000,
        "coin": "BTC",
        "usdc": "0.12",
        "szi": "0.5",
        "fundingRate": "0.0001",
        "amount": "0.12"
      }
    ],
    "hasMore": true,
    "total": 1337
  }
}