Skip to main content

User Behaviour Events (Client)

Record custom behaviour events for a wallet (e.g., user actions in your app). Send an event name, timestamp, and optional metadata; the API stores the event against the wallet for later analysis.

Record event for current user

POST /api/v1/wallets/{walletAddress}/events

cURL

curl -s -X POST "$FREEQ_API_URL/api/v1/wallets/me/events" \
-H "Authorization: Bearer $FREEQ_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"eventTypeId":1,"eventId":"025f26a5-d853-44d6-b40b-7d38072b4dbe","eventName":"POLL_EVENT","eventTime":"2025-07-01T09:59:00Z","metadata":[1,2,3]}'