Skip to main content
POST
/
v1
/
user-history-feed
/
initial
/
state
User history feed
curl --request POST \
  --url https://analytics.snek.fun/v1/user-history-feed/initial/state
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: 
["41fa17b2…", "e62df682…"]

​
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

​
asset
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

​
beacon
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. 
curl -sS "https://analytics.snek.fun/v1/user-history-feed/order/trades?beacon=…"

​
WebSocket

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