Skip to main content
POST
User history feed
Endpoints under user-history-feed return orders across one or more wallets (PKH list), optionally filtered by asset or “open only”. Auth: Public

POST /v1/user-history-feed/initial/state

Initial ledger + mempool snapshot for the given PKHs.

Query parameters

Paging: offset, limit (default limit 100, max 100).

Body

JSON array of at least one PKH:

Response

Same OrderInitialStateResponse shape as Orders feed: { "ledger": { "count", "items" }, "mempool": [] }.

POST /v1/user-history-feed/initial/state/by/asset

Same as above but restricted to a single asset (adds query).

Query parameters

string
required
Asset id to filter.
Plus paging query params.

Body

Non-empty PKH array.

POST /v1/user-history-feed/initial/state/open

Only non-completed orders for the wallets. Same body and paging as initial/state.

GET /v1/user-history-feed/order/trades

Returns a single trade record by beacon (currency symbol).

Query parameters

string
required
Beacon / currency symbol identifier for the order.

Response

TradeOrder — discriminated union: CFMM or Spot with fields such as orderType, orderStatus, amounts, assets, prices, fill percent, etc.

WebSocket

Subscribe to UserHistoryByAddress or UserHistoryByAddressAndAsset with the appropriate data payload. See WebSocket.