`userFills`

Sends a user's fill history once, as a snapshot, right after you subscribe. Nothing is pushed after that. Served by the API service at /api-ws.

ChanneluserFillsserver → client · type userFills

Load a user’s fill history over /api-ws — one snapshot, no updates.

{
  "method": "subscribe",
  "subscription": {
    "type": "userFills",
    "user": "0xabc123abc123abc123abc123abc123abc123abc1"
  }
}

Try it

WS wss://rpc.txflow-testnet.xyz/api-ws

Subscription parameters

typestringrequired

"userFills"

userstring · addressrequired

Account address (the owner, not an agent).

aggregateByTimebooleanoptional

Accepted but currently has no effect.

Server message

channelstring

"userFills"

dataobject

fillsobject[]

isSnapshotboolean

Always `true`: this is the only push.

userstring · address

The account, lower-cased.

Message example

{
  "channel": "userFills",
  "data": {
    "isSnapshot": true,
    "user": "0xabc123abc123abc123abc123abc123abc123abc1",
    "fills": [
      {
        "coin": "BTC",
        "symbol": "BTC-USDC",
        "px": "65010.5",
        "sz": "0.01",
        "side": "B",
        "time": 1720000000000,
        "startPosition": "0",
        "dir": "Open Long",
        "closedPnl": "0",
        "hash": "",
        "oid": 123456,
        "crossed": null,
        "fee": "0.02",
        "tid": 987654,
        "feeToken": "USDC",
        "twapId": 0,
        "entryPrice": "0",
        "roe": "",
        "tradeSide": "Taker",
        "marginMode": "cross",
        "leverage": 10,
        "instrumentId": 1,
        "instrumentType": "perps",
        "marketType": "perps"
      }
    ]
  }
}

Rows have the same shape as userFills. To refresh, subscribe again or query userFills, which also supports paging and filters.