Skip to content
Alchemy Logo

User role

This API is in private preview. Target October 2026; timing is subject to change.

Returns the account role and linked address where the role has one.

Available now. This read is served at the interim endpoint today.

POST /{apiKey}/info

ParameterTypeRequiredDescription
typestringYesSelects userRole.
userstringYesMaster or sub-account address.
{
  "type": "userRole",
  "user": "0x0000000000000000000000000000000000000000"
}

FieldTypeDescription
roleuser | agent | vault | subAccount | missingAccount classification: missing, user, agent, vault, or subAccount.
dataobjectRole-specific details; present for agent and sub-account roles.
data.userstringPrincipal user address represented by the agent.
data.masterstringMaster address that controls this sub-account.

{ "role": "user" }
Was this page helpful?