SubaccountViewService
List Subaccount Activity
List audit and activity events for a sub-account, newest first.
Request
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/auth/subaccounts/6789012345678/events?limit=100&pageToken=eyJvZmZzZXQiOjEwMH0' \ --header 'Accept: */*' \ --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \ --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \ --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE'
Responses
{
"events": [
{
"actorAccountId": "3CT33BAbxNG",
"createdAt": "2025-01-01T00:00:00Z",
"entityKind": "ACCOUNT",
"eventAction": "CREATED",
"ip": "203.0.113.42",
"payloadJson": "{\"action\":\"member_role_updated\",\"role\":\"TRADER\"}",
"source": "WEB",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 Chrome/126.0 Safari/537.36"
}
],
"nextPageToken": "eyJvZmZzZXQiOjIwMH0"
}Target sub-account (opaque ID).
Maximum number of events to return. Defaults to 50 when omitted; maximum is 200.
Opaque keyset cursor from a previous response. The cursor is exclusive and bound to the authenticated account and requested sub-account.
Time when the event occurred.
2025-01-01T00:00:00ZCategory of entity affected by the event.
ACCOUNTAction recorded for the entity.
CREATEDClient channel from which the event originated.
WEBOrigin IP address. Masked for non-owner and non-admin callers.
203.0.113.42User agent associated with the event, when available.
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 Chrome/126.0 Safari/537.36Account that performed the action (opaque ID).
3CT33BAbxNGStructured event details as a JSON string. Maximum 64 KiB.
{"action":"member_role_updated","role":"TRADER"}Opaque cursor for the next page. Empty when no more results exist.
eyJvZmZzZXQiOjIwMH0| Key | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |