Get user fundings

[
  {
    "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

string

required

Must be "userFundings".

string

required

User wallet address.

integer

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

integer

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

string

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

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

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

Response Fields

string

Stable row ID for deduplication.

number

Funding settlement time in Unix milliseconds.

string

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

object

Show child attributes

string

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

string

Always funding.

string

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

string

Signed position size at settlement.

string

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

Start Here

Info

Exchange

WebSocket

Request Body

Response

Response Fields

​Request Body

​Response

​Response Fields

Request Body

Response

Response Fields